KeyWaiter 早到字段 Playbook

场景

合规/风控/审批类场景，需要字段级结果提前触发。

需要使用功能（关键特性）

• KeyWaiter：结构化字段级监听
• instant：结构化流式解析

具体操作

1. output() 定义结构化字段。
2. 用 when_key / wait_keys 监听关键字段。

完整代码

from agently import Agently

Agently.set_settings(
    "OpenAICompatible",
    {
        "base_url": "http://localhost:11434/v1",
        "model": "qwen2.5:7b",
        "model_type": "chat",
    },
).set_settings("request_options", {"temperature": 0.2}).set_settings("debug", False)

agent = Agently.create_agent()

(
    agent.system(
        "你是合规预审助手，先给出风险，再给出处理建议。"
    )
    .input(
        "我要在官网放一个‘七天包退’的宣传页，文案包含："
        "‘100% 保本、无任何风险’。帮我判断风险并给出建议。"
    )
    .output(
        {
            "risk": (str, "主要合规风险"),
            "decision": (str, "处理建议"),
            "rewrite": (str, "替代文案"),
        }
    )
    .when_key("risk", lambda v: print("RISK:", v))
    .when_key("decision", lambda v: print("DECISION:", v))
    .when_key("rewrite", lambda v: print("REWRITE:", v))
    .start_waiter()
)

真实输出

RISK: 广告宣传可能存在误导，容易使消费者误解为投资绝对保本且无风险。
DECISION: 建议修改文案，避免使用绝对化词语，并明确表示可能存在的投资风险。
REWRITE: 我们承诺在七天内如果您对产品不满意，可以包退。请理解所有金融和投资项目均有可能带来收益同时也伴随着一定的风险。

验证点

• 关键字段在响应完成前可被触发。
• 结构化字段路径一致。