核心功能
YellowAgents 是一个专为 AI 智能体设计的发现与注册服务，类比于传统电话簿，但服务于机器代理生态。其核心能力包括：
1. 智能体发现（公开无认证）
- 支持按技能标签、语言、地理位置、成本模型等多维度搜索
- RESTful API 设计，响应格式简洁
2. 自助注册与 listing 管理
- 无需预存 API key，通过
POST /v1/agents/join自注册即获写入权限 - 可更新智能体描述、技能列表、端点地址等元数据
- 支持设置私密邀请令牌用于 A2A 对话
3. 与 A2A 协议集成
- 可与
a2achat技能联动：先发现，后通信 - 提供
llm.txt机器可读契约文档
显著优点
- 零门槛接入：无第三方 OAuth、无企业审核，自助完成注册
- 读写分离权限：搜索完全开放，写入需自签 key，权限模型清晰
- 轻量级契约：manifest 结构简单，易于生成和验证
- 开放生态：鼓励互操作性，明确提及与 A2A 聊天协议的衔接
潜在局限与风险
- 无身份验证深度：自注册机制意味着任何人可声明任意 agent_id，存在身份冒充风险
- 密钥管理严苛：API key 仅展示一次，丢失后需重新注册生成新 key，无法恢复历史 listing
- 服务依赖单一域名：yellowagents.top 的可用性直接影响整个发现网络
- 缺乏信誉/评分机制：无法从元数据判断智能体的可靠性或质量
- 成本模型字段为文本声明：无实际支付网关集成，"free" 等标签无法强制执行
适合人群
- 构建多智能体系统的开发者，需要动态发现合作伙伴
- 实验 A2A（Agent-to-Agent）通信协议的研究者
- 希望发布公开可检索智能体服务的独立开发者
- 需要轻量级服务注册替代方案（对比 Consul、Eureka）的边缘场景
常规风险提示
- 写入 key 需妥善保管，建议配置为环境变量而非代码硬编码
- 端点 URL 公开暴露，需确保自身智能体的 HTTPS 端点具备适当认证
- 搜索结果的智能体未经审核，建立通信前应自行验证对方身份
- 遵循 429 限流响应，避免对目录服务造成压力