zyfgood/dsh-a2a ↗★ 0

dsh-a2a

提供A2A协议双向支持以调用远端智能体 适合需要将本地Agent暴露为服务或与其他Agent协作的用户。

包名
dsh-a2a
兼容性
待验证
Harness 依赖范围
>=0.1.0-rc.5
Cordis 依赖范围
^4.0.1
版本
0.2.0
许可证
MIT
最近更新
2026年10月12日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zyfgood/dsh-a2a

三、配置项

profile 的 cordis.patch.yml(或本包 cordis.patch.yml 默认层):

- id: a2a
  name: dsh-a2a
  config:
    port: 7310
    mode: agent
配置默认说明
host127.0.0.1监听地址;公网暴露改 0.0.0.0 并配合鉴权
port7310监听端口(0 = 系统分配)
publicUrl按监听地址推导写入 Agent Card 的 url;反代/TLS 部署时必须配置为外部可达地址
bearerToken无Bearer 鉴权令牌,支持 env:VAR;配置后卡片宣告 bearerAuth
agentName / agentDescription / agentVersionDSH Agent / …Agent Card 元信息
skills内置一条 dsh-agent 技能Agent Card 技能清单
modeagent入站处理模式:agent / llm / echo(见下)
provider / model / systemPrompt / maxHistory—llm 模式参数(ctx.llm 直答)
agentId自动agent 模式:固定复用 ctx.agents 中某会话;不配置则按 contextId 自动创建
agentPresetGUI 默认预设自动创建会话的 preset(决定 agent 可用的工具集)
workspaceprocess.cwd()自动创建会话的工作目录
persistSessionstruecontextId → 会话映射落盘($DSH_HOME/a2a/),重启后自动恢复上下文
turnTimeoutMs600000单轮执行上限,超时任务置 failed
taskTtlMs3600000已完结任务内存保留时长(之后 TTL 回收)
toolstrue是否注册 a2a_* 出站工具
clientAllowPatterns['*']出站白名单:'*'、https://a2a.example.com/、https://*.example.com/、'*:7310'
clientTimeoutMs120000出站调用超时

三种入站模式

  • agent(默认):每个 A2A contextId 对应一个持久 DSH agent 会话(完整工具/技能/工作目录),跨任务续答;映射可落盘跨重启恢复。会话忙时新消息走 steer(下一 step 边界消费)。
  • llm:ctx.llm 直答(自包含轻量模式,不建 agent 会话,短期记忆按 maxHistory)。
  • echo:回显原文,验证链路。