تابع
create_agentدر نسخهی 1.5.0 کتابخانهیlangchainیک مدل، ابزارها و 13 پارامتر کلیدواژهای میگیرد و یک گراف کامپایلشدهی LangGraph با سقف بازگشت (recursion limit) برابر با 9999 برمیگرداند.
جدولهای زیر هر پارامتر، نوع، مقدار پیشفرض آن در این نسخهی تثبیتشده و عملکرد کد روی آن را نشان میدهند. در هر ردیف، شمارهی خط در فایل libs/langchain_v1/langchain/agents/factory.py در نسخهی langchain==1.5.0 نیز ارجاع داده شده است. بخش 4.1 ساختار این گراف را شرح میدهد و ستون آخر به بخشی لینک دارد که نحوهی اجرای هر پارامتر را بررسی میکند.
امضای تابع (Signature)
این تابع را با دستور from langchain.agents import create_agent وارد (import) کنید. تابع از خط 895 و بعد از سه overload نوعبندیشده در خطوط 827، 849 و 873 شروع میشود {{code libs/langchain_v1/langchain/agents/factory.py:827-914}}. دو پارامتر اول موضعی (positional) هستند و بقیه فقط بهصورت کلیدواژهای دریافت میشوند.
| پارامتر | نوع | پیشفرض | عملکرد کد | بخش |
|---|---|---|---|---|
model |
str یا BaseChatModel |
اجباری | رشته فقط یکبار هنگام ساخت ایجنت، از طریق init_chat_model پردازش میشود {{code libs/langchain_v1/langchain/agents/factory.py:1050-1051}}. |
3.2 |
tools |
دنبالهای از BaseTool، فراخوانپذیرها (callables) و دیکشنریها |
None |
دیکشنری ابزار ارائهدهنده (provider tool) محسوب میشود؛ به مدل متصل (bind) شده و هرگز در گرهی tools اجرا نمیشود {{code libs/langchain_v1/langchain/agents/factory.py:1135-1139}}. |
3.4 |
system_prompt |
str یا SystemMessage |
None |
رشته به یک SystemMessage تبدیل میشود {{code libs/langchain_v1/langchain/agents/factory.py:1054-1059}}. در ابتدای هر درخواست به مدل قرار میگیرد و در وضعیت ذخیره نمیشود {{code libs/langchain_v1/langchain/agents/factory.py:1506-1507}}. |
3.5 |
middleware |
دنبالهای از AgentMiddleware |
() |
اگر دو نمونه با یک name یکسان باشند، خطای AssertionError رخ میدهد {{code libs/langchain_v1/langchain/agents/factory.py:1163-1165}}. ابزارهای آنها به ابزارهای شما ملحق میشوند {{code libs/langchain_v1/langchain/agents/factory.py:1092}}. |
4.5 |
response_format |
ToolStrategy، ProviderStrategy، AutoStrategy، یک نوع یا دیکشنری |
None |
یک اسکیمای ساده به AutoStrategy تبدیل میشود که در هر بار فراخوانی مدل، یک استراتژی را برمیگزیند {{code libs/langchain_v1/langchain/agents/factory.py:1412-1422}}. |
4.2 |
state_schema |
زیرکلاسی از AgentState |
None |
اسکیمای میدلورها ابتدا merge میشود و این اسکیما در آخر merge خواهد شد؛ بنابراین فیلدهای آن اولویت دارند {{code libs/langchain_v1/langchain/agents/factory.py:1229-1235}}. | 4.1 |
context_schema |
یک نوع | None |
نوع آرگومان context در اجرا را مشخص میکند. بدون آن، دیکشنری context در اجراهای ما اخطار pydantic میدهد. |
5.4 |
checkpointer |
یک Checkpointer |
None |
به متد compile پاس داده میشود. بدون آن، هیچ وضعیتی بین فراخوانیها حفظ نمیشود {{code libs/langchain_v1/langchain/agents/factory.py:1909-1916}}. |
5.2 |
store |
یک BaseStore |
None |
به compile داده شده و در قالب runtime.store به ابزارها داده میشود. |
5.4 |
interrupt_before |
فهرستی از نام گرهها | None |
نقطهتوقفهای ایستا (static breakpoints) قبل از گرههای مشخصشده، که به compile پاس داده میشوند. |
6.4 |
interrupt_after |
فهرستی از نام گرهها | None |
نقطهتوقفهای ایستا بعد از گرههای مشخصشده، که به compile پاس داده میشوند. |
6.4 |
debug |
bool |
False |
به compile پاس داده میشود. |
4.1 |
name |
str |
None |
نام گراف، name در هر پاسخ مدل و مقدار lc_agent_name را در متادیتای اجرا تنظیم میکند {{code libs/langchain_v1/langchain/agents/factory.py:1510-1511}} {{code libs/langchain_v1/langchain/agents/factory.py:1904-1905}}. |
6.7 |
cache |
یک BaseCache از LangGraph |
None |
کش گرهها که به compile پاس داده میشود؛ این با کش مدل در set_llm_cache تفاوت دارد. |
4.7 |
transformers |
دنبالهای از سازندههای ترنسفورمر استریم | None |
بعد از ToolCallTransformer، SubagentTransformer و ترنسفورمرهای هر میدلور اضافه میشود {{code libs/langchain_v1/langchain/agents/factory.py:1917-1924}}. |
5.1 |
در مستندات کد (docstring) آمده است که response_format مواردی مثل ToolStrategy، ProviderStrategy یا یک کلاس Pydantic را میپذیرد. امضای تابع مواردی مثل AutoStrategy، دیتامدلهای dataclass، ساختار TypedDict و دیکشنری اسکیمای JSON (JSON Schema) را هم میگیرد؛ فایل 07-structured-output.txt اجرای تکتک این موارد را تست میکند {{code libs/langchain_v1/langchain/agents/factory.py:901}}.
گرافی که برمیگرداند
نوع بازگشتی این تابع CompiledStateGraph است. کد ابتدا گراف را کامپایل میکند و سپس یک پیکربندی اجرایی (run config) روی آن اعمال میکند {{code libs/langchain_v1/langchain/agents/factory.py:1902-1925}}.
| ویژگی | مقدار در این نسخه | منشأ در کد |
|---|---|---|
| گرهی مدل | model |
graph.add_node("model", ...) {{code libs/langchain_v1/langchain/agents/factory.py:1614}} |
| گرهی ابزار | tools، یک ToolNode؛ فقط همراه با ابزارهای کلاینت یا میدلورِ wrap_tool_call حضور دارد |
{{code libs/langchain_v1/langchain/agents/factory.py:1142-1151}} |
| گرههای میدلور | <name>.before_agent، <name>.before_model، <name>.after_model، <name>.after_agent |
فایل لاگ 09-middleware-order.txt |
recursion_limit |
9999 | {{code libs/langchain_v1/langchain/agents/factory.py:1902}} |
| متادیتای اجرا | {"ls_integration": "langchain_create_agent"} |
{{code libs/langchain_v1/langchain/agents/factory.py:1903}} |
stream_mode پیشفرض |
updates |
StateGraph.compile {{code libs/langgraph/langgraph/graph/state.py:1357}} |
| فراخوانیهای موازی ابزار | یک Send("tools", [tool_call]) برای هر فراخوانی در صف انتظار، در یک گام |
{{code libs/langchain_v1/langchain/agents/factory.py:2031-2032}} |
| خروج از حلقه | نبود فراخوانی ابزار، یا یک structured_response جدید |
{{code libs/langchain_v1/langchain/agents/factory.py:2015-2036}} |
گرهی tools از کنترلکنندهی خطای پیشفرض ToolNode استفاده میکند: برای آرگومانهای اشتباه یک پیام برمیگرداند و برای هر خطای دیگری استثنا صادر میکند (raise میکند) {{code libs/prebuilt/langgraph/prebuilt/tool_node.py:391-399}}. بخش 3.4 هر دو حالت را نشان میدهد.
وضعیت (State)
کلاس AgentState در واقع یک TypedDict با سه کلید است {{code libs/langchain_v1/langchain/agents/middleware/types.py:351-372}}.
| کلید | نوع | توضیحات |
|---|---|---|
messages |
فهرستی از پیامها با کاهندهی (reducer) add_messages |
اجباری |
jump_to |
"tools"، "model" یا "end" |
خصوصی و گذرا. هوک گره آن را برای مسیریابی اجرا مقداردهی میکند {{code libs/langchain_v1/langchain/agents/middleware/types.py:70}} |
structured_response |
اسکیمای شما | از اسکیمای ورودی حذف میشود |
کلاس InputAgentState فقط messages را نگه میدارد. کلاس OutputAgentState شامل messages و structured_response است.
آرگومانهای اجرای گراف
متدهای اجرا متعلق به گراف کامپایلشده از langgraph 1.2.22 هستند. متدهای invoke و stream کلیدواژههای یکسانی میگیرند و stream پارامتر subgraphs را نیز میپذیرد {{code libs/langgraph/langgraph/pregel/main.py:2767-2783}} {{code libs/langgraph/langgraph/pregel/main.py:3948-3962}}.
| آرگومان | پیشفرض | توضیحات | بخش |
|---|---|---|---|
input |
اجباری | یک دیکشنری حاوی messages، مقدار None برای ادامه از یک چکپوینت، یا یک Command برای ازسرگیری (resume). |
6.4 |
config |
None |
شامل recursion_limit، max_concurrency، callbacks و configurable، که thread_id درون configurable قرار دارد. |
5.2 |
context |
None |
دادههای ایستا برای فرایند اجرا، قابل خواندن در قالب runtime.context. |
5.4 |
stream_mode |
برای invoke برابر با values و برای stream مقدار پیشفرض گراف |
در مرجع استریم تمام حالتها فهرست شدهاند. | 5.1 |
durability |
async |
میتواند sync، async یا exit باشد {{code libs/langgraph/langgraph/pregel/main.py:2715}}. |
5.3 |
interrupt_before، interrupt_after |
None |
نقطهتوقفهای موقت صرفاً برای همین اجرا. | 6.4 |
subgraphs |
False |
فقط در stream. در این صورت، هر چانک فضای نام (namespace) سابگرافش را به همراه دارد. |
6.7 |
version |
v1 |
در نسخهی v2 دیکشنریهای StreamPart خروجی داده میشوند و invoke یک GraphOutput برمیگرداند. |
5.1 |
منابع: libs/langchain_v1/langchain/agents/factory.py، libs/langchain_v1/langchain/agents/middleware/types.py و libs/langchain_v1/langchain/agents/structured_output.py در langchain==1.5.0؛ libs/langgraph/langgraph/pregel/main.py، libs/langgraph/langgraph/graph/state.py و libs/prebuilt/langgraph/prebuilt/tool_node.py در langgraph 1.2.22؛ capture/out/05-agent-graph.txt، capture/out/06-agent-run.txt، capture/out/07-structured-output.txt، capture/out/09-middleware-order.txt.