← Каталог

· AI Engineer World's Fair 2026

Проектирование CLI для agents, а не для людей

Designing CLIs for Agents, Not Humans — Pedro Lopez, Airbyte

Интерфейсы для агентов лучше строить как тонкую обёртку над API с OpenAPI-спецификацией, а CLI проектировать под агентов, а не под людей.

  • Два инструмента вместо десятков — MCP-сервер Airbyte отдаёт describe для схемы коннектора и execute для чтения, записи и удаления записей. Возможности открываются постепенно, а описания инструментов короткие, чтобы не забивать контекст агента.
  • OAuth и долгие сессии — клиенты MCP почти всегда ждут OAuth, Bearer-токен в кастомных коннекторах не задать. Сессии должны жить долго и храниться отдельно от веб-приложения, а URL elicitation поддерживается клиентами непоследовательно, поэтому Airbyte использует собственные ссылки для подключения сервисов.
  • JSON и единообразные команды — CLI принимает и отдаёт JSON, агентам так проще строить сложные запросы, а большие ответы режутся через Unix-конвейеры. Команды идут по схеме «существительное-глагол» (connectors list, workspace list), и если агент раз за разом ошибается в одной команде, это дефект контракта.
  • Авторизация вне вызова — интерактивный промпт подвешивает агента, поэтому credentials передаются через переменные окружения или конфиг. Навык (skill) поставляется вместе с CLI и выносит детали команд в отдельные файлы, чтобы не раздувать контекст.

Кому полезно: тем, кто выбирает между MCP и CLI для доступа агентов к данным SaaS-систем: MCP удобен для нетехнических пользователей и разовых отчётов, CLI подходит для долгих задач и больших выводов.

Статья по теме

Главы

Похожие доклады