Скилл GetAPI
Инструкции для ИИ-агента, который создаёт и проверяет интеграции
Установка
Создайте папку getapi в каталоге скиллов вашего агента и файл SKILL.md внутри неё
Добавьте в начало файла метаданные
--- name: getapi description: Создание и исправление интеграций с GetAPI, настройка SDK, моделей, потоков, инструментов и мультимодальных запросов ---
Ниже разместите инструкции из следующего раздела. Ссылки справочника сохраните как полные адреса с префиксом https://getapi.ru, чтобы агент мог открыть их вне сайта
Для проекта без механизма скиллов используйте блок для AGENTS.md или CLAUDE.md
Инструкции скилла
Используй этот скилл при создании и исправлении интеграций с GetAPI, настройке совместимых SDK, работе с моделями, потоковыми ответами, инструментами и мультимодальным вводом
Подключение
Базовый адрес https://api.getapi.ru, для OpenAI SDK https://api.getapi.ru/v1
Ключ считывай из GETAPI_API_KEY. Не записывай его в исходники, инструкции, URL, логи и сообщения
Сохраняй выбранные пользователем модель, формат и параметры. Точный ID получай из GET /v1/models, не конструируй имя по названию провайдера
Порядок работы
- Определи используемый клиент и нужные возможности
- Прочитай соответствующий справочный раздел
- Внеси минимальные изменения подключения
- Проверь структуру запроса и обработчик ответа
- При разрешённом API-вызове проверь реальный сценарий, включая завершение и ошибки
Запрос каталога не запускает генерацию. Платный вызов выполняй только в пределах поручения пользователя, не запускай массовые проверки по собственной инициативе
Справочные разделы
- Модели, точные ID и проверка доступности
- Форматы, адреса, тела запросов и схемы ответа
- Поток, события, дельты и завершение
- Инструменты, полный цикл вызова
- JSON, schema и проверка результата
- Рассуждения, параметры и бюджет
- Изображения, base64, URL и документы
- Эмбеддинги, индексы и размерность
- Ошибки, диагностика и безопасные повторы
Критерии результата
HTTP 200, первый фрагмент потока и непустой текст не доказывают корректность всей интеграции
Для tools проверь выполнение функции и возврат результата с исходным ID. Для JSON проверь разбор и схему. Для потока проверь штатное завершение
Возможности зависят от модели и маршрута. Не копируй гарантии исходного провайдера в описание GetAPI и не объявляй неизвестный параметр поддерживаемым по одному успешному HTTP-ответу
Сохраняй полезные дополнительные поля, если они нужны приложению, но не делай необязательные поля обязательными
Границы изменений
Не меняй модель, тариф, глобальные настройки клиента и политику повторов без необходимости для задачи
После таймаута операции с побочным эффектом сначала установи, была ли она выполнена. Не повторяй оплату, отправку сообщения или создание задания вслепую