SuperAPI AI 工具集

dcode-runner

智能体与模型

查看项目

更新于 10-16 03:25

技能介绍

用途

dcode-runner 用于执行外部 DeepAgents CLI(dcode)提示,使用用户已在 dcode 中配置好的模型和凭据。它只应在明确请求 dcode 或 DeepAgents CLI 时使用。该技能通过本地 CLI 执行调用方给定的限定提示(scoped prompt)。

主要能力

  • 通过本地 CLI 执行限定提示,并返回包装信封(wrapper envelope)与 agent_message。
  • 原生路由判断:在决定外部路由前,先阅读 shared/references/host-model-execution.md。如果当前宿主能以所需的努力、隔离和回执策略,在原生子代理或任务线程中派发所选精确模型,则使用该原生路由。agents/openai.yaml 是宿主 UI 元数据,它不派发原生模型。
  • 席位保真(seat fidelity):必须指明实际应答的提供方,并诚实报告不可用或未经验证的席位。
  • 共享角色、信封键和结果处理位于 shared/references/runner-common.md。

使用方式

在同一 shell 调用中,将 SKILL_DIR 设为该已加载技能目录:

SKILL_DIR="<absolute path of this skill directory>";
python3 "$SKILL_DIR/scripts/run_dcode.py" "<scoped prompt>" --json

已批准的工作流会提供确切的模型、努力、角色、工具模式和回执策略。传入这些已批准的选项以及 --disable-fallback;上述基本示例不授权使用其他路由。

按需加载:

  • references/command-reference.md:在组合非基本调用时,查看标志、示例、原生映射和返回码。
  • references/runtime-reference.md:在配置路由或解释其结果时,查看认证、回退条件、配置和扩展信封字段。
  • references/continuation.md:仅在恢复会话或管理后台作业时使用。

适用场景

仅用于明确请求的手动 dcode 运行。该包装器无法绑定精确模型,也不能作为已批准的实现或审查路由。

限制

  • 用户现有的模型和凭据保留在 dcode 中配置。--model 是元数据标签,不会被转发。
  • 除非经授权的调用传入 --auto-approve,否则权限检查保持启用。提示和文件上下文可能会被发送到所配置的提供方。
  • 分析角色使用只读提示覆盖,而非强制沙箱。对不可信输入应隔离工作区;不要将 --restrict-tools 视为安全边界。
  • 当 CLI 缺失时,直接调用有一条带标签的回退链。不要将回退答案归因于 dcode。当调用方要求该席位时,使用 --disable-fallback。
  • 原生输出没有会话 ID。恢复最新会话使用共享状态,且不得针对同一 home 并发运行。

结果检查

阅读 agent_message 和包装信封。检查成功状态、服务模型回执、有效运行器/提供方,以及任何回退或格式异常状态。仅进程完成并不能证明使用了所请求的任务或模型。当调用方授权编辑时,报告被触及的文件。