ИИ-агенты — документация AI Map

Агент — это ИИ-ассистент, который отвечает клиентам в вашем Telegram-боте от вашего имени: консультирует по базе знаний, выясняет задачу, зовёт менеджера, когда нужен человек. Раздел живёт в Чатах: диалоги агентов попадают в общий инбокс, и оператор отвечает оттуда — сообщение уходит через бота агента.

Собрать агента можно руками в карточке, но задуман он под другое: вы подключаете Чаты к Claude Code или Codex по MCP и говорите ассистенту, какой агент нужен. Он сам пишет инструкцию, раскладывает базу знаний, описывает действия и прогоняет тесты.

Агенты: список агентов и блок подключения конструктора к Claude Code — Список агентов кабинета и команда подключения MCP — та же, что для переписки и контактов

Из чего состоит агент

Инструкция — роль, цель, границы и приветствие на /start. Чем конкретнее описано, чего агент не делает, тем меньше он выдумывает.
База знаний — статьи и файлы. Тип faq — один вопрос, один файл: агент берёт файл целиком. Тип doc — большой документ, по которому он ищет фрагменты.
Действия — функции, которые модель может вызвать: webhook, уведомление в Telegram, сообщение клиенту, переменные диалога, слоты календаря. Описываются JSON-ом с аргументами.
Telegram — свой бот через BotFather; токен вставляется во вкладке с именем бота. Там же chat id менеджера, куда уходят лиды и вызовы «позвать человека», и пауза перед ответом.
Модель — OpenRouter, до трёх моделей в цепочке: если первая недоступна, отвечает следующая.

Карточка агента: системная инструкция и выбор модели — Инструкция агента поддержки: роль, цель по шагам, границы. Справа модель и встроенные функции

Что агент умеет сам

Помимо ваших действий у каждого агента есть встроенные инструменты: get_knowledge и search_knowledge — прочитать файл базы знаний или найти по ней; set_variables — запомнить факты о клиенте в переменных диалога; call_manager — позвать человека (уведомление менеджеру в Telegram); set_tag — поставить метку диалогу; stop_dialog — замолчать, когда разговор ведёт человек.

Карточка агента: база знаний из файлов faq и doc — База знаний агента поддержки — по файлу на тему, как разделы документации

Карточка агента: действие в формате JSON — Действие «передать команде»: описание для модели и аргументы, которые она должна собрать перед вызовом

Проверить до запуска

Вкладка «Тест» — тот же движок, что в Telegram, но без отправки: пишете как клиент, видите ответ и вызовы инструментов серым — какой файл прочитал, какое действие дёрнул. «Заново» сбрасывает контекст. Так инструкция отлаживается за минуты, а не на живых клиентах.

Тест-чат агента с видимыми вызовами инструментов — В тесте видно, к каким файлам агент обратился перед ответом

Диалоги и передача человеку

Вкладка «Диалоги» — переписка бота с клиентами; те же диалоги видны в инбоксе с провайдером «agent». Ответить можно от имени бота как сотрудник — клиент увидит сообщение в том же чате. Кнопка «Агент на паузу» останавливает бота в конкретном диалоге, «Пауза» наверху — целиком.

Диалоги агента и ответ от имени бота — Диалог из Telegram в карточке агента; оператор отвечает из этого же окна

Собрать через Claude Code или Codex

1Подключите Чаты как MCP-сервер: claude mcp add --transport http aimap-chats https://chats.aimap.agency/mcp (для Codex — codex mcp add aimap-chats --url https://chats.aimap.agency/mcp). Команда с кнопкой «Копировать» лежит внизу раздела «Агенты».
2При первом обращении откроется вход — войдите аккаунтом AI Map. Ассистент работает от вашего имени и видит только ваш кабинет.
3Скажите, кого собрать: «агент поддержки для нашего сервиса, база — наша документация, при ошибках зовёт команду». Правила сборки ассистент возьмёт сам инструментом agents_guide; те же правила текстом — chats.aimap.agency/api/agents/skill.md.
4Проверьте результат в «Тесте», вставьте токен бота — и агент отвечает клиентам.

Бесплатные модели OpenRouter ограничены 50 запросами в день на кабинет; после покупки кредитов на $10 лимит вырастает до 1000. Счётчик за сегодня показан под командой подключения.