Встроенные инструменты (и системный MCP)
Инструменты, которые поставляются с платформой — захват лидов, документы, последующие действия, поиск в интернете, а также автоматически установленный сервер времени/погоды/местоположения.
list_toolsupdate_agentВам не нужно создавать общие инструменты — платформа поставляется с ними. Подключите те, которые нужны для работы этого агента, с помощью update_agent(name, add_tools=[…]); держите набор небольшим (см. Принципы проектирования). Всегда уточняйте точные имена на вашем тенанте с помощью list_tools() — это источник истины.
tools=[…]заменяет весь список;add_tools/remove_toolsизменяют один элемент. Передачаtools=только с теми инструментами, о которых вы думаете, молча удалит все инструменты, которые вы не проверили заранее — такое происходило в продакшене, и никто не замечал этого, пока не перестала работать функция. Используйтеtools=только тогда, когда вы намеренно хотите сказать «ровно этот набор», и в любом случае проверяйте возвращаемого агента, чтобы подтвердить окончательный список. Те же пары существуют для навыков (add_skills/remove_skills) и баз знаний (add_knowledge_bases/remove_knowledge_bases).
Встроенные инструменты
| Инструмент | Что он делает |
|---|---|
web_search | Искать что-либо в открытом вебе. |
save_contact | Сохранить контактные данные конечного пользователя в их профиле — путь платформы для захвата лидов / ведения записей. Возвращает реальный код ссылки (в стиле AB2C-D3EF), который агент сообщает пользователю; ищите коды на странице деталей пользователя (recent_refs). |
export_document | Сгенерировать структурированный документ (брендированную сводку / отчет) для разговора. |
schedule_followup | Проактивно связаться позже («перезвонить через 2 дня») или записать пользователя на обратный звонок по его запросу — сообщение будет отправлено за вас. Возвращает реальный код бронирования, отслеживаемый по запланированной задаче. Для абсолютных времен («завтра в 10 утра») инструктируйте модель передать run_at (локальная дата и время в формате ISO + необязательный tz) — сервер определит часовой пояс пользователя; ручное вычисление delay_seconds предназначено только для относительных времен, и модели ошибаются в арифметике. Окно: до 7 дней. |
schedule_reminder | Установить напоминание для конечного пользователя; list_reminders / cancel_reminder управляют ими. |
compute_chart | Вычислить производную серию в коде — долю от общего, процент роста, накопительный итог, прогноз по фиксированной ставке или счетчик с тарификацией (базовая плата + лимит + плата за превышение по единицам). Автоматически подключается к любому агенту, у которого уже есть инструменты, поэтому вы редко добавляете его вручную. См. Графики в ответах. |
load_skill также встроен, но вы не подключаете его — модель сама извлекает навык, когда
описание навыка совпадает.
list_tools() # точные имена, доступные на вашем тенанте
update_agent(name="Support", add_tools=["save_contact", "schedule_followup"]) # инкрементально — сохраняет то, что уже естьСохранение контакта с помощью save_contact заполняет запись пользователя; в сочетании с ask_forms на
агенте структурированный ввод попадает в записи, которые вы можете просмотреть в консоли.
Платформа автоматически резервирует эти два инструмента. Когда сообщение конечного пользователя содержит четкий
сигнал — номер телефона / электронная почта (любой язык, включая цифры, записанные словами, и форматы с пробелами), или запрос на обратный звонок в стиле «позвоните мне завтра утром» — и save_contact / schedule_followup
включены, платформа внедряет подсказку для каждого хода, напоминающую модели вызвать инструмент перед ответом.
Протестировано на продакшен-бэкендах, это повысило соблюдение требований по захвату лидов для самой слабой модели
с ~85% до 100% с нулевым количеством ложных сохранений (подсказка содержит вариант «игнорировать, если неверно», поэтому
слишком активный детектор не может вызвать порчу данных). Вы получаете это бесплатно — без настройки; ваш навык
все равно должен указывать триггер в своем description (см. Создание навыка),
подсказка — это страховка, а не замена.
Системный MCP — уже установлен
Каждому тенанту предоставляется встроенный system MCP-сервер, включенный по умолчанию, с инструментами без ключа для
локального времени, погоды и геолокации по IP (город / регион / часовой пояс). Вы не регистрируете его — он уже там. Его инструменты отображаются в list_tools() наряду со встроенными выше, готовые к подключению.
Так что «какая погода там, где находится пользователь?» или «какое их локальное время?» работают из коробки — платформа внедряет клиентский IP конечного пользователя, поэтому ответы, учитывающие местоположение, не требуют настройки.