Polpo Runtime 用于集成和操作 Polpo 运行时,可通过 OpenAI 兼容的 completions 接口与 Polpo SDK 调用。其核心是区分执行生命周期、规范会话状态与客户端传输:Session 保存对话历史,Run 记录一次执行,Project Loop 是一种执行模式,SSE 仅作为投递传输。
主要能力与用法:先识别调用面与来源(直接聊天、Channel、任务、调度或 Loop)。需要连续性时保留 x-session-id,有续接 API 时不要用客户端猜测重建规范历史。必须跨断线存活的工作使用持久化投递,重连到 Run 事件日志,不要重复创建请求。对话轮次用直接聊天,确定性多步工作用 Project Loop。在到达提供方或持久化历史前,校验响应 schema、工具调用、工具结果与 Loop 绑定。续接、调度触发和外部可见操作使用幂等键。声明运行成功前,检查终止事件与持久化状态,而非仅看最后一个 SSE 分块。
不变量:持久化进模型历史的每个助手工具调用,在后续模型轮次前必须恰好有一个有效结果,畸形调用在运行时边界被拒绝或修复;请求作用域的客户端工具返回给客户端,绝不由 Polpo 执行;显式 Project Loop 续接在保留 Session、可信调用上下文与幂等性的同时重新计算 Loop 工具策略;fresh sandbox 隔离意味着外层运行使用一个全新租约,由根工具与嵌套 Loop 智能体步骤共享;Steering 仅在安全边界接受,绝不中途打断工具;提供方错误必须转为稳定的 Polpo 错误并保留有用诊断。
限制与更多细节:资料未提供具体安装命令、价格、平台支持范围或完整代码示例,相关参考文档包括 completions-and-sessions、durable-runs、project-loops、client-tools-and-interactions、structured-and-parallel、steering-and-runtime-plans、context-trust-and-guardrails、tasks-and-missions、schedules、contract-version。