مرجع R.5

متغیرهای محیطی

Environment variables

فهرست مطالب
  1. LangGraph
  2. LangChain
  3. ردگیری محاسبات و آزمون‌ها در LangSmith
  4. Agent Server و رابط خط فرمان آن
  5. کیت ثبت خروجی (Capture Kit)

این صفحه 23 متغیر محیطی (environment variable) را که در نسخه‌ی تثبیت‌شده‌ی این استک یا مستندات آن آمده است، به همراه فایل و خط خوانده شدن هر کدام فهرست می‌کند.

هر متغیر را پیش از شروع فرایند تنظیم کنید. متغیر LANGGRAPH_DEFAULT_RECURSION_LIMIT، تنظیمات دلتا و LANGGRAPH_STRICT_MSGPACK هنگام ایمپورت شدن ماژولشان خوانده می‌شوند. SDK لنگ‌اسمیت (LangSmith) هر مقدار را پس از اولین خواندن کش می‌کند {{code src/langsmith/utils.py:394}}. این SDK نام‌ها را ابتدا با پیشوند LANGSMITH_ و سپس با پیشوند LANGCHAIN_ می‌خواند {{code src/langsmith/utils.py:377-381}}. کلید فعال‌سازی ردگیری محاسبات (tracing) یک استثنا است: متغیر TRACING_V2 با هر کدام از این دو پیشوند، بر LANGSMITH_TRACING اولویت دارد. سطرهایی که فقط مستندات از آن‌ها پشتیبانی می‌کنند، مشخص شده‌اند.

LangGraph

متغیر مقدار پیش‌فرض عملکرد محل خواندن بخش
LANGGRAPH_DEFAULT_RECURSION_LIMIT 10007 حد بازگشت (recursion limit) اجرایی که در تنظیماتش recursion_limit مشخص نشده باشد {{code libs/langgraph/langgraph/_internal/_config.py:42-43}} 6.8
LANGGRAPH_DELTA_MAX_SUPERSTEPS_SINCE_SNAPSHOT 5000 بیشترین گام‌هایی که یک DeltaChannel بدون اسنپ‌شات کامل طی می‌کند {{code libs/langgraph/langgraph/_internal/_config.py:45-46}} 5.5
LANGGRAPH_STRICT_MSGPACK false مقدار 1، true یا yes هر نوع msgpack را که در لیست مجاز نباشد مسدود می‌کند {{code libs/checkpoint/langgraph/checkpoint/serde/_msgpack.py:12-16}} 5.6، 8.4
LANGGRAPH_AES_KEY ندارد کلید EncryptedSerializer به‌صورت 16، 24 یا 32 بایت. بدون این متغیر و بدون آرگومان key، این کلاس خطای ValueError صادر می‌کند {{code libs/checkpoint/langgraph/checkpoint/serde/encrypted.py:54-59}} R.4

حد بازگشت برای گرافِ create_agent برابر 9999 است که تنظیمات خودِ آن تعیینش می‌کند؛ بنابراین این متغیر تغییری در آن ایجاد نمی‌کند. بخش 6.8 این متغیر را ارزیابی کرد: روی مقدار 25، یک حلقه‌ی ساده دقیقاً در گام 25 متوقف شد. باقی ماندن مقدار ایجنت روی 9999 بر اساس کد مشخص شده است، نه آزمایش در زمان اجرا.

LangChain

متغیر مقدار پیش‌فرض عملکرد محل خواندن بخش
LC_OUTPUT_VERSION ندارد مقدار پیش‌فرض output_version برای مدل گفت‌وگو، v0 یا v1 {{code libs/core/langchain_core/language_models/chat_models.py:396-397}} 3.3
LANGSMITH_GATEWAY ندارد مقدار true یا یک نشانی URL، یکپارچه‌سازی‌های ارائه‌دهندگانی مثل ChatOpenAI و ChatAnthropic را از طریق درگاه مدل (model gateway) لنگ‌اسمیت هدایت می‌کند. ارائه‌دهنده‌ی langsmith در init_chat_model بدون این متغیر هم از درگاه استفاده می‌کند {{code libs/langchain_v1/langchain/chat_models/base.py:24-37}} {{code libs/core/langchain_core/utils/_gateway.py:35}} {{code libs/core/langchain_core/utils/_gateway.py:95}} 3.2
LANGSMITH_GATEWAY_API_KEY ندارد کلید آن درگاه. در غیاب آن، کد مقدار LANGSMITH_API_KEY را می‌خواند {{code libs/core/langchain_core/utils/_gateway.py:36-37}} {{code libs/core/langchain_core/utils/_gateway.py:165}} 3.2

