Superglue CLI: Позвольте ИИ-агентам выполнять API-вызовы без предустановленных инструментов

Superglue CLI — это интерфейс командной строки, который поставляется со структурированной справочной информацией, обучающей ИИ-агентов использованию каждой команды sg, работе с аутентификацией, созданию инструментов и отладке сбоев. Основная идея: вместо создания жёстко заданных инструментов для каждой интеграции API, вы указываете агенту на любой API, и он может анализировать этот API во время выполнения, читая спецификацию, планируя вызовы и выполняя их.

Установка и настройка

Установите CLI глобально через npm:

npm install -g @superglue/cli

Запустите интерактивную настройку:

sg init

Это запросит ваш API-ключ (доступен на app.superglue.cloud/admin), конечную точку и предпочтения вывода. Для неинтерактивных сред, таких как CI или ИИ-агенты, установите переменные окружения:

export SUPERGLUE_API_KEY="your-api-key"
export SUPERGLUE_API_ENDPOINT="https://api.superglue.cloud"

Проверьте с помощью sg system list — если вы видите ошибки аутентификации, проверьте ваш API-ключ и конечную точку.

Установка навыка

Навык даёт вашему ИИ-агенту полное знание CLI — команды, шаблоны аутентификации, схемы инструментов, отладку и развёртывание. Установите один раз, и агент будет автоматически обращаться к нему.

Универсальная установка для всех агентов:

npx skills add superglue-ai/cli

Нацельтесь на конкретных агентов с помощью -g -a <agent>:

npx skills add superglue-ai/cli -g -a claude-code
npx skills add superglue-ai/cli -g -a codex
npx skills add superglue-ai/cli -g -a cursor

Для Claude Code установите из маркетплейса Anthropic:

/plugin install superglue@claude-plugins-official

Или загрузите из локальной установки:

claude --plugin-dir $(npm root -g)/@superglue/cli

Для Cursor скопируйте навык в ваш проект или глобальную директорию:

cp -r $(npm root -g)/@superglue/cli/skills/superglue .cursor/skills/superglue
# Или глобально
cp -r $(npm root -g)/@superglue/cli/skills/superglue ~/.cursor/skills/superglue

Что предоставляет навык

• Все команды CLI с флагами, опциями и шаблонами использования
• Шаблоны аутентификации — заполнители учётных данных, потоки OAuth, форматы заголовков
• Схема конфигурации инструментов — конфигурации шагов, селекторы данных, преобразования, пагинация
• Процессы отладки — распространённые ошибки, --include-step-results, sg system call для изоляции
• Шаблоны развёртывания — SDK, REST API, вебхуки (через references/integration.md)
• Специализированные справочники для баз данных, файловых серверов и преобразований (загружаются по требованию)

Добавление контекста для конкретного проекта

Добавьте раздел в файл конфигурации ИИ вашего проекта (CLAUDE.md, AGENTS.md или .cursorrules), чтобы агент знал, что нужно использовать навык и динамически обнаруживать вашу настройку. Включите инструкции, такие как:

## Использование Superglue
При работе с инструментами superglue — через CLI, SDK или REST API:
1. Вызовите навык superglue и прочитайте файл SKILL.md перед запуском любой команды sg
2. Прочитайте соответствующие справочные файлы для задачи (интеграция, базы данных, файловые серверы, преобразования)
3. Убедитесь, что CLI настроен (sg init был запущен или установлены переменные окружения)
4. Запустите sg system list и sg tool list, чтобы обнаружить текущую настройку перед созданием или изменением чего-либо
5. Никогда не жёстко задавайте идентификаторы систем или инструментов — всегда обнаруживайте их динамически

Лучшие практики

Всегда тестируйте системы перед созданием инструментов. Попросите агента запустить sg system call, чтобы проверить аутентификацию и увидеть фактическую форму ответа перед созданием конфигурации инструмента:

sg system call --system-id stripe \
  --url "https://api.stripe.com/v1/customers?limit=2" \
  --headers '{"Authorization":"Bearer <>"}'

Используйте --include-step-results при отладке, чтобы показать необработанный ответ API от каждого шага — определяет, является ли проблема аутентификацией, конечной точкой или преобразованием:

sg tool run --draft <id> --payload '{}' --include-step-results

Никогда не вставляйте секреты в чат. Используйте --sensitive-credentials при создании систем через CLI, чтобы секреты запрашивались безопасно.

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