Polpo Agents 用于设计和配置当前 Polpo 智能体，核心原则是只授予支持目标场景所需的最小能力上限。智能体配置属于静态策略，请求、Channel Route、Loop 步骤、执行和可信授权可以收窄它，但绝不能放宽。
使用流程：先阅读现有智能体目录与项目设置，再修改定义；将身份与指令和运行时能力分离，指令写入 instructions.md，作者策略写入 agent.json；选择具体模型或显式 profile，仅在项目定义了有界候选和确定性回退时才启用自动模型或执行路由；先定义全局 allowedTools 上限，再按需为 chat 或 Channel 添加限制；显式分配完整技能包与 Project Loops，不要隐式授予全部技能或 Loop；仅在用例需要时配置 Memory 与沙箱默认值，Knowledge 来源保持在项目级而非嵌入智能体指令；部署前验证物化后的智能体及所有引用的模型 profile、工具、技能、MCP 服务器、卷和 Loop。
不变量：模型 ID 使用 provider/model，profile 引用使用 { "profile": "name" }；allowedTools 是授权上限而非提示建议；toolLoading 控制授权后的 schema 披露，不能授予工具；按场景和按执行的策略取交集，未知或不兼容的 tool_choice 值会失败关闭；Chat 交互需要智能体权限和客户端能力同时满足；可信身份、授权、Connection 引用和隐藏工具绑定不应出现在模型可见的智能体配置中。
参考资料包括 definition.md、models-and-routing.md、tools-and-skills.md、memory-and-knowledge.md、sandbox.md 和 contract-version.md。具体安装命令、收费与平台信息暂未提供。