آموزش مبانی عامل‌ها، ابزارها و برنامه‌ریزی با LangChain - آخرین آپدیت

سرفصل ها و درس ها

از تکمیل‌کننده‌ها به ابزارها و عامل‌ها From Completions to Tools to Agents

• استفاده از یک عامل برای تبدیل کد پایتون از SDK OpenAI به LangChain Use an agent to port python from OpenAl's SDK to LangChain!

• تولید پاسخ با استفاده از init_chat_model() Generate a completion with init_chat_model()

• فراخوانی دستی ابزارها Manual tool calls

• توانایی مدل‌ها در درخواست فراخوانی ابزار Models can request tool calls

• فراخوانی خودکار ابزارها با create_agent() Automatic tool calling with create_agent()

• فراخوانی ابزارها با Llama Server برای gpt oss 120b Tool calls with llama-server to gpt-oss-120b

• استفاده از Claude Sonnet از طریق ارائه‌دهنده Anthropic Claude Sonnet via the Anthropic provider

• آیا فراخوانی متوالی ابزارها همان عامل است؟ Sequential tool calls == Agent?

• استفاده مدل‌ها از استدلال برای اصلاح برنامه عملیاتی Models use reasoning to adjust their plan of action

• نحوه جریان ابزارها در پرامپت خام Harmony برای gpt oss How tools flow into the raw, Harmony prompt for gpt-oss

• فراخوانی ابزارهای Gemma 4: پرامپت خام و پاسخ Gemma 4 tool calls: raw prompt and response

ساخت و ارائه ابزارها Building and providing tools

• ساخت ابزار run_python Create a run_python tool

• ساخت ابزار run_command A run_command tool

• هدایت مدل با تغییر جزئی در توضیحات ابزار Nudge the model with a slight change to the tool description

• استفاده از agent.astream_events() برای استریم زنده پیام‌ها Use agent.astream_events() to stream messages live

• عامل در واقع یک حلقه فراخوانی ابزار است An agent is largely a tool calling loop

• پکیج community در LangChain به همراه ابزار جستجوی ویکی‌پدیا The langchain-community package with a Wikipedia search tool

• ترغیب مدل به استفاده از ابزار ویکی‌پدیا به جای داده‌های آموزشی Prompt the model to use the Wikipedia tool instead of training data

• افزودن ابزار Fetch از طریق پروتکل Model Context Protocol (MCP) Add a Fetch tool via Model Context Protocol (MCP)

• ضرورت بازیابی مدل پس از خطاهای ابزار Models should recover after tool failures

دست از انتظار کمال بردارید Stop expecting perfection

• انتظار بازیابی داشته باشید، نه کمال Expect recovery, not perfection

• حلقه استدلال بی‌نهایت با ggml org/Qwen3.6 35B A3B GGUF:Q8_0 Infinite reasoning loop with ggml-org/Qwen3.6-35B-A3B-GGUF:Q8_0

• تنظیم max_tokens یا غیرفعال کردن استدلال برای جلوگیری از حلقه‌های تکراری Set max_tokens and/or disable reasoning to avoid reasoning loops

• چالش متوقف کردن gpt oss از استفاده از ls R Good luck getting gpt-oss to stop using `ls -R`

• مسدود کردن ls R در سطح ابزار Block `ls -R` at the tool level

• مدل Qwen اکنون می‌تواند کدهای ما را ویرایش کند! Qwen can edit our code now!

• استفاده از recursion_limit برای محدود کردن دورهای استفاده از ابزار Use recursion_limit to cap tool use rounds

• توهم مدل gpt oss در مورد ابزار apply_patch gpt-oss hallucinates an apply_patch tool

• تأیید فراخوانی ابزار با میان‌افزار Human in the Loop (HITL) Tool call approval with Human-in-the-Loop (HITL) middleware

• ازسرگیری فعالیت عامل با تصمیم‌گیری: تأیید، رد یا ویرایش Resume your agent with a decision: approve, reject, or edit

برنامه‌ریزی و نگاه کلی به سیستم Planning and the bigger picture

• عامل به عنوان یک گراف The agent is a graph

• استفاده از create_deep_agent() create_deep_agent()

• عامل‌های عمیق (Deep Agents) و مجموعه‌ای از ابزارهای آن‌ها Deep Agents include a bunch of tools

• عامل‌های زیرمجموعه با ابزار وظایف Deep Agents Subagents with the Deep Agents task tool

• سلسله‌مراتب زنده ناظر/عامل زیرمجموعه با agent.astream_events() Live supervisor / subagent hierarchy with agent.astream_events()

• سازماندهی سلسله‌مراتب رویدادها با on_chain_start on_chain_start organizes most of the event hierarchy

• در دسترس بودن ابزار execute با LocalShellBackend LocalShellBackend avails the execute tool

• اجبار عامل ناظر به واگذاری اجرای دستورات به عامل‌های زیرمجموعه Force your supervisor agent to delegate command execution to subagents

• بهبود فراخوانی ابزارها از طریق استدلال و برنامه‌ریزی اولیه Reasoning improves tool calls by planning upfront

• تاب‌آوری در ارتباط بین عامل ناظر و عامل زیرمجموعه Supervisor agent to subagent agent resilience

• ترکیب ابزار write_todos و checkpointer به عنوان راه نجات write_todos tool + checkpointer == lifeline

• عامل‌ها نیازی به بی‌نقص بودن ندارند، فقط باید بتوانند از سر بگیرند! Agents don't need to be perfect—they just need to resume!