结果数据与对象

Agently 会同时保留原始响应、解析后的结构化结果与元信息，便于不同层级的消费。

get_text：最终文本

get_text() 返回 done 阶段的最终文本（即使输出是 JSON，也仍保留原始文本）。

text = response.get_text()
print(text)

get_data：parsed / original / all

get_data() 支持三种类型：

• parsed：结构化结果（默认）
• original：原始供应商响应
• all：完整结果快照

parsed = response.get_data(type="parsed")
original = response.get_data(type="original")
all_data = response.get_data(type="all")

all 包含的核心字段：

• meta：usage、finish_reason 等元信息
• original_delta / original_done：原始流式片段与最终响应
• text_result：最终文本
• cleaned_result / parsed_result：清洗后的结构化 JSON 与解析结果
• result_object：Pydantic 对象（如果有）
• errors / extra：错误与额外信息

get_data_object：类型化结果

当你使用 Agently Output Format（JSON）时，可以直接拿到类型化结果对象：

result_obj = response.get_data_object()
print(result_obj)

ensure_keys：结构字段保障

get_data() 支持 ensure_keys 与重试参数，用于确保关键字段出现：

data = response.get_data(
  type="parsed",
  ensure_keys=["intro"],
  key_style="dot",
  max_retries=3,
  raise_ensure_failure=True,
)

其中 key_style 支持 dot 或 slash 路径风格。