Интеграции

Интеграции связывают проект с внешними сервисами: например AI, ботами, email или другими каналами. Agnostic показывает понятный статус подключения и скрывает чувствительные значения.

OAuth/OIDC-способы входа пользователей приложения настраиваются отдельно в разделе Авторизация → Способы входа и не отображаются в этом списке.

• Нужно добавить внешний сервис в приложение.
• Нужно использовать сервис в автоматизации.
• Нужно проверить, какое подключение требует внимания.

• Подготовьте данные доступа к внешнему сервису.
• Убедитесь, что используете защищенную форму Agnostic, а не вставляете приватные значения в код.
• Управлять подключениями могут администратор и разработчик проекта, а также

владелец и администратор организации. Остальные участники могут просматривать подключения.

1. Откройте раздел «Подключения» и выберите окружение в навигации проекта.
2. Нажмите «Подключить сервис» и выберите провайдера. Если сервис ещё не

подключён в этом окружении, его также можно выбрать в блоке «Добавить сервис» под списком действующих подключений.

1. В форме выберите окружение: «Продакшен», «Тестирование» или «Разработка».
2. Сохраните подключение.
3. Откройте подключение в списке «Ваши подключения» и нажмите «Проверить».
4. Используйте интеграцию в приложении или автоматизации.

В одном центре доступны OpenAI, Anthropic, Gemini, OpenRouter, Telegram Bot, Telegram Inbound, WhatsApp, Resend и Object Storage для файлов. Если в выбранном окружении уже есть подключения, они появляются над каталогом. Откройте строку, чтобы проверить, переименовать, приостановить или удалить подключение. Если подключений пока нет, на их месте появится подсказка для первого шага. Категории «Библиотеки» и поиск помогают найти нужный сервис. Сервисы показаны с их узнаваемыми логотипами, а Object Storage — с нейтральным значком типа подключения.

Подключение провайдеров и собственных доменов не зависит от старого тарифа.

AI-провайдер

1. Выберите OpenAI, Anthropic, Gemini или OpenRouter.
2. Укажите имя, окружение, модель по умолчанию и API-ключ в защищённом поле.
3. Сохраните и проверьте подключение.
4. В редакторе автоматизации добавьте «Спросить AI» и выберите это подключение.
5. При необходимости укажите другую модель прямо в узле и добавьте

«Структурированный ответ» перед записью результата в Data или вызовом другого сервиса.

Во время запуска Agnostic использует подключение только из окружения сценария. При настройке через Developer tools можно сохранить числовой лимит длины ответа AI от 1 до 128 000 токенов в открытых настройках подключения. У выбранной модели может быть меньший предел. Узел автоматизации использует этот лимит, если в нём не задан свой. Для короткой классификации ограничивайте ответ размером ожидаемого JSON; слишком короткий лимит может обрезать ответ, поэтому проверяйте структуру перед записью данных.

Результат содержит текст ответа, модель и безопасную статистику токенов; ключ провайдера не попадает в схему, историю или вывод шага. Если AI вернул JSON, Agnostic подготовит его для следующего шага, но перед важным действием всё равно проверяйте структуру отдельным узлом.

Telegram-бот

1. Создайте бота через BotFather и скопируйте выданный токен.
2. В разделе Подключения выберите Telegram и создайте подключение бота.
3. Вставьте токен только в защищённое поле и сохраните подключение. Не добавляйте токен в название, описание, чат или поля автоматизации.
4. Если проверка доступна, проверьте подключение до добавления узлов.
5. В редакторе автоматизации добавьте Событие Telegram для входящих событий или Telegram для действия и выберите сохранённое подключение. Редактор показывает только подключения выбранного окружения.

Узел Telegram использует выбранное подключение для отправки и изменения сообщений, ответа на callback, отправки фото и документов, показа действия в чате и получения файла.

Узел Событие Telegram принимает входящие обновления через webhook. Для него нужна отдельная webhook-привязка автоматизации с тем же адресным именем и секретом длиной 1–256 символов из латинских букв, цифр, _ и -. Публичный адрес нужно зарегистрировать в Telegram самостоятельно, передав тот же секрет как параметр secret_token метода setWebhook. Сохранение подключения, добавление узла и публикация сценария пока не выполняют эту регистрацию автоматически. Для этого узла выбирайте подключение Telegram-бота; входящее системное подключение резервирует собственный маршрут и пока не поддерживается узлом сценария.

