این صفحه 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).