ردگیری محاسبات و آزمون‌ها در LangSmith

متغیر مقدار پیش‌فرض عملکرد محل خواندن بخش
LANGSMITH_TRACING_V2، LANGCHAIN_TRACING_V2 ندارد روشن شدن ردگیری محاسبات، زمانی که مقدار دقیقاً true باشد {{code src/langsmith/utils.py:138-140}} 7.6
LANGSMITH_TRACING، LANGCHAIN_TRACING ندارد همان کلید روشن‌سازی؛ وقتی خوانده می‌شود که هیچ‌کدام از متغیرهای TRACING_V2 تنظیم نشده باشند {{code src/langsmith/utils.py:138-140}} 7.6
LANGSMITH_API_KEY ندارد کلید کلاینت لنگ‌اسمیت {{code src/langsmith/utils.py:803-805}} 7.6
LANGSMITH_ENDPOINT اندپوینت ابری لنگ‌اسمیت جایی که کلاینت اجراها را به آن ارسال می‌کند. یک سرور روی شبکه‌ی محلی خودتان، اجراها را پیش خودتان نگه می‌دارد {{code src/langsmith/utils.py:789-797}} 7.6
LANGSMITH_PROJECT default پروژه‌ی مربوط به اجراهای ردگیری‌شده. سرور در اولین اجرا آن را می‌سازد. پلاگین pytest فقط زمانی از آن به‌عنوان پیشوند آزمایش استفاده می‌کند که LANGSMITH_EXPERIMENT تنظیم نشده باشد {{code src/langsmith/utils.py:420-436}} {{code src/langsmith/testing/_internal.py:428-431}} 7.6، 7.7
LANGSMITH_TEST_SUITE نام مخزن و ماژول تست نام دیتاستی که پلاگین pytest می‌سازد {{code src/langsmith/testing/_internal.py:437-448}} 7.7
LANGSMITH_EXPERIMENT ندارد پیشوند نام هر آزمایش در پلاگین pytest، که به دنبال آن یک دونقطه و 8 نویسه‌ی هگزادسیمال تصادفی می‌آید {{code src/langsmith/testing/_internal.py:428-432}} 7.7
LANGSMITH_TEST_TRACKING ندارد، که یعنی ثبت نتایج روشن می‌ماند مقدار false تست‌های علامت‌گذاری‌شده برای لنگ‌اسمیت را بدون ثبت اجرا می‌کند. این کار LANGSMITH_TRACING را خاموش نمی‌کند و اجراهای درون یک تست کماکان ارسال می‌شوند. اگر ثبت نتایج روشن باشد، هر فراخوانی log_* خطا صادر می‌کند، مگر اینکه LANGSMITH_TRACING برابر true باشد {{code src/langsmith/utils.py:143-145}} 7.7
LANGSMITH_TEST_CACHE ندارد پوشه‌ای که پلاگین تست، فراخوانی‌های API خود را در آن کش می‌کند {{code src/langsmith/utils.py:513}} 7.7
LANGCHAIN_CALLBACKS_BACKGROUND ندارد مستندات می‌گویند مقدار false باعث معطل ماندن کال‌بک‌ها می‌شود. ما در نسخه‌ی 1.8.0 کتابخانه‌ی langchain-core یا نسخه‌ی 0.14.17 کتابخانه‌ی langsmith ردی از خوانده شدن آن پیدا نکردیم. ابزار langgraph-cli آن را به عنوان یک نام رزروشده برای دستور deploy خود فهرست می‌کند، و langgraph-api برای ورکر JS خود آن را روی true قرار می‌دهد فقط مستندات، و {{code libs/cli/langgraph_cli/deploy.py:76}} (خط 76 در ساختار مخزن، خط 71 در بسته‌ی ویل نسخه‌ی 0.4.43) {{code langgraph_api/js/remote.py:119}} 7.6

ردگیری محاسبات سه کلید دارد که اولویتشان از این متغیرها بیشتر است: ابتدا tracing_context، سپس یک درخت اجرای فعال، و بعد یک تنظیم سراسری بررسی می‌شود {{code src/langsmith/utils.py:119-140}}. بخش 7.6 ترتیب آن‌ها را آورده است.

Agent Server و رابط خط فرمان آن

