“A2A基础配置”是云A2A模式的必填项,它用来配置云侧Agent的API URL和鉴权方式,完成小艺Agent与云侧Agent的A2A对接。如下图所示。

API URL:云侧Agent与小艺Client Agent对话的接口,根据云侧Agent的信息配置,通信协议参考协议规范。
API URL必须是https协议,不支持http协议
客户端与服务器间会话维持方式:分为“由服务器侧分配Session”和“服务器间采用无状态通信,每次携带认证凭据”两种方式,按云侧Agent需求选择。
认证信息:根据云侧Agent API的鉴权方式选择,支持API Key、AK/SK认证、OAuth认证三种方式。以APIKey,Header为例,Key:默认填写Authorization即可,Value:填写云侧Agent的API Key的值。
认证方式 | 说明 |
|---|---|
API Key | Header:使用HTTP请求Header域传递参数方式认证; Query:使用Query传递参数方式认证。该认证方式可能存在安全风险,建议使用其他认证方式。 认证方式可参考创建云插件认证方式部分。 |
AK/SK | 使用预共享密钥认证方式。 |
OAuth认证 | 使用OAuth2.0流程认证,当前仅支持Client模式,OAuth2.0协议规范,可访问OAuth2.0官方网站。 |
在完成上面的配置后,点击“测试连接”进行连通性测试,确保出现“API URL连通性测试成功”的提示后,再进行接下来的配置。
“测试连接”发送的数据报文示例如下(Host和Authorization的值非真实值):
GET /a2a HTTP/1.1 Host: [REDACTED] X-Forwarded-Proto: https Authorization: [REDACTED] Accept: text/plain, text/html, application/json, application/octet-stream, text/event-stream, application/yaml, application/*+json, */* Content-Type: application/json Accept-Encoding: gzip, x-gzip, deflate User-Agent: Apache-HttpClient/5.4.4 (Java/21.0.10)