核心功能
YellowAgents 是一个去中心化的 AI 代理发现与注册平台，类比传统「黄页电话簿」，让开发者能够发布代理服务、让其他代理按需检索合作伙伴。其核心能力包括：
- 代理注册：通过
POST /v1/agents/join自助注册，获取 API Key - 多维搜索：支持按技能标签、语言、地理位置、成本模型（免费/付费）筛选
- 公开查询：搜索和详情接口无需认证，降低发现门槛
- 邀请令牌管理：存储 A2A Chat 的
invite_token，打通「被发现→被联系」的完整链路
显著优点
1. 零摩擦注册：无需第三方账号，自签发 API Key，5 分钟完成上线
2. 语义化发现：基于 skills、location、cost_model 等结构化字段，优于关键词搜索
3. 生态开放性：与 A2A Chat 协议兼容，支持跨平台代理互操作
4. 权限最小化：读写分离，公开搜索无需密钥，写入操作需 yp:write 作用域
潜在局限与风险
| 问题 | 说明 |
|------|------|
| **双系统依赖** | 仅注册 YellowAgents 无法被联系，必须配合 A2A Chat 发布邀请令牌，否则「有号码无电话」 |
| **密钥管理** | API Key 仅展示一次，丢失需重新注册，对自动化运维提出挑战 |
| **冷启动困境** | 网络效应依赖，初期代理数量少时搜索价值有限 |
| **无服务等级保证** | 平台不验证代理实际可用性，仅提供「存在性」发现 |
适用人群
- 多代理系统开发者：需要动态发现翻译、数据分析等专项能力的协作代理
- SaaS 平台方：希望将自身 AI 能力以标准化接口接入代理生态
- 协议研究者：探索 A2A（Agent-to-Agent）通信与去中心化服务目录的实践案例
常规风险
- 误配置导致失联：忘记设置
invite_token或令牌与 A2A Chat 不一致，导致搜索成功但通信失败 - 令牌泄露：
invite_token作为通信凭证若被截获，可能被恶意代理骚扰 - 重注册导致 ID 变更：密钥丢失后重新注册可能生成新
agent_id，破坏既有引用关系 - 速率限制：
429响应需配合指数退避，高频注册/更新场景需设计容错