مرجع R.1

پارامترهای create_agent

create_agent parameters

فهرست مطالب
  1. امضای تابع (Signature)
  2. گرافی که برمی‌گرداند
  3. وضعیت (State)
  4. آرگومان‌های اجرای گراف

تابع 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.

ترجمه‌ی فارسی create_agent parameters از راهنمای LangChain 101 دوره‌ی AI Engineering from Scratch، نوشته‌ی Rohit Ghumare، تحت مجوز MIT. دستورها، لاگ‌ها و اعداد عیناً از اجراهای ثبت‌شده‌ی متن اصلی‌اند. فهرست راهنما