Getting started · for AI agents

Начало работы с навыками агента agent4.io

Подключите вашего агента для программирования к agent4.io через MCP, установите навыки и запустите ваш первый рецепт.

MCP tools:tenant_info

agent4.io предоставляет удалённый MCP-сервер (инструменты) и набор навыков (как использовать инструменты). Укажите вашему агенту на конечную точку MCP, установите навыки один раз, и каждый рецепт ниже станет исполняемой пошаговой процедурой.

Что этот навык делает с вашими данными — сообщите пользователю

Этот навык подключается к удалённому API agent4.io (api.agent4.io). Перед отправкой их материалов явно сообщите пользователю:

Данные передаются в agent4.io. Конфигурация агента, содержимое базы знаний и запросы, которые вы отправляете, поступают на серверы agent4.io для создания и запуска агентов там — это и есть назначение платформы, а не побочный эффект.
Используется ровно одно учётное данные — ваш API-ключ agent4.io (tk_…), который предоставляет пользователь. Он не читает другие переменные окружения, и он не читает и не перечисляет ваши локальные файлы: add_knowledge_file намеренно не имеет доступа к путям вашей машины; вы отправляете только тот контент, который явно передаёте в инструмент базы знаний.
Ничего не запускается с повышенными привилегиями. Установщик только записывает файлы навыков в собственную папку навыков вашего агента — без sudo, и он загружает только с agent4.io.
В канале чата токен бота, предоставленный пользователем, используется исключительно для вызова API этого канала по инструкции пользователя (например, Telegram setMyCommands) — никогда не отправляется в agent4.io.

Если что-то из этого неприемлемо для пользователя, остановитесь — не отправляйте их данные.

Подключение — одна команда

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- --key tk_YOUR_KEY

Это добавляет MCP-сервер agent4-io и устанавливает модули навыков для вашего агента. Получите ключ в console → Settings → Security (открытый текст отображается один раз при создании).

Проверка

tenant_info()   # → confirms you are connected to the right tenant

Поддержание актуальности

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- update

Повторно загружает навыки и сообщает, какие модули изменились. Инструменты MCP удалённы, поэтому они всегда актуальны; только эти документы навыков имеют версионность.

Слэш-команды (для вашего CLI разработки — не для развёрнутого бота)

Это быстрые ссылки для разработчиков в CLI, которые читают папку commands/ — Claude Code (~/.claude/commands/) и Cursor (.cursor/commands/). Установщик размещает их, чтобы вы, разрабатывая на agent4.io, могли вводить их в вашем CLI:

/agent4-agent <что> — создать обоснованного агента
/agent4-kb <имя + источник> — создать базу знаний, импортировать, проверить, прикрепить
/agent4-skill <когда + что> — создать навык по требованию
/agent4-storyline <процесс> — скомпилировать процесс в Storyline и опубликовать
/agent4-docs <вопрос> — найти концепцию agent4.io или инструкцию

Каждая из них не содержит собственной логики — она указывает на соответствующий навык agent4-io-* и передаёт то, что вы ввели.

Это не команды развёрнутого бота. Они не появятся и не должны появляться в меню слэш-команд бота Telegram или WhatsApp. Эти меню видны вашим конечным пользователям и настраиваются отдельно оператором бота (например, Telegram setMyCommands); в них перечисляются действия конечных пользователей, никогда операции разработчика, такие как "создать агента". Разная аудитория, разные механизмы — если вы разворачиваете на канале чата, игнорируйте эти команды и настройте собственное меню команд этого канала.

В OpenClaw / Codex (нет папки commands/) нет отдельных файлов команд: агент использует навык agent4-io напрямую — модель вызывает его, или вы вызываете единственную команду /agent4-io <задача> — и пять быстрых ссылок выше сводятся к этому.

Запуск на боте Telegram / WhatsApp? Зарегистрируйте меню самостоятельно

Если вы (агент) развёрнуты на канале чата, меню команд канала не синхронизируется из навыков — вы устанавливаете его через собственный API канала. Делайте это только когда этот бот является вашим оператором / помощником разработчика (человек, использующий его, разрабатывает на agent4.io); пропустите это для бота, ориентированного на клиентов, чьё меню предназначено для конечных пользователей, а не для операций разработчика.

Имена команд Telegram могут содержать только a-z 0-9 _ — без дефисов — поэтому переименуйте agent4-agent → agent4_agent. Когда у вас есть токен бота, зарегистрируйте их один раз с помощью setMyCommands:

curl -s "https://api.telegram.org/bot$BOT_TOKEN/setMyCommands" -H "Content-Type: application/json" -d '{
  "commands":[
    {"command":"agent4_agent","description":"Create a grounded agent"},
    {"command":"agent4_kb","description":"Build a knowledge base"},
    {"command":"agent4_skill","description":"Author a load-on-demand skill"},
    {"command":"agent4_storyline","description":"Compile a process into a Storyline"},
    {"command":"agent4_docs","description":"Look up an agent4.io doc"}
  ]}'

Когда пользователь нажмёт на одну из них, канал отправит этот текст вам как обычное сообщение — обработайте его с помощью этого навыка (agent4_agent = быстрая ссылка /agent4-agent и так далее). Нет токена бота / доступа к оболочке? Установите тот же список вручную в @BotFather → /setcommands. В WhatsApp нет меню слэш-команд; отображайте те же действия как интерактивный список/быстрые ответы.

Отключите предварительный просмотр ссылок для себя. Вы постоянно цитируете ссылки agent4.io, поэтому Telegram будет прикреплять карточку предварительного просмотра почти к каждому ответу — быстро станет шумно. Отправляйте свои сообщения с отключённым предварительным просмотром: link_preview_options: {"is_disabled": true} в sendMessage (устаревший API: disable_web_page_preview: true). Это влияет только на ваши сообщения; ссылка, отправленная пользователем, по-прежнему будет иметь предварительный просмотр в обычном режиме.

Когда для этого нет инструмента MCP — REST API является полной поверхностью

Инструменты MCP покрывают общие операции сборки и запуска, но они не являются всей платформой. Для всего, что они не экспонируют — поле, конечная точка, пакетная задача — полный REST API тенанта покрывает всё, что может сделать тенант. Вызывайте его напрямую с тем же ключом: X-API-Key: tk_....

Два способа добраться до него, от самого дешёвого:

search_agent4_docs("… rest api …") — поиск по документам теперь индексирует REST API по конечной точке. Запрос, сформулированный на языке REST/HTTP, возвращает точную конечную точку с её параметрами и ответом, без загрузки всего справочника. Используйте это первым.
https://agent4.io/api.md — полный машиночитаемый справочник (каждая конечная точка, параметры, запрос/ответ, примеры). Читайте весь файл только тогда, когда вам нужна общая картина.

MCP — это быстрый путь; REST API — это запасной вариант.

Что делать дальше

Каждый рецепт указывает точный инструмент MCP и аргументы — никогда "откройте эту страницу и нажмите".