更新时间:2024-07-04 GMT+08:00
分享

Agents注册说明

前提条件

  • 该类商品上架后,由华为云的Agents网关进行鉴权、商家进行计费,计费依赖商家响应的token数,请确认商品是否满足对接要求。
  • 发布API类商品前,商家需要先进行Agents注册,目前华为云云商店的Agents网关默认在华北-北京四,其他区域暂不支持。
  • Agents对接规范、调用逻辑、签名、响应和计费请参考《Agents后端应用接口规则和计费说明》

操作步骤

  1. 在“资产中心>Agents注册”中,点击Agents注册。

  2. 定义Agent后端信息,设置接口请求类型、Agents访问前缀、Agents访问路径、调用方式、后端超时时间、APP Key和APP Secret等信息,确认信息无误后,单击“下一步”。

    • 协议类型:HTTPS、HTTP
    • 接口请求类型:GET、POST
    • Agent访问前缀:为域名格式,端口未指定则使用默认端口,协议为HTTP,端口使用80;协议为HTTPS,端口使用443。
    1. 获取Agent对外公开的访问地址后,则需先通过应用工具->生产地址管理菜单界面,添加生产地址,如:https://xx.yy.com
    2. 将认证通过的地址去除协议类型内容,填写到此输入框内,如:xx.yy.com。

    1. 填写完成后,点击“校验后端服务”。

    2. 提示“校验成功”,即可说明该服务具备连通性。

      • Agents访问路径:以/开头,不支持动态参数路径。
      • 调用方式:流式、同步。
        1. 流式:是一种在数据处理、网络通信等场景中常用的技术,它允许数据以流的形式进行传输和处理。
        2. 同步:是一种程序执行的策略,其中调用函数或方法时会按照其编写的顺序,等待当前函数或方法执行完成后才继续执行后续的代码。
      • 后端超时时间:支持最大300000ms
      • 认证方式:APP KeyAPP Secret自行定义,AK/SK认证请参考《Agents后端应用接口规则和计费说明》

  3. 设置“接口入参”等信息,单击“下一步”。

  4. 定义Agent基本信息:Agent名称、描述。

  5. 定义Agent请求信息:请求协议、请求路径。

    该请求路径为客户购买后提供调用的接口URL,格式为:请求访问前缀/请求路径。

    例如:https://agentstore-mkt.myhuaweicloud.com/v1/aiagentservice/xxx/xxxxx

  6. 定义返回结果:成功响应示例、失败响应示例。

  7. 点击右下方“完成”,即完成Agtens创建。
  8. 创建Agents后,需要进行“调测”。

  9. 调测成功后,并且业务处理与预期一致,才能进行发布商品上架,避免用户购买后无法使用。

相关文档