SuperAPI AI 工具集

agently-output-control

智能体与模型

查看项目

更新于 10-15 19:51

技能介绍

用途:当问题核心是“模型应返回什么形状的数据、如何保持这一形状可靠”时使用该技能。用户无需直接写 .output(...) 或 ensure_keys;凡涉及稳定 JSON 类字段、结构化报告、机器可读区段的请求,都应路由到此技能。

主要能力与用法(原生优先规则):

  • 当结构化输出会被流式传输、复用或跨异步边界提供时,默认采用 async-first 的响应消费方式。
  • 若 schema 稳定且在请求族中共享,优先用提示配置持有的输出契约,如 .request.output。
  • 若 schema 是动态、探索性的或便于贴近代码维护,优先用 .output(...) 获取机器可读结果。
  • 当必须强制某些字段存在时,优先用 ensure_keys。
  • 当下游系统、工作流分支或后续模型步骤会消费结果时,保持输出 schema 显式。

应避免的做法:不要在用 .output(...) 已掌控契约时手写 JSON 后处理器;不要在提示配置能一次性持有稳定共享 schema 时于 Python 中重建;不要在未检查 ensure_keys 前为缺失键自建重试循环;不要在调用方已支持异步时默认只用同步结果处理。

限制:资料未提供具体安装命令、参数签名、收费或平台支持信息;进一步细节可参考 references/overview.md。