Урок из полного доступа, первые уроки курса бесплатно Официальный курс OpenAI Academy на русском
Урок 24 · Текст · ~5 мин

Вызов функций по спецификации OpenAPI

Урок 24 из 303 курса «OpenAI Cookbook»: официальный курс OpenAI Academy (ОпенАИ) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Большая часть интернета работает на RESTful API. Предоставление GPT возможности вызывать их открывает мир новых возможностей. Этот notebook демонстрирует, как GPT могут быть использованы для интеллектуального вызова API. Он использует спецификации OpenAPI и chained function calls.

Спецификация OpenAPI (OAS) является общепринятым стандартом для описания деталей RESTful API в формате, который машины могут читать и интерпретировать. Она позволяет как людям, так и компьютерам понимать возможности сервиса и может быть использована, чтобы показать GPT, как вызывать API.

Этот notebook разделён на две основные части:

  1. Как преобразовать пример спецификации OpenAPI в список определений функций для chat completions API.
  2. Как использовать chat completions API для интеллектуального вызова этих функций на основе инструкций пользователя.

Мы рекомендуем ознакомиться с function-calling перед продолжением.

Пример спецификации OpenAPI, который мы используем здесь, был создан с помощью gpt-4. Мы преобразуем эту примерную спецификацию в набор определений функций, которые могут быть переданы chat completion API. Модель, основываясь на предоставленных инструкциях пользователя, генерирует JSON-объект, содержащий необходимые аргументы для вызова этих функций.

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

Конечные точки в спецификации включают операции для:

  • Перечисления всех событий
  • Создания нового события
  • Получения события по ID
  • Удаления события по ID
  • Обновления имени события по ID

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

Вы можете увидеть схему здесь:

Теперь, когда у нас есть хорошее понимание спецификации OpenAPI, мы можем приступить к её парсингу в определения функций.

Мы можем написать простую функцию openapi_to_functions для генерации списка определений, где каждая функция представлена в виде словаря, содержащего следующие ключи:

  • name: Это соответствует идентификатору операции…

План урока

  1. Как преобразовать спецификацию OpenAPI в определения функций
  2. Как вызывать эти функции с помощью GPT
  3. Заключение

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы OpenAI 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от OpenAI (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Урок входит в темы

Полезные гиды