mcpField
A
agently-output-control

agently-output-control

github.com/agenteraAgent 工作流3141 次安装4 天前更新
代码仓库

关于 agently-output-control

用于控制 Agently 模型输出的结构与可靠性，指导选择请求级输出约定、`.output(...)` 或 `ensure_keys`，并考虑异步结果处理。

主要功能

  1. 01选择输出约定的配置位置
  2. 02用 `.output(...)` 处理动态结构
  3. 03通过 `ensure_keys` 强制必需字段
  4. 04适时优先采用异步处理

适用场景

  1. 01生成结构稳定的报告
  2. 02为下游步骤提供机器可读字段

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agentera/agently-skills --skill agently-output-control

安装后在 Claude Code 中输入/agently-output-control确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

examples/
.gitkeep
minimal.py
outputs/
.gitkeep
expected.md
references/
overview.md
scripts/
check.py

详细介绍

Agently 输出控制

当问题在于模型应返回什么结构，以及该结构如何保持可靠时，使用此技能。

用户不需要说出 .output(...) 或 ensure_keys。对于稳定 JSON 类字段、结构化报告或机器可读区块的请求，应路由到此处。

原生优先规则

  • 当结构化输出将被流式传输、复用或通过异步边界提供服务时，默认采用异步优先的响应消费方式
  • 当 schema 稳定且在一类请求中共享时，优先使用提示词配置所拥有的输出契约，例如 .request.output
  • 当 schema 是动态的、探索性的，或更容易与代码保持紧密时，机器可读结果优先使用 .output(...)
  • 当必须强制要求必填字段时，优先使用 ensure_keys
  • 当下游系统、工作流分支或后续模型步骤会消费结果时，保持输出 schema 显式声明

反模式

  • 当 .output(...) 已经拥有契约时，不要手写 JSON 后处理器
  • 如果提示词配置可以一次性拥有稳定的共享 schema，不要在 Python 中重建它
  • 在检查 ensure_keys 之前，不要为缺失键构建自定义重试循环
  • 当调用方已经具备异步能力时，不要默认仅使用同步方式处理结果

接下来阅读

  • references/overview.md

评论

支持 Markdown