Обзор

В этой статье объясняется, как настраивать действия в GPT, включая подключение к внешним API, определение возможностей GPT, а также управление аутентификацией, схемами и ограничениями рабочей области.

Чтобы настроить действие, вам понадобятся данные API для сервиса, который вы хотите подключить, включая сведения об аутентификации и схему OpenAPI. GPT может использовать либо приложения, либо действия, но не то и другое одновременно.

Каждое действие определяется двумя основными компонентами: тем, как GPT проходит аутентификацию в API, и схемой, которая определяет возможности API.

Ограничения

Если ваша рабочая область допускает ноль доменов действий, пользовательские действия GPT не смогут выполняться, потому что ни один домен действий не пройдет проверку по списку разрешенных. Это не обязательно означает, что вся видимость GPT или доступ к ним заблокированы.

Действия недоступны для режима Pro. Когда вы создаете или редактируете GPT с пользовательскими действиями, в селекторе моделей отображаются только модели не Pro, поддерживающие действия.

Переход на плагины

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

Создание действия

В редакторе GPT перейдите в раздел «Действия» и выберите «Создать новое действие».

Затем настройте подключение GPT к внешнему API и его использование.

После настройки протестируйте действие в разделе «Предпросмотр», чтобы убедиться, что оно работает как ожидается.

Аутентификация

Аутентификация определяет, как ваш GPT подключается к внешнему API.

Доступные варианты:

• Нет: аутентификация не требуется

• Ключ API: использует секретный ключ для авторизации запросов

• OAuth: использует вход пользователя для доступа на основе учетной записи

Ключ API

Используйте аутентификацию по ключу API для доступа «сервер — сервер». Ее можно настроить как:

• Basic

• Bearer

• Пользовательский заголовок

OAuth

Используйте OAuth, когда действия требуют учетных записей пользователей. Для OAuth требуется:

• Идентификатор клиента и секрет клиента

• URL авторизации и URL токена

• Область действия и метод обмена токенами

Редактор предоставляет URL обратного вызова для завершения потока OAuth.

Схема

Схема определяет, что может делать ваш API. Она сообщает ChatGPT:

• Какой сервер вызывать

• Какие конечные точки доступны

• Какие параметры они принимают

• Как идентифицируется каждое действие (идентификаторы операций)

Схема должна быть предоставлена как спецификация OpenAPI в формате JSON или YAML.

Добавить схему

Вы можете добавить схему тремя способами:

• Вставить ее непосредственно в редактор

• Импортировать ее из URL

• Начать со встроенного примера:

  • Погода (JSON)

  • Зоомагазин (YAML)

  • Пустой шаблон

Если схема действительна, редактор показывает обнаруженные действия. Если она недействительна, отображаются ошибки проверки.

Ограничения рабочей области (Enterprise и Edu)

Если вы видите сообщение:


«Настройки вашей рабочей области не разрешают ни одного домена».

Это означает, что действия ограничены настройками вашей рабочей области.

• Администраторы могут разрешить все домены или ограничить действия только утвержденными доменами.

• Если домены не разрешены, вы не можете использовать действия.

Сведения об элементах управления действиями и ограничениями доменов на уровне рабочей области см. в статье: Управление доступом к GPT в рабочих областях Enterprise и Edu.

Конфиденциальность и пользовательские элементы управления

• Каждое действие может включать URL политики конфиденциальности.

• Публичные GPT (по ссылке или в GPT Store) с действиями должны включать действительный URL политики конфиденциальности.

• Пользователям может быть предложено одобрить действия перед их запуском.

• Для действий OAuth пользователи могут просматривать подключенные учетные записи и управлять ими.

Дополнительная помощь

Чтобы получить помощь в написании или отладке действий, используйте официальный ActionsGPT.