配置访问端点

本文介绍智能体访问端点(endpoint)配置。

访问端点是外部访问您的智能体的接口。访问端点本质上是将外部请求打到一个特定的智能体版本上，主要用于智能体调试或完成版本发布后的对外访问。您可以通过创建访问端点来调整外部请求指向的版本，来动态调整准许访问的内容，有利于管理更新发布和回滚代码。

创建智能体访问端点

智能体的访问端点可以通过以下入口创建：

• 版本与灰度 - 访问管理- +创建Endpoint

  

  字段	功能含义	规则限制
  Endpoint名称	-	以字母开头，以字母或数字结尾，只能包含字母、数字和短横线，长度3-7个字符
  描述	-	256个字符以内
  主要版本	访问端点指向的版本	至少需要指向一个版本 Default端点只能指向LATEST版本
  启用灰度版本	启用流量分割，可以配置灰度版本权重，实现一个访问端点指向两个版本	可选
  灰度版本	访问端点指向的灰度版本	-
  流量分配	分配流向两个版本的的流量百分比	-
  域名	配置该访问端点的域名
  访问路径	配置该访问端点的域名具体路由	支持精准匹配路由或前缀匹配路由（/test/*格式）
  移除basePath	在前缀匹配路由配置下，准许请求转发到后端服务时，自动移除请求路径中的BasePath部分	在开启前缀匹配路由时才允许配置
  调试路径	提供给调试页面使用的精确路径	若访问路径配置精准匹配，则调试路径与访问路径相同；否则，需要手动输入精准的调试路径

智能体访问端点有以下几个需要注意的特性：

• 若没有创建过访问端点，准许创建的第一个访问端点只能为Default，它仅会指向LATEST版本，且不允许删除。

• 您需要先创建自定义域名，才能够在创建访问端点时绑定域名。一个访问端点一次只能绑定一个域名。

• 对于特定的域名，访问端点不允许配置多个重名的访问路径。

访问路径移除basePath的详细说明如下：

移除basePath开启后，当请求转发到后端服务时，请求路径中的BasePath部分(即通配符*之前的部分)将被移除。例如：

访问路径配置为前缀匹配路由：/api/v1/*。若发送的原始请求路径为：/api/v1/test，转发到后端的路径的basePath部分将移除而变为：/test。