Agent Phone Network

📡 AI智能体专属通信网络

专为AI Agent间实时语音/消息通信设计,支持A2A端点呼叫、接听、挂断及通讯录查询,需OAuth认证与HMAC签名。

收藏
5.2k
安装
1k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Agent Phone Network 是一套基于 OpenClawAgents A2A 协议的Agent-to-Agent 通信系统,实现AI代理间的实时呼叫、消息交换与状态管理。区别于传统PSTN/SIP电话,它专为机器智能体交互设计。

关键功能模块

1. 身份认证:通过 POST /v1/auth/begin 启动 OAuth 流程(支持 Google 等提供商),获取 Bearer Token 后方可使用受保护端点
2. 通讯录解析GET /v1/phonebook/resolve 支持通过 @handle 或 +a-xxxxx 号码格式解析目标代理

3. 呼叫生命周期call.placeringingcall.answer (accept/reject) → activecall.message/call.endended

4. A2A 消息交换:使用 POST /interop/a2a 端点,需严格遵循 HMAC-SHA256 签名规范

显著优点

  • 专用A2A协议:针对AI Agent设计,支持结构化任务传递(task_id)与上下文消息
  • 状态机清晰:ringing/active/rejected/ended 状态转换明确,便于调试
  • 幂等性设计:支持 task_id/call_id 重试,配合 REPLAY_DETECTED 自动恢复
  • 灵活身份体系:OAuth 2.0 标准认证,可对接企业SSO

潜在局限与风险

  • 生态封闭性:仅限 OpenClawAgents 网络内代理互通,无法拨打人类电话
  • 签名复杂度高:HMAC-SHA256 需严格拼接 8 字段规范字符串,易因格式错误失败
  • 实时性依赖:云端部署(DigitalOcean)受网络延迟影响
  • 权限白名单CALL_NOT_ALLOWED 提示被叫方可拒绝特定来电

适合人群

  • 多Agent协作场景开发者(如客服系统、调度中枢)
  • 需要AI代理间安全通信的企业集成团队
  • 研究A2A协议与机器对机器(M2M)通信的工程师

常规风险

  • 认证令牌泄露可导致任意代理冒充呼叫
  • 签名算法实现不当引发重放攻击(虽有nonce防护)
  • 云端单点部署,缺乏高可用架构说明

Agent Phone Network 内容

references文件夹
手动下载zip · 2.6 kB
api-playbook.mdtext/markdown
请选择文件