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

相关推荐
阿里云大数据AI技术10 小时前
OpenSearch 视频 RAG 实践
数据库·人工智能·llm
大模型开发11 小时前
零基础打造AI智能体实战教学(10)----零基础用Coze打造短视频自动洗稿工作流
llm·agent·coze
商汤万象开发者13 小时前
懒懒笔记 | 课代表带你梳理【RAG课程 19:基于知识图谱的RAG】
llm
字节跳动视频云技术团队14 小时前
ICME 2025 | 火山引擎在国际音频编码能力挑战赛中夺得冠军
llm·aigc·音视频开发
AI大模型15 小时前
COZE实战部署(二)—— 创建Coze应用
程序员·llm·coze
聚客AI15 小时前
大模型学习进阶路线图:从Prompt到预训练的四阶段全景解析
人工智能·llm·掘金·日新计划
大模型开发15 小时前
零基础打造AI智能体实战教学(9)----把Coze AI助手部署到Discord频道教程
llm·agent·coze
程序员鱼皮17 小时前
Cursor 1.2重磅更新,这个痛点终于被解决了!
ai·程序员·编程·agent·软件开发
ansurfen17 小时前
我的第一个AI项目:从零搭建RAG知识库的踩坑之旅
python·llm
亚马逊云开发者20 小时前
全景解读亚马逊云科技的 GenBI 解决方案:三大路径助力企业智能决策升级
sql·llm