Интеграции и окружение

Подключение внешнего сервиса

Откройте Integrations внутри проекта, чтобы увидеть каталог, включённый администратором Amazi. Подключение принадлежит всему проекту, а не одному чату или приложению. Для создания, замены и просмотра защищённых значений нужны Full access или права владельца. Просмотр каталога доступен без функции встроенных интеграций; для открытия сведений об управляемой интеграции и подключения нужна эта функция тарифа владельца проекта. Ограничение не запрещает агенту разрабатывать код приложения. Использование внешнего сервиса по-прежнему требует доступа к нему и рабочего подключения.

Выберите All или вкладку группы, чтобы отфильтровать каталог. Рядом с названием каждой группы показана иконка в заданном для неё цвете.

В шапке интеграции показаны логотип, название и статус подключения. Под названием перечислены группы через запятую; если группы нет, отображается Другие интеграции. Стрелка назад возвращает в каталог. У подключённого сервиса кнопка Отключить находится в шапке, а Обновить подключение — возле формы с данными. Отключение требует подтверждения и не меняет код приложения автоматически.

Вводите данные только в форме интеграции. Amazi хранит их вне чата и передаёт агенту названия переменных, статус и инструкции, но не сохранённые секреты. Если активной задаче не хватает подключения, она может приостановиться и показать ту же защищённую форму. После подключения участником с нужными правами Amazi согласует runtime разработки и продолжит задачу.

Подключение или пропуск интеграции появляется в сводке работы чата. Там же сохраняется результат защищённого запроса переменных окружения: сохранение или пропуск. История показывает названия и результат действия без секретных значений.

Чтобы указать сервис в запросе, введите @ в чате проекта и выберите его из списка интеграций. Подключённые сервисы идут первыми и отмечены меткой. Упоминание вставляет название в черновик; подключение выполняется отдельно. Подробнее — в разделе Агент и чат.

Раскройте панель интеграции в чате, введите доступные значения и нажмите Подключить под полями или выберите Пропустить, чтобы продолжить без подключения. Пустые значения можно заполнить позже в настройках интеграции. При открытии другой панели действий эта панель сворачивается, а введённые значения сохраняются.

Запросы интеграций и окружения оформлены одинаково: один заголовок и описание, затем все запрошенные поля ввода. В пустом поле подсказкой показано имя переменной окружения.

В запросе переменных окружения все поля показаны вместе, без шагов и счётчика прогресса. Введите значения и нажмите Сохранить, чтобы отправить всю форму, или Пропустить, чтобы оставить все запрошенные переменные без изменений. Сохранение пустого поля задаёт переменной пустое значение. При сворачивании панели черновик сохраняется. Кнопки сохранения, подключения и пропуска остаются видны внизу открытой секции при прокрутке.

Для Яндекс Метрики нужен OAuth-токен доступа, отдельный от Client ID и Client secret. Перейдите по ссылке получения токена из инструкции интеграции под аккаунтом с доступом к счётчику. Существующий токен заменяйте через «Обновить подключение», затем попросите Amazi проверить доступные счётчики.

Раздел Environment

Environment объединяет:

• пользовательские значения проекта;
• переменные интеграций;
• управляемые значения платформы.

Участники с правом просмотра видят названия и источники. Раскрывать и менять защищённые значения могут только роли с управлением окружением. Переменные интеграции редактируются в своём подключении и не дублируются как ручные. В Environment нажмите кнопку с глазом рядом с фиксированным значением, чтобы раскрыть его. Текущий DATABASE_URL приложения — владельца управляемой базы раскрывается той же кнопкой, когда значение доступно. Изначально значения скрыты; после раскрытия они по-прежнему недоступны для редактирования. Пустые или недоступные фиксированные значения отображаются как пустые поля, без подставных точек.

Amazi может самостоятельно привязать переменную уже подключённой интеграции к приложениям, не раскрывая и не меняя её значение. Попросите обновить список приложений для переменной; копировать токен вручную или редактировать значения интеграции для этого не требуется.

Для каждой пользовательской переменной, переменной интеграции, Gateway и Voice явно выбираются приложения. Переменную получают только выбранные приложения — в development и в следующем production-релизе. Vite открывает браузерному коду только имена с VITE_; Amazi не переименовывает переменные. Управляемые runtime-секреты существуют отдельно: подходящие серверные приложения получают credentials хранилища, а DATABASE_URL получает только владелец управляемой базы.

У каждой пользовательской переменной и переменной интеграции одно значение для Preview и опубликованных приложений. В существующих проектах общими становятся прежние production-значения, в том числе пустые. Отдельные значения разработки больше не используются. Выбор приложений сохраняется.

Когда применяются изменения значений

Изменение переменной согласуется с сохранённым runtime разработки. Активный production-релиз продолжает использовать снимок окружения своей сборки, поэтому для новых значений опубликуйте обновление всего проекта. При этом Amazi не переписывает принадлежащие проекту env-файлы. Amazi AI Gateway настраивается отдельно.

Доступные интеграции