При настройке AI-агента используются заданные переменные окружения, определяющие его поведение и параметры интеграции. Актуальные значения заданных переменных прокладываются платформой и автоматически передются при запуске.
Ниже приведена таблица с описанием переменных для AI-агентов.
Переменная | Описание |
|---|---|
PHOENIX_PROJECT_NAME | Имя проекта в Phoenix (ProjectID). Используется для группировки трейсов. |
PHOENIX_ENDPOINT | URL уже созданного экземпляра Phoenix в кластере: https://{domain}/v1/traces. Необходим для отправки и просмотра трейсов агента. |
ENABLE_PHOENIX | Флаг включения сбора трейсов в Phoenix, по умолчанию = True. |
ENABLE_MONITORING | Флаг включения мониторинга, по умолчанию = True. |
AGENT_NAME | Название агента, отображаемое в интерфейсе. Используется в карточке агента. |
AGENT_DESCRIPTION | Описание агента, отображаемое в интерфейсе. Дополняет информацию в карточке агента. |
AGENT_VERSION | Версия агента, по умолчанию v1.0.0. Используется для идентификации версии в интерфейсе. |
EVOLUTION_SERVICE_ACCOUNT_KEY_ID | key_id сервисного аккаунта. Обеспечивает доступ к ML Inference и другим сервисам Evolution. |
EVOLUTION_SERVICE_ACCOUNT_KEY_SECRET | key_secret сервисного аккаунта. Используется для аутентификации в ML Inference и сервисах Evolution. |
LLM_MODEL | Название языковой модели с префиксом hosted_vllm/. Указывает модель, используемую через LiteLLM. Пример: hosted_vllm/Qwen/Qwen3-Coder-480B-A35B-Instruct |
LLM_API_BASE | Базовый URL API для доступа к Foundation Models: https://foundation-models.api.cloud.ru/v1. |
LLM_API_KEY | API-ключ для аутентификации при обращении к Foundation Models. |
EVOLUTION_PROJECT_ID | Идентификатор проекта в Evolution. Используется для привязки ресурсов и управления доступом. |
AGENT_SYSTEM_PROMPT | Системный промпт агента. Определяет его поведение, стиль ответов и выполняемые инструкции. |
URL_AGENT | Автоматически генерируемый URL агента. Формат: https://{{.AgentID}}-agent.ai-agent.inference.cloud.ru |
MCP_URL | Список URL подключенных MCP-серверов, разделенных запятой. Пример: http://example1.com/sse,http://example2.com/sse. Подробнее о формате — в спецификации MCP. |
UV_CACHE_DIR | Каталог для кэширования зависимостей, используемый инструментом uv. |
PIP_CACHE_DIR | Каталог для кэширования пакетов, используемый pip. |
UV_LINK_MODE | Режим связывания зависимостей в uv, например, copy, symlink, hardlink. Определяет способ размещения зависимостей в файловой системе. |