[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"glossary-tool-description::ru":3,"gloss-cluster-tool-description::ru":23,"gloss-next-tool-description::ru":9},{"slug":4,"category":5,"name":6,"definition":7,"meta_desc":8,"faq":9,"schema_markup":9,"related":10},"tool-description","agents","Описание инструмента (Tool Description)","Описание инструмента — это текст, который сообщает модели, что инструмент делает, когда его применять и что значат его аргументы. Больше у модели ничего нет: она не читает реализацию, не пробует эндпоинт и не спрашивает у коллеги, что на самом деле принимает поле с названием статус. Поэтому всякое описание инструмента — часть промпта, а не документация рядом с ним.\n\nКоманды пишут их между делом, а последствия отлаживают совсем в другом месте. Агент, который берёт не тот инструмент, выдумывает аргумент, дважды вызывает один и тот же инструмент с чуть разной формулировкой или игнорирует вполне подходящий инструмент в пользу худшего, обычно страдает не от слабой модели: он работает по описаниям, написанным тем, кто ответ уже знал. Выдаёт это то, что сбои скапливаются на инструментах с самым расплывчатым текстом.\n\nРаботающий вариант читается как инструкция способному новому коллеге без доступа к коду. Скажите конкретно, что инструмент делает, укажите условия, при которых его следует выбрать, и — чаще всего пропускаемая часть — когда его выбирать не следует. Если два инструмента пересекаются, каждое описание должно назвать другой и провести границу: модель выбирает между ними, и больше ей об этом никто не сообщает. Параметры требуют того же: что значение означает, в каком оно формате, откуда берётся и что будет, если оно неверно.\n\nОписания нужно сопровождать как промпты, а не как комментарии. Когда поведение инструмента меняется, его описание остаётся живым входом для решений в проде, и устаревшее даёт не ошибку компиляции, а уверенно неправильные вызовы. Смена формулировки меняет поведение, а значит, описаниям место под контролем версий и внутри той же проверки, что покрывает агента.\n\nКоличество важно не меньше качества. Длинный список инструментов усложняет каждый выбор и занимает контекст, нужный задаче; обычное улучшение для буксующего агента — не лучшее описание, а меньше инструментов перед ним, суженных до текущей задачи, а не до всего, что умеет платформа.","Описание инструмента — часть промпта, а не документация: это всё, что есть у модели при выборе, и расплывчатый текст ведёт к выбору не того инструмента.",null,[11,14,17,20],{"slug":12,"name":13},"guardrails","Ограждения (Guardrails)",{"slug":15,"name":16},"prompt-versioning","Версионирование промптов",{"slug":18,"name":19},"tool-calling","Вызов инструментов",{"slug":21,"name":22},"tool-registry","Реестр инструментов",[24,28,32,35,38,41,44,47,50,53,56,59],{"slug":25,"category":5,"name":26,"updated_at":27},"acceptance-criteria","Критерии приёмки (Acceptance Criteria)","2026-09-08T21:32:37+00:00",{"slug":29,"category":5,"name":30,"updated_at":31},"agent-budget","Бюджет агента (Agent Budget)","2026-09-08T21:32:36+00:00",{"slug":33,"category":5,"name":34,"updated_at":31},"agent-checkpointing","Контрольные точки агента",{"slug":36,"category":5,"name":37,"updated_at":31},"agent-handoff","Передача между агентами (Agent Handoff)",{"slug":39,"category":5,"name":40,"updated_at":27},"agent-identity","Идентичность агента (Agent Identity)",{"slug":42,"category":5,"name":43,"updated_at":31},"agent-loop","Цикл агента (Agent Loop)",{"slug":45,"category":5,"name":46,"updated_at":31},"agent-memory","Память агента (Agent Memory)",{"slug":48,"category":5,"name":49,"updated_at":31},"agent-sandbox","Песочница агента",{"slug":51,"category":5,"name":52,"updated_at":27},"agent-simulation","Симуляция агента (Agent Simulation)",{"slug":54,"category":5,"name":55,"updated_at":31},"agent-trajectory","Траектория агента",{"slug":57,"category":5,"name":58,"updated_at":31},"agentic-rag","Агентный RAG (Agentic RAG)",{"slug":60,"category":5,"name":61,"updated_at":27},"approval-fatigue","Усталость от согласований (Approval Fatigue)"]