SuperAPI AI 工具集

agently-runtime

智能体与模型

查看项目

更新于 10-15 19:51

技能介绍

Agently Runtime 是 Agently 技能体系中的运行时扩展技能,应在请求或工作流负责人已确定后使用。若分支、并发、暂停/恢复、重试或多阶段推进需要保留在执行图中,应改用 agently-triggerflow;agently-stage 仅用于进程内生命周期与同步/异步桥接。

主要能力按需查阅:agent-execution.md 涉及执行选择、嵌套生产者、run/rework/control、最终校验、产物/审查及声明的 Agent 能力;actions-runtime.md 涉及可调用 Actions、搜索/浏览、MCP/ACP、策略、产物与 AgentTask 证据;actions-execution-resource.md 涉及 Action 与 ExecutionResource、受管客户端/沙箱/进程/浏览器/数据库、Shell/BashExecutor、PowerShell、离线/在线/主机配置、审批与流式进程 I/O;helpers-and-services.md 涉及 auto_func、KeyWaiter、FastAPIHelper、SSE 或 WebSocket 暴露;devtools.md 涉及 RuntimeEvent、日志、追踪、评估、playground 或 DevTools;devtools-review.md 涉及有证据支撑的审查意见、编码 Agent 响应与重跑对比,需 DevTools 0.2 并先检查 API 能力;context-and-skills.md 涉及 TaskContext、ContextReader、SkillLibrary 与真实 Skill 包。

职责边界:ActionRuntime 负责模型可调用操作的模式、规划/分发、策略与 Action 结果;ExecutionResource 负责活动客户端、沙箱、进程、浏览器、数据库与 MCP 会话的生命周期;TaskWorkspace 负责任务内文件、生成产物、回读、身份与提升;RecordStore 负责持久记录、链接、检索、RuntimeEvent、检查点、快照、租约与持久引用;TaskContext/ContextReader 负责任务信息绑定与消费者绑定的渐进披露;SkillLibrary 负责已安装不可变 Skill 修订与资源读取,绝不授予执行权限;AgentExecution 负责单次运行的可替换生产者、任务级绑定、上下文、控制、终止策略、结果与流。不要把这些合并为通用 Workspace 或运行时管理器。

运行时规则:优先使用 @agent.action_func 与 agent.use_actions(...),tool_* 与 use_tool(s) 为兼容接口;Action id 与模型规划参数视为不可信,分发前校验模式、授权与策略,声称的副作用需有记录的 Action 证据;权限配置保持显式且最小化;文件工作用 TaskWorkspace 并验证产物回读,持久记录与恢复用 RecordStore;真实 Skill 仅提供指导与可寻址资源,Actions、MCP、ExecutionResources、脚本授权与副作用证明仍由宿主显式绑定;多语句设置或无关新请求使用新的 agent.create_execution();4.1.4.8 中通过 create_execution(...) 选择 request、plan、long_content 或 long_task,.validate(handler) 为硬输出门,.review(..., on_fail="warn" | "block") 为带显式终止策略的软评估,.artifact(...) 需已验证的 TaskWorkspace 回读;仅当模型应负责有界规划、执行证据、验证与重规划时使用 agent.create_task(...);持久化资源描述符而非活动客户端或密钥;显式绑定 RuntimeEvent 持久化;观察与传输为适配器,不得成为路由、授权、工作流生命周期、语义接受或重试的拥有者。失败关闭:拒绝未知 Skill 修订、资源引用、Action id、选择键、上下文块键、恢复提供者与外部恢复身份;不要用关键词或正则匹配作为意图、Skill 相关性、路由选择、证据有用性或输出质量的语义拥有者,也不要用固定输出或确定性业务映射伪造模型拥有的成功。