输出控制概览

输出控制解决的核心问题是：如何让模型结果从“看起来像对的文本”变成“能稳定进入系统的结构结果”。

适合什么时候读

• 你已经能调用模型，但结果字段不稳定
• 你要把结果交给下游系统或 UI 使用
• 你想同时要结构化输出和流式体验

你会学到什么

• output() 如何定义结构
• ensure_keys 如何增强关键字段稳定性
• 字段顺序和依赖为什么重要
• instant 如何把结构化流式输出接到 UI 或流程里

最小示例

from agently import Agently

agent = Agently.create_agent()

result = (
    agent
    .input("为 Agently 写一句定位和两个卖点")
    .output(
        {
            "定位": ("str", "一句话定位"),
            "卖点": [("str", "卖点")],
        }
    )
    .start(ensure_keys=["定位", "卖点[*]"])
)

能力地图

• Agently Output Format 语法
• ensure_keys 关键字段保障
• 输出顺序与依赖控制
• Instant 结构化流式解析

常见误区

• 还没用 output()，就先自己写 JSON parser。
• 字段之间有依赖，却没有按顺序设计输出结构。
• 想做结构化流式展示，却仍然只按最终文本处理结果。

下一步去哪

• 要读取 text/data/meta 和事件流：看 模型返回结果概览
• 要理解 Prompt 和输出契约如何配合：看 Prompt 管理概览

相关案例

• 工单分诊
• 流式 + 结构化混合

Related Skills（可选）

• agently-output-control
• agently-model-response