企业与个人 Agent 的接入路线
企业与个人 Agent 的接入路线
Poppy 官网本身是文档站,不是可以直接调用的协议服务。实现应由企业与个人 Agent 各自提供,示例域名也不能当作真实生产端点。
企业侧
先确定支持的执行入口:API、网页或企业 Agent。整理现有账号与权限系统,选择独立的 OAuth issuer,并让发现文档和 issuer 元数据能相互校验。
随后实现 Session 的创建、更新和令牌校验;按需要提供登录方式与对应 scope。把业务接口接回现有授权逻辑,确保“认识这个 Agent”与“允许它代表当前用户执行这项操作”是两个判断。
个人 Agent 侧
发布自己的 HTTPS 客户端元数据与公开密钥;安全获取企业发现文档并验证身份。每个用户在每家企业使用独立、稳定、不含个人信息的标识,不能直接使用邮箱或邮箱散列。
从企业元数据选择支持的路径,开始 signed-out Session。确实需要账号能力时再让用户登录,安全保存 Account Token,再为后续操作取得适用的 Session Token。
一个可验收闭环
| 阶段 | 成功依据 |
|---|---|
| 发现 | 域名与 issuer 双向校验通过 |
| 开始会话 | 企业确认 Agent 身份并返回适用会话凭据 |
| 登录 | 用户授权与允许 scope 对应 |
| 执行 | 一个只读操作返回预期结果 |
| 撤销 | 账号授权失效,后续不能继续获取账号能力 |
先选择只读任务验证整条链,再扩展写操作、浏览器 Session 和对话。具体请求字段、算法与错误码请使用官方 0.2 规范,不要从概念流程推导消息格式。
最后更新于