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

О чём урок

Большая часть интернета работает на RESTful API. Предоставление GPT возможности вызывать их открывает мир новых возможностей. Этот notebook демонстрирует, как GPT могут быть использованы для интеллектуального вызова API. Он использует спецификации OpenAPI и chained function calls. Спецификация OpenAPI (OAS) является общепринятым стандартом для описания деталей RESTful API в формате, который машины могут читать и интерпретировать. Она позволяет как людям, так и компьютерам понимать возможности сервиса и может быть использована, чтобы показать GPT, как вызывать API. Этот notebook разделён на две основные части: Как преобразовать пример спецификации OpenAPI в список определений функций для chat completions API. Как использовать chat completions API для интеллектуального вызова этих функций на основе инструкций пользователя. Мы рекомендуем ознакомиться с function-calling перед продолжением. Пример спецификации OpenAPI, который мы используем здесь, был создан с помощью gpt-4. Мы преобразуем эту примерную спецификацию в набор определений функций, которые могут быть переданы chat completion API. Модель, основываясь на предоставленных инструкциях пользователя, генерирует JSON-объект, содержащий необходимые аргументы для вызова этих функций. Прежде чем продолжить, давайте рассмотрим эту сгенерированную спецификацию. Спецификации OpenAPI включают детали о конечных точках API, поддерживаемых ими операциях, принимаемых параметрах, обрабатываемых запросах и возвращаемых ответах. Спецификация определена в формате JSON. Конечные точки в спецификации включают операции для: Перечисления всех событий Создания нового события Получения события по ID Удаления события по ID Обновления имени события по ID Каждая операция в спецификации имеет operationId, который мы будем использовать в качестве имени функции при парсинге спецификации в определения функций. Спецификация также включает схемы, которые определяют типы данных и структуры параметров для каждой операции. Вы можете увидеть схему здесь: Теперь, когда у нас есть хорошее понимание спецификации OpenAPI, мы можем приступить к её парсингу в определения функций.

План урока

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