Термины

Инструмент

Программа или функция для конкретной операции. Обвязка передаёт модели описание инструмента, интерпретирует ответ с данными вызова и запускает исполнитель. Результат может войти в следующий контекст.

Описание и реализация

Имя read_file и схема аргументов объясняют формат запроса, но сами файл не читают. В Codex ToolRouter преобразует элементы FunctionCall и CustomToolCall в вызовы зарегистрированных обработчиков. Отсутствующий или запрещённый инструмент не появляется от одного упоминания в промпте.

Где исполняется операция

Локальные функции, MCP-сервисы и hosted-инструменты имеют разные исполнители. Например, WebSearchCall в hosted-ветке приходит как событие API и не направляется в обычный локальный обработчик FunctionCall. Название инструмента само по себе не указывает место исполнения.

Применение вне программирования

Через инструменты можно подключать операции над документами и внешними системами. Возможность интеграции подтверждается обработчиком MCP; наличие конкретного сервиса и права доступа нужно проверять отдельно. Полученный текст «готово» не заменяет результат выполнения операции.

Как эти части соединяются, показано в разборе «Как Codex собирает запрос к LLM».

Где проверить в исходниках

Разбор от 15 ноября 2026 года, ревизия 727283cea5ba30e8cf8bbac6b68a03a4d91cf1b7. Пути ниже указаны от корня репозитория Codex. Они относятся к реализации клиента; внутренний код серверов OpenAI здесь не исследуется.

  • codex-rs/core/src/tools/router.rs — build_tool_call. Разбирает типы запросов инструментов.
  • codex-rs/core/src/stream_events_utils.rs — handle_output_item_done. Передаёт вызов исполнителю и отмечает необходимость продолжения.

Практика: найти исполнитель вызова

Сопоставьте разбор FunctionCall и выполнение handler.

Откройте терминал в корне локального репозитория Codex. Нужны Git и ripgrep (rg). Сначала сравните git rev-parse HEAD с ревизией выше. При другой версии найдите символы заново: структура и поведение могут отличаться.

Команды для изучения исходников
rg -n 'pub fn build_tool_call|FunctionCall|CustomToolCall|execution == ' codex-rs/core/src/tools/router.rs
rg -n 'handle_tool_call|needs_follow_up = true' codex-rs/core/src/stream_events_utils.rs

Что найти: Ответ сначала преобразуется в ToolCall, затем обвязка запускает обработчик.

Вопрос для проверки: Что подтверждает вызов инструмента, а что подтверждает ответ модели?

Разобрать ответ

Событие и результат инструмента подтверждают конкретную попытку операции. Текст модели — её интерпретацию результата, которую можно проверить.

Наблюдение при запуске

Используйте CLI выбранной версии в корне репозитория. JSONL позволяет увидеть события выполнения без графического интерфейса.

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

Команда запуска эксперимента
codex exec --sandbox read-only --json 'Прочитай README.md инструментом и назови одну команду запуска. Файлы не изменяй.'

Наблюдаемый результат: В потоке найдите операцию чтения или команду, её результат и итоговый текст. Реальное имя инструмента зависит от конфигурации.

Граница проверки: Если инструмент не был вызван, опыт не подтверждает цепочку чтения. Ответ из прежнего контекста или отказ нужно отметить отдельно.

Написать мне