DeepSeek Harness является платформой для работы с агентами с открытым исходным кодом от DeepSeek AI. Руководство «инструменты DeepSeek Harness schema catalog» объясняет, как проверять и выбирать инструменты. В README проекта он назван предварительной версией для разработчиков и содержится предупреждение о неизбежных изменениях, нарушающих совместимость. Это сторонний проект. В данной статье нет никаких упоминаний о том, что это продукт OdiRouter, поддерживаемая интеграция или партнерство.
Если вам нужна актуальная схема, используйте официальный каталог по адресу https://deepseek-harness.github.io/deepseek-harness/en/reference/tool-catalog. На этой странице объясняется, как изучить этот справочник, проверить входные и выходные данные и выбрать ограниченный набор возможностей.
Что охватывает каталог
Каталог схем инструментов генерируется, а не поддерживается как составленное вручную меню. В проекте указано, что он запускает поставляемые плагины инструментов в реальном контексте и считывает ctx.tools.schemas(). В каталоге приводятся имя инструмента, доступное модели, описание и JSON Schema parameters. Он отвечает на конкретный вопрос: какая входная схема предлагается модели в проверенной конфигурации каталога?
У этого ответа есть ограничения. Документированная область применения охватывает поставляемые пакеты с конфигурацией по умолчанию. Имя инструмента может быть задано при загрузке плагина. В развертывании может отсутствовать плагин, может быть добавлен псевдоним или могут использоваться другие сервисы вокруг того же пакета. Рассматривайте запись каталога как источник сведений о проверенной сгенерированной конфигурации, затем изучите композицию, которую планируете использовать.
Проверенный репозиторий является публичным и использует лицензию MIT. На странице релизов dsh-v0.1.0-rc.7 указан как предварительный релиз, опубликованный 2026-08-17. Зафиксируйте эту ревизию при проверке конфигурации, но не считайте ее обещанием стабильности или совместимости.
Отделите схему от границы выполнения
Начните с полей, ориентированных на модель. name идентифицирует вызов. Описание поясняет его предполагаемое назначение. Схемы JSON Schema parameters определяют ожидаемую структуру входных данных, включая имена полей, типы, обязательные значения и вложенные структуры, если они объявлены схемой. Перед тем как вызов достигнет инструмента, необходимо проверить эту форму.
Затем изучите примечание к карте пакетов и сопроводительную техническую справку. Подсистема инструментов исключает из запроса модели ряд деталей: объявление канонического выходного параметра, функцию выполнения, информацию о таймауте и метаданные параллельного выполнения. Прохождение проверки входных данных не означает, что инструмент включён или безопасен для каждого рабочего пространства. Это означает лишь то, что предоставленное значение имеет ожидаемую форму.
Результаты требуют такого же внимания. Документация по инструментам описывает каноническое определение выходных данных со схемой JSON Schema и этапом, который формирует содержимое, ориентированное на модель. В ходе анализа интеграции определите, какие данные об успешном выполнении необходимы приложению, какие ошибки должны оставаться видимыми и как вызывающая сторона идентифицирует инструмент, выдавший результат. Не полагайтесь только на понятный отображаемый текст.
Сгруппируйте возможности по их воздействию
Текущий каталог охватывает несколько границ. Доступность зависит от развёртывания, но группировка инструментов упрощает проверку.
Наблюдение и поиск
read, glob, grep, web_fetch и web_search связаны с обнаружением файлов, проверкой содержимого или доступом к веб-ресурсам. Они всё же могут раскрывать конфиденциальные данные или обращаться к внешней службе. Прежде чем включать их, определите, какие материалы агент может проверять, какие источники данных ожидаются и как ограничиваются эти пути.
Изменения файловой системы
Каталог включает write, edit и str_replace_editor. В примечаниях к пакету описывается политика, требующая наблюдения перед внесением изменений. Проверьте соблюдение этой политики в фактическом развёртывании. Начните с инструментов наблюдения, затем добавляйте возможность внесения изменений только там, где чётко определены целевой каталог, разрешённая операция и точка проверки.
Выполнение команд и в терминале
bash, pwsh и инструменты терминала представлены как отдельные возможности. Записи в их каталоге относятся к службам оболочки, терминала, окружения и заданий. Одно лишь название не определяет безопасную границу. Проверьте службу выполнения, настройку фоновой работы, поведение при отмене, а также ограничения каталогов и сети, применимые к данному развёртыванию.
Координация и делегированная работа
Вопросы пользователей, цели, задания, подагенты, рабочие процессы и расписания координируют активность между сеансами или агентами. Они могут изменять время, состояние или получателя результата, не изменяя файл. Прежде чем добавлять их в композицию, проверьте поведение в отношении владения, утверждения и очистки.
Выберите минимальный полезный набор
Начинайте с задачи, а не с полного каталога. Укажите, что агент должен наблюдать, что он может изменить и какой результат он должен получить. Агенту для первичной сортировки обращений в службу поддержки может понадобиться узкий путь наблюдения и механизм для вопросов. Для этого не требуется автоматический доступ к командной оболочке, изменение файлов, делегирование задач или доступ к веб-сайту.
Сформируйте набор кандидатов вокруг этой задачи. Проверьте каждую выбранную схему на наличие обязательных параметров, затем изучите примечание к карте пакетов относительно требований и последствий для служб. Исключите из рассмотрения возможность, влияние которой выходит за рамки выполняемой задачи. Небольшой набор данных проще проверить при изменении каталога или конфигурации.
Протестируйте композицию в изолированной среде с нечувствительными тестовыми данными. Убедитесь, что отображаются только предполагаемые названия инструментов, недопустимые входные данные отклоняются, разрешенные вызовы дают ожидаемый результат, а ошибки политики видны вызывающей стороне. Это проверка схемы и политик. Она не требует выполнения операционных команд в реальных системах.
Отдельно проверьте изменения. Возможность работы с файловой системой или оболочкой требует определённой целевой границы, точки утверждения или проверки и пути восстановления после ошибочных изменений. Инструмент с возможностью работы в интернете требует сетевой границы, соответствующей приложению. Каталог называет категорию; контроль задаёт развёртывание.
При изменении конфигурации зависимости или плагина повторно проверьте официальный каталог и зафиксируйте редакцию. Источник каталога сообщает, что проект проверяет свою сгенерированную страницу с помощью pnpm run verify-tool-catalog. Используйте официальную документацию и репозиторий для актуальных названий и схем вместо копирования снимка каталога в руководство по долгосрочной конфигурации.
Контрольный список проверки входных и выходных данных
Подтвердите редакцию проекта и статус предварительного выпуска по репозиторию и странице релизов.
Убедитесь, что плагин и требуемые им точки сопряжения со службами присутствуют в фактической композиции.
Перед вызовом инструмента проверьте обязательные поля, типы и вложенные значения по опубликованной JSON Schema.
Считайте описание, предназначенное для модели, рекомендацией, а не разрешением.
Проверьте каноническую структуру результата и состояние ошибки, а также отображаемый текст.
Повторно проверяйте каталог после обновления или изменения конфигурации плагина.
Источники и следующий шаг
Для точных схем начните с https://deepseek-harness.github.io/deepseek-harness/en/reference/tool-catalog. Сгенерированный исходный код находится по адресу https://github.com/deepseek-ai/deepseek-harness/blob/99f6f02fecdb7dff40c3fbc9470f5907c29f74ca/docs/tool-catalog.md. README репозитория находится по адресу https://github.com/deepseek-ai/deepseek-harness/blob/99f6f02fecdb7dff40c3fbc9470f5907c29f74ca/README.md. Справочник по подсистеме инструментов находится по адресу https://github.com/deepseek-ai/deepseek-harness/blob/99f6f02fecdb7dff40c3fbc9470f5907c29f74ca/docs/subsystems/tools.md. Проверенная предварительная версия доступна по адресу https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.0-rc.7.
Чтобы ознакомиться с OdiRouter, перейдите по адресу https://odirouter.ai/. Это отдельная ссылка назначения, и она не указывает, что DeepSeek Harness является продуктом OdiRouter или поддерживаемой интеграцией.