Учетные данные для интеграций

Когда вы создаете интеграцию с LLM, каналом или другим внешним сервисом, то вы можете использовать свои учетные данные для аутентификации.

В Agent Platform есть специальное хранилище для ваших паролей, токенов и логинов — раздел Учетные данные. Чтобы перейти в него, откройте проект и выберите раздел на левой панели.

Раздел позволяет:

• Безопасно хранить данные

  Учетные данные не будут видны в явном виде в блоках или коде.

• Легко использовать данные

  Если вы добавили данные в хранилище, то сможете выбирать их в настройках интеграций или получать в процессах с помощью встроенной функции Credentials.get.

Управление учетными данными

Добавление

1. Нажмите Добавить.

2. Выберите тип учетных данных. Набор данных отличается в зависимости от типа.

   примечание

   Каждая интеграция поддерживает один определенный тип учетных данных:

   • Например, если вы хотите настроить интеграцию с LLM, то вам нужно создать учетные данные типа LLM.

   • Если подходящей встроенной интеграции нет, выберите тип Другое. Далее напишите свою функцию для обращения к внешнему сервису и используйте в ней учетные данные с помощью Credentials.get.

   • Данные типа Провайдер ASR/TTS можно использовать как для ASR, так и для TTS. Если у вас провайдеры ASR и TTS разные, создайте по одному набору учетных данных для каждого провайдера.

3. Укажите нужные данные и настройте срок действия.

4. Нажмите Добавить.

Редактирование

1. Нажмите в таблице с вашими учетными данными.
2. Внесите изменения.
3. Нажмите Сохранить.

Во всех связанных интеграциях сразу будут использоваться новые данные. Также обновленные данные будет возвращать Credentials.get.

Удаление

1. Нажмите в таблице с вашими учетными данными.
2. Подтвердите удаление.

предупреждение

Связанные интеграции сразу перестанут работать — это может привести к ошибкам в процессах.

Как использовать

Выбор данных во встроенных интеграциях

Сохраненные учетные данные можно выбрать в двух местах:

• В разделе Интеграции при подключении нового сервиса.
• Прямо в процессе — например, при настройке LLM в блоке Агент.

В обоих случаях вам не придется вводить токен или ключ API вручную — просто выберите нужные данные из выпадающего списка.

Подключение к любому другому сервису

Например, вы хотите, чтобы ваш бот мог сообщать погоду, используя сторонний сервис WeatherAPI.com. Однако встроенной интеграции с этим сервисом в Agent Platform нет и вам нужно обращаться к нему напрямую по API.

Для таких задач используйте функцию Credentials.get. Она позволяет безопасно получить сохраненный API-ключ прямо в коде и использовать его для отправки запросов.

Шаг 1: Сохраните API-ключ

1. Зарегистрируйтесь на WeatherAPI.com и получите бесплатный API-ключ.
2. В Agent Platform перейдите в раздел Учетные данные.
3. Добавьте новые учетные данные с типом Другое и авторизацией по токену. В поле Токен вставьте ваш API-ключ.
4. Новые учетные данные появятся в таблице в разделе Учетные данные. Скопируйте ID из таблицы. Предположим, что ID выглядит так: 1000111111-weather-abc.

Шаг 2: Напишите функцию для запроса погоды

Теперь вы можете написать простую функцию, которая будет обращаться к API погоды. В ней используйте Credentials.get, чтобы безопасно получить ключ. Вот как будет выглядеть код:

async function getWeather({ city }) {
    // Получаем объект с учетными данными по ID из таблицы
    const credentials = Credentials.get('1000111111-weather-abc');

    // Формируем запрос
    const requestConfig = {
        url: 'https://api.weatherapi.com/v1/current.json',
        params: {
            // Подставляем токен из наших учетных данных
            key: credentials.token,
            q: city
        }
    };

    // Выполняем запрос с помощью встроенной функции Http.get
    const response = await Http.get(requestConfig);

    // Извлекаем температуру из ответа и возвращаем результат
    return `Температура: ${response.body.current.temp_c}°C`;
}

Таким образом, ваш API-ключ надежно хранится в Agent Platform и не виден в коде функции.