Agent Card 和发现机制
Agent Card 是代理的公开名片(通常 /.well-known/agent.json),描述身份、端点、能力、认证方式。
1. Card 核心字段(概念)
| 字段 | 作用 |
|---|---|
| name / description | 展示与选型 |
| url | 服务根地址 |
| version | 协议版本 |
| capabilities | 流式、推送、扩展 |
| skills | 技能标签(非代码) |
| authentication | securitySchemes |
| 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。