LangGraph官方文档笔记(七)——Agent的输入输出

LangGraph文档解释:github.langchain.ac.cn/langgraphjs...

一、输入格式

代理输入必须是一个包含 messages 键的对象,支持多种输入形式,且会自动转换为 LangChain 内部消息格式。具体格式如下:

  • 字符串格式
    { messages: "Hello" }
    会被解释为 HumanMessage(用户消息)。
  • 消息对象格式
    { messages: { "role": "user", "content": "Hello" } }
    直接指定角色(如 user)和内容。
  • 消息列表格式
    { messages: [{"role": "user", "content": "Hello"}] }
    支持多条消息按顺序传入。
  • 带自定义状态格式
    { messages: [{"role": "user", "content": "Hello"}], "user_name": "Alice" }
    若定义了 stateSchema,可添加额外字段(如 user_name),用于动态调整代理行为。

二、输出格式

代理输出是一个字典,包含以下核心内容:

  • messages
    执行过程中所有消息的列表,包括用户输入、助手回复、工具调用等完整交互记录。
  • structuredResponse(可选)
    若配置了结构化输出(如 JSON 格式),会在此字段中包含解析后的结果。
    LangGraph配置结构化输出文档
  • 自定义状态字段(可选)
    若定义了 stateSchema,输出会包含工具执行结果或提示逻辑更新的状态值(如 user_name)。

示例

json 复制代码
{
  "messages": [
    {"role": "user", "content": "what is the weather in sf"},
    {"role": "assistant", "content": "Thinking... need to call weather tool"},
    {"role": "tool", "name": "getWeather", "parameters": {"location": "SF"}},
    {"role": "assistant", "content": "The weather in SF is sunny."}
  ],
  "structuredResponse": {"weather": "sunny", "temperature": "22°C"},
  "user_name": "Alice"  // 自定义状态字段
}

三、对比与应用场景

场景 输入格式示例 输出格式核心字段
简单文本交互 { messages: "What's today's date?" } messages(包含助手回复)
复杂对话历史 { messages: [{"role": "user", "content": "First question"}, ...] } messages(按顺序记录所有消息)
工具调用场景 { messages: ["Get weather in NY"], "location": "New York" } messages(包含工具调用记录)、structuredResponse(天气数据)
自定义状态管理 { messages: ["Hello"], "user_id": 123 } messages、user_id(状态保留)

四、延伸

  • 输入转换逻辑:所有输入格式最终都会被解析为 LangChain 消息对象,确保代理能统一处理不同形式的输入。
  • 输出扩展性 :通过 stateSchema 可自定义输出字段,适用于需要持久化用户状态或工具调用结果的场景(如多轮对话中保存用户偏好)。
  • 与流式输出的结合 :流式输出时,每次更新会逐步返回 messages 中的内容片段,提升用户交互体验(如实时显示 LLM 生成过程)。

原文地址:https://www.cnblogs.com/LiShengTrip/p/18957212

相关推荐
Csvn12 小时前
同一个问题问 100 遍,钱就扣 100 次?精确缓存让它只扣一次(C02)
人工智能·aigc·agent
岁月宁静13 小时前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
XLYcmy14 小时前
基于大语言模型的智能漏洞检测与修复系统 作品报告评审分析报告 上
llm·prompt·模糊测试·漏洞修复·漏洞检测·deepseek·消融实验
小七-七牛开发者15 小时前
周 1 上线 | DSH 喜提原神进场动画,Anthropic 启动 IPO 路演;黄仁勋辞任;微软全球大宕机超 24 小时
ai·大模型·agent·token·工作流·claudecode·ai coding
泯泷15 小时前
Multica 真正打动我的,不是更多 Agent,而是一种新的团队协作方式
人工智能·llm·agent
阿里云大数据AI技术15 小时前
云栖实录|倍思科技 × 阿里云:让VOC洞察从“生成报告”走向“业务可用”
人工智能·elasticsearch·agent
GISer_Jing16 小时前
GitHub热点I
后端·ai·langchain
XLYcmy16 小时前
基于大语言模型的智能漏洞检测与修复系统 作品报告评审分析报告 下
机器学习·llm·prompt·api·token·漏洞修复·漏洞检测
QuZhengRong16 小时前
【AI】Agent 全栈进阶|AgentScope 沙箱源码解析
python·学习·ai·agent·沙箱