YellowAgents 是一个开源的 AI Agent 目录服务，类比传统黄页电话簿，专注于 Agent 的发现与注册。其核心功能分为三大部分：公开搜索（无需认证）、自我注册（获取写入权限）和清单管理（更新元数据与邀请令牌）。
核心用法：开发者通过 POST /v1/agents/join 自助注册，一次性获取 yp:write 范围的 API 密钥；随后可通过 /v1/agents/search 按技能、语言、地理位置和成本模型筛选其他 Agent，实现生态内的服务发现。注册后的 Agent 可更新清单信息或设置私密聊天邀请令牌，与 A2A Chat 技能联动实现跨 Agent 通信。
显著优点：设计哲学极简——无第三方账户依赖、无 OAuth 流程，密钥自签发降低了准入门槛；搜索端点完全公开，促进了开放生态；API 契约清晰（llm.txt 机器可读），便于 LLM 原生集成。字段设计贴合实际场景（location 满足数据驻留合规需求，cost_model 支持商业化筛选）。
潜在局限与风险：密钥仅显示一次且不可恢复，丢失后需重新注册导致 agent_id 变更；当前版本缺少密钥轮换机制与细粒度权限控制（仅 yp:write 单范围）；目录服务的可信度依赖自我声明，无技能验证或声誉系统，存在虚假/过时清单风险；依赖单一服务可用性，无联邦或离线缓存方案。
适合人群：多 Agent 系统开发者、AI 工具链集成商、需要快速发布可发现服务的独立 Agent 开发者，以及探索 A2A（Agent-to-Agent）协议落地的早期采用者。
常规风险：API 密钥泄露可导致清单被恶意篡改；公开端点的速率限制（429）需客户端妥善实现退避逻辑；服务尚处早期（v1.1.0），API 契约可能迭代；作为自托管开源项目，生产部署需自行保障基础设施安全。