Коротко: Учётные данные для подключения к внешним сервисам (Telegram, почта, LLM-провайдеры, API с авторизацией) настраиваются один раз как отдельная сущность платформы и затем используются в задачах сценария — не нужно вставлять токены и ключи вручную в каждый шаг логики.
Любая интеграция с внешним сервисом требует какой-то формы авторизации — токена, ключа или пары логин-пароль. Хранить эти данные разрозненно, прямо внутри логики каждого сценария, неудобно и небезопасно. Вместо этого подключения настраиваются один раз и переиспользуются там, где нужны.
Какие типы подключений есть на платформе
| Тип подключения | Для чего используется |
|---|---|
| Telegram Bot API | Отправка и приём сообщений через Telegram-бота |
| SMTP | Отправка почтовых уведомлений через email |
| HTTP Header Auth | Авторизация для произвольных REST-вызовов к внешним API |
| OpenAI API | Вызов моделей OpenAI внутри LLM-задач сценария |
| YandexGPT API | Вызов YandexGPT внутри LLM-задач сценария |
Каждый тип подключения соответствует конкретному способу авторизации, который требует внешний сервис — где-то это простой токен, где-то пара ключ+идентификатор каталога, где-то произвольный заголовок запроса.
Зачем хранить подключения отдельно от сценария
- Один и тот же Telegram-токен может использоваться в нескольких сценариях без дублирования настройки
- При смене ключа API достаточно обновить его в одном месте, а не искать все сценарии, где он использовался
- Учётные данные не разбросаны по логике диалога, что снижает риск случайно раскрыть их при экспорте или демонстрации сценария
Как это работает на практике
Настройка подключения — отдельный шаг перед тем, как задача сценария (например, REST-вызов или отправка сообщения в Telegram) сможет им воспользоваться. Задача в сценарии просто ссылается на уже настроенное подключение, не требуя повторного ввода токена или ключа при каждой новой задаче.
Что выбрать для конкретной интеграции
Если интеграция — это отправка сообщений через Telegram-бота, нужен Telegram Bot API. Если нужен произвольный REST-вызов к системе с собственной авторизацией (не входящей в готовый список типов), подходит HTTP Header Auth — универсальный способ передать заголовок авторизации в запросе. Если задача требует вызова языковой модели, нужен соответствующий тип подключения к конкретному провайдеру.
Настроить нужные подключения можно в конструкторе Aigine отдельно от логики сценария, а затем использовать их в любом количестве задач.
Настройте подключения для своих интеграций
Опишите, какие внешние сервисы нужны сценарию — платформа Aigine поможет настроить подключения без дублирования учётных данных.
Частые вопросы
Можно ли использовать одно подключение в нескольких сценариях?
Да, подключение настраивается один раз и может использоваться в любом количестве сценариев и задач, где оно требуется.
Что делать, если нужного типа подключения нет в списке?
Для произвольной авторизации через HTTP-заголовок подходит тип HTTP Header Auth — он покрывает широкий спектр внешних API, даже без отдельного специализированного типа.
Где хранятся учётные данные подключений?
Уточняйте актуальные детали хранения и безопасности в документации платформы — конкретная реализация может отличаться в зависимости от типа подключения.
Нужно ли пересоздавать сценарий при смене токена?
Нет, достаточно обновить сам токен в настройках подключения — сценарии, которые на него ссылаются, продолжат работать с новым значением автоматически.