痛点梳理

• 不清楚如何把 Agent 的记忆与 Hooks 统一格式化输出。
• 对 outputType 与 outputSchema 的区别、适用场景一头雾水。
• 想要自定义 JSON 输出，却不知道如何生成并注入到 ReactAgent。
• 担心自定义 Converter 后会导致模型返回非预期结构。

高级特性

结构化输出

选择建议：

• outputType: 通过类转换为 JSON。类型安全，最适合结构固定的场景。
• outputSchema: 先用 BeanOutputConverter 生成字符串，再手动提供更灵活、动态或复杂格式时优选。话说回来，

详细说：

outputType 结构化输出流程：

1. 在代码中声明目标 POJO。例如 TextAnalysisResult.class.
2. 利用 BeanOutputConverter 自动生成对应的 JSON Schema 字符串。
3. 将该 Schema 与自定义 prompt 拼接，建立完整的 instruction 给模型。
4. 模型按 RFC8259 标准返回符合 Schema 的 JSON 对象。

The trick:

If you want to plug in your own Converter,just create a new format string and set it on ReactAgent via outputSchema. The rest of pipeline remains unchanged.

再看示例代码。

public void test15 throws GraphRunnerException { ChatModel chatModel = CreateChatClient.createDashScopeChatModel;BeanOutputConverter outputConverter = new BeanOutputConverter<>;String jsonSchema = outputConverter.getJsonSchema;String template = """ Your response should be in JSON format. Do not include any explanations,only provide a RFC8259 compliant JSON response following this format without deviation. Here is JSON Schema instance your output must remove spentTimeSeconds properties:
%s
""";String format = String.format;ReactAgent agent = ReactAgent.builder  // Configure agent name、model & schema .name .model .outputSchema .build;// 调用代理进行文本分析 AssistantMessage message = agent.call;System.out.println);}

Hooks 与 Memory 格式化教程

• 常见问题： No Output From Hook or Memory! - 原因往往是没有正确注册 Hook 或者未在 Prompt 中引用 Memory 名称。