Графики в ответах — что предоставляется бесплатно, а что делать нельзя
Ваш агент строит график, когда ответ содержит сопоставимые числовые данные. Ничего не нужно включать. Вы контролируете только то, находятся ли цифры в базе знаний и проходят ли производные числа через инструмент.
list_toolsupdate_agentsearch_knowledge_baseПринцип — агент может копировать числа, но не вычислять их. Копирование из полученного текста надёжно; арифметика — нет. Всё, что сказано на этой странице, вытекает из этого единственного измерения. Подробнее в Принципах проектирования.
Когда ответ уже содержит набор сопоставимых чисел, агент строит графики — без дополнительного запроса, в середине обычного разговора. Ничего включать не нужно: любой агент с базой знаний или инструментами делает это автоматически. Графики отображаются в виджете, консоли, панели тестирования и Входящих, а на Telegram, WhatsApp и в экранах для слабовидящих они упрощаются до компактной таблицы.
Поэтому полезный вопрос не в том, «как включить графики». А в том, что определяет разницу между появлением графика и его отбрасыванием.
Каждая цифра должна быть в материалах
Прежде чем отобразится график, над ним выполняется детерминированная проверка: каждая пара «метка-значение» должна присутствовать в тех фрагментах текста, которые агент фактически получил в этот запрос. Если пару найти не удаётся, отбрасывается весь блок — посетитель видит слова, но не видит картинки, и в ответе не объясняется причина.
Именно поэтому практическая работа ведётся в вашей базе знаний, а не в настройках:
- Короткие, конкретные документы выигрывают. Длинная страница о продукте, в которой никогда не указана его цена, будет найдена по запросу о цене, но не даст ответа. Дайте каждому объекту отдельный короткий документ, в котором указаны его числа.
- Пишите числа так, как их спрашивают.
25M,25,000,000и2500万распознаются одинаково, как и$49,49 USDи49 美元. Единицы измерения не проверяются, поэтому оставляйте их в тексте рядом с цифрой. - Проверяйте через
search_knowledge_baseперед тем, как полагаться на них. Если возвращённый фрагмент не содержит числа, графика тоже не будет.
Производные числа проходят через compute_chart
Доли, темпы роста, накопительные итоги и счета — это именно то, что модель ошибается в расчёте, и
именно то, из-за чего график стоит смотреть. Поэтому агент не вычисляет их самостоятельно: он
передаёт исходные цифры в compute_chart, платформа вычисляет ряд в коде, и числа подставляются
в график, не проходя обратно через модель.
derive | Для чего | Что передать |
|---|---|---|
share | доля от общего | labels + series |
growth | процентное изменение по сравнению с предыдущим периодом | labels + series |
cumulative | накопительный итог | labels + series |
project | «растёт на X% за период в течение N периодов» | base, rate_pct, periods |
tier | «при таком использовании, сколько это стоит» | included, rate_per_unit, base_fee — плюс base/rate_pct/periods для проекции и формирования счёта в одном вызове |
Инструмент прикрепляется автоматически к любому агенту, у которого уже есть инструменты, поэтому
обычно ничего добавлять не нужно. Убедитесь с помощью list_tools() на вашем арендаторе.
Два правила, о которых стоит знать, так как они объясняют, почему графики «должны были появиться»:
- Входные данные тоже проверяются. Цена, переданная в
tier, должна существовать в материалах как деньги — рядом со знаком валюты. Модель, которая придумывает ежемесячную плату, формирует точно рассчитанный счёт на основе цифры, которую никто не публиковал, и график отбрасывается. - Единицы должны совпадать.
included,rate_per_unitи значения использования выражены в одних и тех же единицах. Укажите использование в сырых токенах, а лимит — в миллионах, и вызов будет отклонён, а не рассчитан по миллионной ставке.
Что нельзя стилизовать и почему
Цвета графиков выводятся из вашего цветового оформления — всей палитры, как для светлой, так и для тёмной темы, состояния при наведении и всплывающей подсказки. Одна настройка для всех типов графиков.
Не пытайтесь обращаться к графикам через custom_css: они рисуются на холсте (canvas), и CSS не
может проникнуть внутрь него. Правило, нацеленное на график, не переопределяется, а просто не
выполняется, что хуже, чем явный отказ. Если график выглядит неправильно для вашего бренда,
измените цвет оформления.
Когда он молчит
Три числа — это минимальный порог — «выросло с 120 тыс. до 150 тыс.» — это предложение, а не столбчатая диаграмма. Вопросы с ответами «да/нет» и запросы одного значения получают текстовый ответ, а не картинку. Не более двух графиков в одном ответе, и второй появляется только тогда, когда две меры выражены в разных единицах.
И если в этот запрос ничего не было найдено, рисовать нечего. Агент говорит то, что знает, и то, чего не знает, — так же, как он поступает со словами.