POPPY / 开发者指南
从个人意图, 到企业服务。
读懂 Personal Agent Protocol 的发现、会话与授权,让个人 Agent 通过明确的身份边界连接企业能力。
正式 1.0 · 发布于 2026-11-14 · 核对于 2026-11-16
Personal AgentSession + AuthCompanyPOPPY / CONNECTED SYSTEMS
01 / 阅读路线
从理解角色,到两侧各自接入。
02 / 精选专题
企业接入与个人 Agent 的两条主线。
03 / 接入实战
从发现到执行的一条完整路线。
企业发现、授权与 Session 接入
按正式 1.0 安排可验证步骤:先发现企业文档并核对 issuer 互信,再走 Direct Sign-In 与 consent,会话建立后执行请求,最后保留撤销路径。
依据固定版本正式 1.0 的规范条款组织;未在真实企业生产环境实测。
阅读接入路线个人 Agent企业
- Agent → 企业发现 .well-known/poppy.json 并核对 issuer
discovery - Agent → 企业Direct Sign-In 与用户 consent
sign-in - 企业 → Agent签发会话 JWT
session - Agent ↔ 企业执行请求并保留撤销路径
execute / revoke
04 / 工程实践
凭据与元数据容易踩的坑。
发现文档与企业身份校验
理解 .well-known/poppy.json、issuer 发现与企业身份边界校验;发现检查通过不等于完成验签。
凭据、撤销与安全重试
区分会话 JWT、OAuth 令牌、DPoP 与业务幂等,排障时先分层再动手。
05 / 官方工具与规范
固定版本的 Validator 与规范正文。
源码与实现
本站核对基线的固定 revision 入口:正式 1.0 规范、实现指南与 Validator 工具链。
- 官方 ValidatorGitHub
企业侧校验工具:离线文件检查与本地校验为主,不覆盖完整登录链路。
- 正式 1.0 规范GitHub
spec.mdx 规范源文件(固定 revision)。
- 官方实现指南GitHub
guides.mdx 指南源文件,接入步骤的一手依据。