Строка интеграции покажет статус «Подключено» или «Приостановлено». Если проверка не прошла, откройте подключение и посмотрите результат. Автоматизация видит только выбранное подключение; сохранённый токен Telegram и другие приватные значения не возвращаются в редактор узлов, тестовые данные или историю запусков.

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

Для Telegram-бота агент сначала откроет защищенную форму для токена, затем подготовит сохранение секрета, создание интеграции и проверку подключения. Не отправляйте токен бота сообщением в чат.

Для Email / Resend агент работает так же: ключ Resend вводится только в защищенной форме, а в чат возвращаются только безопасные настройки отправителя и результат проверки.

Для LLM-провайдеров OpenAI, Anthropic Claude, Gemini и OpenRouter агент может сохранить ключ через защищенную форму, создать интеграцию с безопасной настройкой модели и запустить проверку подключения. Сам ключ после сохранения не показывается.

Для Object Storage агент использует тот же безопасный поток: endpoint, регион, bucket и prefix могут быть обычными настройками, а данные доступа вводятся только через защищенную форму. После сохранения агент показывает только ссылку на подключение и безопасный результат проверки, без значений доступа.

Локальный агент работает по тому же правилу. После отдельного подтверждения в браузере он может открыть форму подключения с уже выбранными сервисом и окружением, но не создаёт секрет заранее. Введите ключ только в поле этой формы. Идентификатор защищённого ввода, зашифрованное значение и ссылка на секрет не возвращаются в CLI или MCP.

Существующее подключение локальный агент может переименовать, включить, выключить или обновить его открытые настройки после подтверждения. Для этого используется логическая ссылка вида integration.<название> из актуального контекста; внутренний идентификатор и данные доступа агенту не показываются.

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

Если Agent сообщает, что прежнее подтверждение больше не подходит для отключения, попросите подготовить действие заново и подтвердите новую карточку. До этого подключение сохраняет своё состояние.

В «Подключениях» нажмите «Подключить сервис» → «HTTP API». Можно создать несколько подключений одного типа: например, «API бота» и «CRM API». Каждое принадлежит выбранному окружению и хранит свои учётные данные.

Укажите название, окружение и адрес сервиса, например https://bot.example.com. Адрес содержит только протокол, домен и порт, без пути. Выберите авторизацию:

• Секрет в заголовке — имя заголовка, например X-Bot-Secret, и секрет.
• Bearer token — токен; префикс Bearer добавится автоматически.
• Basic — имя пользователя и пароль; оба сохраняются как учётные данные.

Для секрета в заголовке и Bearer token используйте значение, выданное сервисом, без переводов строк и управляющих символов. Кириллица, эмодзи и другие символы, которые нельзя передать в HTTP-заголовке, вызовут ошибку при сохранении. Для нового собственного секрета подходят латинские буквы, цифры и знаки ASCII. Имя пользователя и пароль Basic могут содержать кириллицу: они кодируются перед отправкой.

«Путь проверки», например /health, должен принимать безопасный GET-запрос с авторизацией и возвращать 2xx. Ключ после сохранения не показывается. Чтобы заменить его, откройте подключение → «Изменить» → «Новый секрет» или «Новый пароль». Пустое поле сохраняет прежние данные; при смене адреса сервиса или способа авторизации введите новые.

В ноде «HTTP-запрос» выберите сохранённое подключение и полный URL, например https://bot.example.com/reminders. Домен, протокол и порт должны совпадать с адресом подключения. Секрет подставляется сервером только при отправке запроса. Настройка «Без авторизации» подходит для открытых API.

Бот проверяет выбранный заголовок или авторизацию по секрету, сохранённому в его серверных переменных. Например, для X-Bot-Secret сравните значение заголовка с BOT_AUTOMATION_SECRET на сервере и возвращайте 401 при несовпадении. Agnostic не назначает боту собственную скрытую авторизацию. Не передавайте секрет в URL или теле запроса и не возвращайте его в ответе.

• Ключи и переменные
• Что такое автоматизация

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

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

В карточке можно проверить сервис, изменить конфигурацию, приостановить или удалить подключение. Новый ключ заменяет прежний через API провайдера подключений. Для MAX сначала приостановите подключение и откройте форму снова. При изменении HTTP-адреса или способа авторизации потребуется новый credential. Для Basic вводится JSON с username и password в защищённое поле; значение не показывается после сохранения.

Если исход неизвестен, нажмите «Восстановить ту же операцию». Приложение читает её состояние и не отправляет изменение повторно. «Проверка пропущена сервером» не подтверждает доступ к сервису. Проверка Object Storage показывает доступность endpoint; для реального использования отдельно проверьте выбранный бакет в задаче.

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