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 } messagesuser_id(状态保留)

四、延伸

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

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

相关推荐
都叫我大帅哥1 小时前
我给大模型装上“记忆黄金券”:LangChain的ConversationSummaryBufferMemory全解析
python·langchain·ai编程
白熊1888 小时前
【大模型LLM】梯度累积(Gradient Accumulation)原理详解
人工智能·大模型·llm
pingzhuyan10 小时前
python入门篇12-虚拟环境conda的安装与使用
python·ai·llm·ocr·conda
大熊猫侯佩13 小时前
无需自己写半行代码:让 AI 编程智能体(Agent)化身神笔马良为我们自动仿制 App 界面
swiftui·agent·cursor
缘友一世15 小时前
基于LangGraph Cli的智能数据分析助手
langchain·llm·agent·langgraph
谷歌上搜百度15 小时前
LLM并非“万能钥匙”——深度解析大语言模型的本质与边界
人工智能·llm
AI大模型18 小时前
本地AI知识库问答开源技术实现(一)--安装和准备
程序员·llm·ai编程
AI大模型18 小时前
本地AI知识库问答开源技术实现(二)--配置模型和知识库
程序员·llm·agent
302AI19 小时前
302.AI 独家 | 让 Claude Code 支持任意第三方模型
llm·claude
聚客AI19 小时前
📚企业AI架构革命:MCP协议如何打通数据孤岛?
人工智能·llm·mcp