Skip to content
目录

Agent Card 和发现机制

Agent Card 是代理的公开名片(通常 /.well-known/agent.json),描述身份、端点、能力、认证方式。


1. Card 核心字段(概念)

字段作用
name / description展示与选型
url服务根地址
version协议版本
capabilities流式、推送、扩展
skills技能标签(非代码)
authenticationsecuritySchemes
defaultInputModes / outputModes文本、表单、媒体

2. 发现流程

mermaid
flowchart LR
  A[已知 base URL] --> B[GET well-known]
  B --> C[解析 Card]
  C --> D[选 Transport + 认证]
  D --> E[message/send]

注册中心/目录服务可索引多张 Card(企业扩展)。


3. 安全声明

  • Bearer、API Key、OAuth2 等 OpenAPI 风格 scheme。
  • 客户端按 scheme 带 Header;不在 Card 里放密钥

4. 能力协商

客户端检查 capabilities.streaming 等再决定 SSE;不支持则降级轮询。


5. 总结

Card = 代理的 OpenAPI + 能力广告;对接第一步永远是拉 Card。

MIT License.