目录

A2A基础配置

“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)