opencode-skills/uni-agent

UniAgent - 统一智能体协议适配层

"Connect Any Agent, Any Protocol"

一套 API 调用所有 Agent 协议（ANP/MCP/A2A/AITP/LMOS/Agent Protocol）。

一键部署

# 1. 运行安装脚本
./setup.sh

# 2. 开始使用
python scripts/uni_cli.py list

使用方式

调用 Agent

# Agent ID 格式: <name>@<protocol>

# ANP - 去中心化 Agent 网络
python scripts/uni_cli.py call amap@anp maps_weather '{"city":"北京"}'
python scripts/uni_cli.py call amap@anp maps_text_search '{"keywords":"咖啡厅","city":"上海"}'

# MCP - LLM 工具调用 (需配置)
python scripts/uni_cli.py call filesystem@mcp read_file '{"path":"/tmp/a.txt"}'

# A2A - Google Agent 协作 (需配置)
python scripts/uni_cli.py call assistant@a2a tasks/send '{"message":{"role":"user","content":"hello"}}'

# AITP - NEAR 交互交易 (需配置)
python scripts/uni_cli.py call shop@aitp message '{"content":"我要买咖啡"}'

# Agent Protocol - REST API (需配置)
python scripts/uni_cli.py call autogpt@ap create_task '{"input":"写一个hello world"}'

# LMOS - 企业级 Agent (需配置)
python scripts/uni_cli.py call sales@lmos invoke '{"capability":"sales","input":{}}'

查看 Agent 方法

python scripts/uni_cli.py methods amap@anp

发现 Agent

python scripts/uni_cli.py discover weather

列出已注册 Agent

python scripts/uni_cli.py list

支持的协议

协议	状态	说明
ANP	✅ 已实现	Agent Network Protocol - 去中心化身份 + Agent 网络
MCP	✅ 已实现	Model Context Protocol - LLM 工具调用
A2A	✅ 已实现	Agent-to-Agent - Google 的 Agent 间协作协议
AITP	✅ 已实现	Agent Interaction & Transaction - 交互 + 交易
Agent Protocol	✅ 已实现	AI Engineer Foundation REST API 标准
LMOS	✅ 已实现	Language Model OS - Eclipse 企业级 Agent 平台

内置 ANP Agent

ID	名称	功能
amap@anp	高德地图	地点搜索、路线规划、天气查询
kuaidi@anp	快递查询	快递单号追踪
hotel@anp	酒店预订	搜索酒店、查询房价
juhe@anp	聚合查询	多种生活服务
navigation@anp	Agent导航	发现更多 Agent

添加自定义 Agent

编辑 config/agents.yaml:

agents:
  # ANP Agent
  - id: my_agent
    protocol: anp
    name: 我的 Agent
    ad_url: https://example.com/ad.json

  # MCP Server
  - id: filesystem
    protocol: mcp
    name: 文件系统
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]

  # A2A Agent
  - id: assistant
    protocol: a2a
    name: AI Assistant
    endpoint: https://example.com/.well-known/agent.json
    auth:
      type: api_key
      api_key: "${A2A_API_KEY}"

  # AITP Agent
  - id: shop
    protocol: aitp
    name: NEAR Shop
    endpoint: https://shop.near.ai/api
    wallet:
      type: near
      account_id: "${NEAR_ACCOUNT_ID}"

  # Agent Protocol
  - id: autogpt
    protocol: agent_protocol  # 或 ap
    name: AutoGPT
    endpoint: http://localhost:8000

  # LMOS Agent
  - id: sales
    protocol: lmos
    name: 销售 Agent
    endpoint: http://sales.internal:8080

架构设计

┌─────────────────────────────────────────────────────────┐
│                      UniAgent                           │
│                   统一调用接口                            │
├─────────────────────────────────────────────────────────┤
│  call(agent_id, method, params) -> result               │
└────────────────────────┬────────────────────────────────┘
                         │
              ┌──────────┴──────────┐
              │   Protocol Router   │
              └──────────┬──────────┘
                         │
   ┌─────────┬───────────┼───────────┬─────────┬─────────┐
   ▼         ▼           ▼           ▼         ▼         ▼
┌──────┐ ┌──────┐   ┌──────┐   ┌──────┐  ┌──────┐  ┌──────┐
│ ANP  │ │ MCP  │   │ A2A  │   │ AITP │  │  AP  │  │ LMOS │
└──────┘ └──────┘   └──────┘   └──────┘  └──────┘  └──────┘

目录结构

uni-agent/
├── README.md
├── SKILL.md             # AI 助手技能描述
├── setup.sh             # 一键安装
├── requirements.txt
├── config/
│   ├── agents.yaml      # Agent 注册表
│   └── .gitignore
├── adapters/
│   ├── __init__.py      # 适配器注册
│   ├── base.py          # 适配器基类
│   ├── anp.py           # ANP 适配器
│   ├── mcp.py           # MCP 适配器
│   ├── a2a.py           # A2A 适配器
│   ├── aitp.py          # AITP 适配器
│   ├── agent_protocol.py # Agent Protocol 适配器
│   └── lmos.py          # LMOS 适配器
└── scripts/
    └── uni_cli.py       # CLI 工具

扩展新协议

1. 创建 adapters/new_protocol.py
2. 继承 ProtocolAdapter 基类
3. 实现 connect、call、discover、close 方法
4. 在 adapters/__init__.py 注册

详见 SKILL.md

License

MIT