Poppy:个人 Agent 如何连接企业

Poppy:个人 Agent 如何连接企业

Personal Agent Protocol(也称 Poppy)让个人 Agent 发现参与协议的企业,在用户需要时完成登录,并通过 API、网页或企业 Agent 办事。本站依据正式 1.0(2026-11-14 发布)编写;0.1–0.4 是历史草案,从 0.3 起会话与授权机制有破坏性变化,字段不能跨版本混用。

先把参与者分清

用户把任务交给自己的个人 Agent;企业公布可发现的元数据和能力;双方在企业承认的 Session 中处理任务。企业可以同时提供多种执行入口,个人 Agent 根据元数据与实际能力选择。

User → Personal Agent → Company discovery
                         ↓
              Session header + OAuth tokens
                         ↓
                APIs / Web / Company Agent

这是一张概念图,不表示所有入口都必须实现。可选能力要以企业实际公布的文档为准。

会话与账号是两条独立的线

正式 1.0 把会话和账号访问分开。Session 由个人 Agent 自己标识:发往企业 API、对话与协议端点的每个请求都带 Poppy-Session 头,内容是个人 Agent 用委托密钥为这一次请求新签的 JWT,声明会话 ID、用户 ID、请求方法与地址。账号访问是标准 OAuth:登录得到 refresh token,按需换取 access token;请求带 access token 就是已登录会话,不带就是未登录会话,两种请求都带同一个会话头。

一次登录可以服务多个会话。停用一个会话 ID 不影响账号授权;账号登出要撤销全部 refresh token,之后的会话请求继续以未登录方式工作。实现时把会话状态、登录状态和授权撤销分开处理。

从哪里开始

企业开发者先读发现与身份,再按接入路线组织系统。个人 Agent 开发者还需要检查凭据与重试。规范和字段定义以1.0 规范源文件为准,本站提供中文原创导读。

最后更新于