模型返回结果概览

输出控制解决“如何把结果变成可控的结构”，本章解决“如何读出并消费这些结果”。Agently 把模型返回整理成统一的响应对象，让你以一致的方式拿到文本、结构化数据、元信息与流式事件。

结果链路

关键对象

• ModelResponse：一次请求的“响应快照”，包含 response.id、prompt 与 settings 的快照，可用 cancel_logs() 关闭日志。
• ModelResponseResult：结果访问入口，提供 get_text() / get_data() / get_data_object() / get_meta() / get_generator()。
• ResponseParser：统一事件流并解析结构化结果，默认实现为 AgentlyResponseParser。

推荐用法：先拿 response 再读取

在链式调用里，agent.start() / agent.get_text() / agent.get_data() / agent.get_data_object() / agent.get_meta() / agent.get_generator()（以及 request 上的同名方法）都会隐式创建新的 response 并发起一次请求。为了固定单次请求的结果，工程上建议先 get_response() 拿到 response，再在 response 上多次读取文本、结构化数据、元信息或流式事件。

from agently import Agently

agent = Agently.create_agent()

response = (
  agent
  .input("用一句话介绍 Agently")
  .output({
    "intro": ("str", "一句话简介"),
  })
  .get_response()
)

text = response.get_text()
data = response.get_data()
meta = response.get_meta()

print(text)
print(data)
print(meta)