متغیر مقدار پیش‌فرض عملکرد محل خواندن بخش
N_JOBS_PER_WORKER 10 در مستندات، 1 در langgraph dev تعداد اجراهایی که یک ورکر صف به‌طور هم‌زمان انجام می‌دهد مستندات، و مقدار پیش‌فرض langgraph dev {{code langgraph_api/cli.py:273}} 8.1
LANGGRAPH_CLOUD_LICENSE_KEY ندارد لایسنس سرورِ حاصل از langgraph up برای محیط عملیاتی گزارش ثبت‌شده در T15-agent-server-x86/08-up-start-excerpt.txt 8.1
LANGSMITH_API_KEY ندارد روش دیگر برای راه‌اندازی langgraph up جهت توسعه‌ی محلی گزارش ثبت‌شده در T15-agent-server-x86/10-up-license-excerpt.txt 8.1
DISABLE_TRUSTSTORE ندارد مقدار true مانع از تزریق truststore به لایه‌ی SSL توسط langgraph-api می‌شود؛ در نتیجه سرور گواهی‌ها را بدون مخزن گواهی‌های مورد اعتماد سیستم‌عامل بررسی می‌کند {{code langgraph_api/server.py:11-17}} 8.1
LANGGRAPH_HOST_API_KEY ندارد کلید مربوط به langgraph deploy، که قبل از LANGSMITH_API_KEY و LANGCHAIN_API_KEY خوانده می‌شود {{code libs/cli/langgraph_cli/deploy.py:96-100}} (خطوط 96 تا 100 در ساختار مخزن، 91 تا 95 در بسته‌ی ویل نسخه‌ی 0.4.43) 8.1

مستندات حد بازگشت سرور را 10011 اعلام می‌کنند و نسخه‌ی 0.18.0 از langgraph-api نیز همین مقدار را تنظیم می‌کند {{code langgraph_api/utils/config.py:44}}. با این حال، اجرای ما زیر langgraph dev همچنان در 10007 متوقف شد، همان‌طور که بخش 8.1 نشان می‌دهد. لاگ آزمون این اعداد را با شناسه‌ی D105 ثبت کرده است.

کیت ثبت خروجی (Capture Kit)

اسکریپت capture/run.py پیش از اجرای هر سناریو، یک محیط ثابت را مقداردهی می‌کند.

متغیر نحوه‌ی عملکرد کیت
تمام متغیرهای با پیشوند LANGSMITH_، LANGCHAIN_، LANGGRAPH_، OPENAI_، ANTHROPIC_، LC_ و همچنین OLLAMA_HOST آن‌ها را حذف می‌کند
LANGSMITH_TRACING مقدار آن را برابر false می‌گذارد
TZ مقدار آن را برابر UTC می‌گذارد
PYTHONHASHSEED خودش را دوباره با مقدار 0 اجرا می‌کند
LANGCHAIN101_PYTHON آن را به‌عنوان مفسر پایتون با بسته‌های نسخه‌بندی‌شده می‌خواند

این کیت متغیرهای LANGGRAPH_ را حذف می‌کند؛ زیرا تعیین حد بازگشت در شل، خروجی‌های ثبت‌شده را تغییر می‌داد.

منابع: libs/langgraph/langgraph/_internal/_config.py، libs/checkpoint/langgraph/checkpoint/serde/_msgpack.py، libs/checkpoint/langgraph/checkpoint/serde/encrypted.py، و libs/cli/langgraph_cli/deploy.py در langgraph 1.2.22؛ libs/core/langchain_core/language_models/chat_models.py و libs/core/langchain_core/utils/_gateway.py در langchain-core 1.8.0؛ libs/langchain_v1/langchain/chat_models/base.py در langchain==1.5.0؛ src/langsmith/utils.py و src/langsmith/testing/_internal.py در langsmith 0.14.17؛ langgraph_api/cli.py، langgraph_api/utils/config.py، langgraph_api/server.py، و langgraph_api/js/remote.py در langgraph-api 0.18.0؛ capture/run.py، capture/README.md؛ capture/lab/summary/pytest-plugin-x86.json، capture/lab/summary/langsmith-account-mac.json؛ capture/lab/T15-agent-server-x86/08-up-start-excerpt.txt، capture/lab/T15-agent-server-x86/10-up-license-excerpt.txt؛ docs.langchain.com در commit مستندات به شناسه‌ی 04d4d4a (بخش‌های langsmith/trace-with-langchain، langsmith/agent-server-scale، langsmith/env-var-cloud).

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