Навыки платформы — те, что уже есть у каждого агента

Принцип — платформенные навыки это методы, навыки арендатора это ваш бизнес. Общая библиотека содержит общие способы работы (исследование конкурента, чтение нормативного акта, оценка лида). Всё, что специфично для вашей отрасли или ваших данных, должно находиться в ваших собственных навыках. Подробнее в Принципы проектирования.

Каждый агент начинает с набора платформенных навыков, которые не нужно было ему предоставлять. Это общие методы работы, они загружаются по требованию, как и любой другой навык, и вы не прикрепляете их по одному.

Почему это не просто «больше навыков у агента»

Библиотека из нескольких сотен методов не помещается в промпт. Перечисление всех их измеримо ухудшает выбор: при полном перечислении 207 навыков модель выбирала правильный в 30% случаев; когда список сначала сужался до 15 наиболее релевантных, до 51%. Поэтому платформа сначала осуществляет поиск, а затем перечисление.

Поиск выполняется по сообщению текущего хода, одновременно по обеим библиотекам — общей и вашей. Ваши собственные навыки не проигрывают из-за совместного использования пространства с общими: при измерении на 18 действительно отраслевых навыков, смешанных с 193 общими, отраслевые навыки распознавались более надёжно (86% против 79%), потому что отраслевая лексика находится далеко от лексикона общих методов.

При количестве примерно ниже восьми навыков ничего не извлекается — просто показывается полный список. При таком размере список уже точен, и поиск мог бы лишь внести новый сбой: правильный навык отсутствует в коротком списке, после чего модель отвечает, опираясь на свои собственные знания, без признаков в журнале.

Что вы контролируете, а что нет

Пишите их на английском

Платформенные навыки пишутся на английском — description, instructions, menu_label и сгенерированные триггерные фразы.

Это не только про демо. При измерении на той же библиотеке из 193 китайских навыков, перевод трёх платформенных навыков с китайского на английский повысил надёжность распознавания каждого: исследование конкурента 75% → 83%, чтение политики 83% → 100%, квалификация лида 50% → 62%. Англоязычный навык находится дальше в векторном пространстве от толпы китайских, поэтому его легче выделить. (Преимущество возникает из-за того, что он разный, а не из-за английского как такового — в полностью англоязычной библиотеке это исчезает.)

Язык не влияет на то, может ли модель вызвать навык: как самохостинговая модель на 35B, так и хостинговая выдавали корректные, хорошо сформированные вызовы load_skill из описаний как на китайском, так и на английском. Выбор английского — это продуктовое решение, а не технический обходной путь.

Ваши собственные навыки — это отдельный вопрос — пишите их на том языке, на котором говорят ваши клиенты.

Пусть платформа исследует до запуска навыка

Навык может попросить, чтобы материал для него собрали заранее. Поставьте эту строку в начале instructions:

PREFETCH: web x4

Платформа превратит сообщение посетителя в столько поисковых запросов, выполнит их и передаст навыку нумерованную таблицу фактов для ссылок. Просто PREFETCH: web означает значение по умолчанию — два запроса; без этой строки не ищется ничего.

Просите ширину только там, где у вопроса несколько частей. Разбор продукта — цены, ограничения, экспорт — при узком обходе дал 2957 слов на пять ссылок, и каждая цена в них была конкретным числом, которого не было ни в одном источнике; при четырёх запросах тот же вопрос вернулся с 17 ссылками. Навыки, которые составляют, переписывают или считают, не должны объявлять ничего: ненужный им поиск — это чистая потеря времени и денег.

Это не заменяет записанное правило, но это та половина, которая работает. В инструкциях того же навыка уже было сказано никогда не называй цену, которой нет в материале, и он всё равно её назвал. Ответ изменил материал, а не эта фраза.

Написание такого, которое действительно используется

Те же правила, что и для любого навыка, плюс одно, которое проявляется только в масштабе:

• description говорит когда, словами, которые использовал бы клиент. Это то, с чем сопоставляется поиск.
• instructions заканчиваются тем, что навык не охватывает. При наличии сотен навыков близкие соседи неизбежны; эта заключительная строка — единственное, что позволяет модели заметить, что она открыла не тот.
• Триггерные фразы генерируются для вас — восемь простых языковых способов, которыми кто-то может попросить об этом — и вы можете их редактировать. Они сопоставляются, но никогда не показываются посетителям, и ваши правки никогда не перезаписываются при повторной генерации.

Есть проверка, которую стоит запустить после написания одного: спросите библиотеку, какой навык извлекается для каждой из его собственных триггерных фраз. Если собственные фразы навыка постоянно возвращаются как другие навыки, этот навык есть в библиотеке, но до него не добраться — объедините его с тем, который постоянно побеждает, или сделайте так, чтобы оба явно указывали, чем они отличаются.