__init__

libs\langchain\langchain_classic\agents_init_.py

此文档提供了 libs\langchain\langchain_classic\agents\__init__.py 文件的详细中文注释。该模块是 LangChain 代理系统的核心入口。

功能描述

代理 (Agent) 是一种使用大语言模型（LLM）来选择一系列动作执行的类。在链（Chains）中，动作序列是硬编码的；而在代理中，语言模型被用作推理引擎，来决定采取哪些动作以及以何种顺序执行。

代理会选择并使用 工具 (Tools) 和 工具包 (Toolkits) 来执行动作。

主要组件

该模块聚合并导出了代理框架的核心类和函数：

1. 核心抽象与执行器

• BaseSingleActionAgent, BaseMultiActionAgent: 代理的基础抽象类。
• Agent: 传统的基于 LLMChain 的代理基类。
• AgentExecutor: 代理执行器，负责驱动代理的思考-行动-观察循环。
• AgentExecutorIterator: 允许迭代执行代理步骤的工具。
• AgentOutputParser: 将 LLM 输出解析为代理动作或结束状态的解析器。

2. 预置代理类型与创建函数

• AgentType: 代理类型的枚举。
• create_react_agent: 创建 ReAct 风格的代理。
• create_openai_functions_agent, create_openai_tools_agent: 利用 OpenAI 特定能力的代理。
• create_structured_chat_agent: 适用于聊天模型的结构化代理。
• create_xml_agent: 专门生成 XML 格式的代理。
• create_tool_calling_agent: 通用的工具调用代理。
• create_self_ask_with_search_agent: 自我提问搜索代理。

3. 加载与初始化

• initialize_agent: (已弃用) 快速初始化代理的函数。
• load_agent: 从配置文件或仓库加载代理。

动态导入与弃用处理

该模块使用了动态导入机制来处理已迁移到 langchain_community 或 langchain_experimental 的组件。

1. 迁移至 langchain_community

以下组件通过 DEPRECATED_LOOKUP 动态映射到社区包：

• load_tools, load_huggingface_tool, get_all_tool_names
• create_json_agent, create_openapi_agent, create_pbi_agent, create_pbi_chat_agent, create_spark_sql_agent, create_sql_agent

2. 迁移至 langchain_experimental

以下代理创建函数已迁移到实验性包，直接调用会抛出 ImportError：

• create_csv_agent, create_pandas_dataframe_agent, create_spark_dataframe_agent, create_xorbits_agent

迁移建议

对于新的代理开发，建议参考 LangGraph 文档。LangGraph 提供了比传统 AgentExecutor 更灵活、功能更强大的框架，支持循环逻辑、状态持久化和复杂的人机交互模式。