آموزش مبانی عامل‌ها، ابزارها و برنامه‌ریزی با 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 از طریق پروتکل 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 include a bunch of tools

• عامل‌های زیرمجموعه با ابزار تسک عامل‌های عمیق 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!