Огляд

У цій статті пояснюється, як налаштовувати дії в 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)

  • Pet Store (YAML)

  • Порожній шаблон

Якщо схема дійсна, редактор показує виявлені дії. Якщо вона недійсна, відображаються помилки перевірки.

Обмеження робочого простору (Enterprise і Edu)

Якщо ви бачите повідомлення:


«Налаштування вашого робочого простору не дозволяють жодних доменів».

Це означає, що дії обмежено налаштуваннями вашого робочого простору.

• Адміністратори можуть дозволити всі домени або обмежити дії лише затвердженими доменами.

• Якщо жодні домени не дозволено, ви не можете використовувати дії.

Щоб дізнатися про елементи керування діями та обмеженнями доменів на рівні робочого простору, див.: Керування доступом до GPT у робочих просторах Enterprise і Edu.

Конфіденційність і елементи керування користувача

• Кожна дія може містити URL-адресу політики конфіденційності.

• Загальнодоступні GPT (за посиланням або в GPT Store) з діями мають містити URL-адресу чинної політики конфіденційності.

• Користувачів можуть попросити схвалити дії перед їх виконанням.

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

Додаткова допомога

Щоб отримати допомогу з написанням або налагодженням дій, використовуйте офіційний ActionsGPT.