Термины
Вы запускаете Codex, поручаете ему работу и получаете результат. Чтобы приспособить его к своим задачам, нужно различать генерацию LLM, управление шагами и выполнение инструментов. Здесь закреплены определения, которыми мы пользуемся при разборе программы.
Начните с модели, обвязок и агента. Для нескольких исполнителей изучите декомпозицию, субагентов и параллельное выполнение. Цепочка от сообщения до ответа разобрана в базе знаний.
Общие термины ИИ
Все общие термины про ИИ — в основном справочнике «Что такое ИИ». Здесь собраны определения, связанные с особенностями Codex и его программного устройства. Общие понятия сохраняют смысл основного справочника, а местные статьи уточняют их применение в этом проекте.
- Языковая модель (LLM)
- Модель, которая обрабатывает переданный контекст и генерирует ответ. Ответ может содержать текст или данные для вызова инструмента. Сама LLM не запускает программы, не хранит чаты и не создаёт субагентов.
- Обвязки (harness)
- Программные компоненты вокруг LLM: принимают входные данные, формируют контекст, обрабатывают ответы, хранят состояние и вызывают инструменты. Обвязки вместе с моделью образуют агента.
- ИИ-агент
- LLM вместе с обвязками и связями между ними. Агент — вся рассматриваемая система, которая получает задачу, использует ответы модели и при необходимости выполняет действия.
- Среда выполнения
- Программное и аппаратное окружение, в котором работают компоненты агента: ОС, вычислительные ресурсы, среды запуска программ и библиотеки. Среда выполнения и логика оркестрации — разные понятия.
- Контекст
- Данные, переданные LLM для текущей генерации: инструкции, сообщение пользователя, выбранная история, описания инструментов и результаты операций. История в интерфейсе и фактический вход модели могут различаться.
- Инструмент
- Программа или функция для конкретной операции. Обвязка передаёт модели описание инструмента, интерпретирует ответ с данными вызова и запускает исполнитель. Результат может войти в следующий контекст.
- Оркестрация
- Логика обвязок, которая управляет шагами агента: подготавливает запросы, запускает инструменты, доставляет результаты и сообщения, обрабатывает ошибки и определяет продолжение или остановку выполнения.
- Поток или Тред (thread)
- Идентифицируемая история работы агента и связанное с ней состояние в Codex. Поток и тред — синонимы. Поток может включать несколько ходов выполнения и не обязательно отображается пользователю как переписка. ThreadId обозначает объект приложения, а не поток или процесс операционной системы.
- Ход выполнения (turn)
- Цикл работы агента над принятым вводом внутри потока: подготовка контекста, одна или несколько генераций и возможные вызовы инструментов до завершения, ошибки или прерывания.
- Навык (skill)
- Пакет инструкций и, при необходимости, вспомогательных ресурсов для определённого способа работы. Обвязка обнаруживает навык и передаёт нужные инструкции в контекст. Скрипты навыка выполняются через инструменты.
- Память
- Сохраняемые обвязками сведения, которые могут использоваться в последующих запросах. Память отличается от текущего контекста, полной истории чата и параметров самой модели.
- Сокращение контекста (compaction)
- Замена части контекста более компактным представлением для продолжения работы в пределах контекстного окна. Механизм должен отдельно определить момент сокращения, получить результат и установить новый контекст.
- Декомпозиция задачи
- Разделение общей постановки на части с понятными входами, результатами и зависимостями. План таких частей и фактический запуск отдельных исполнителей — разные действия.
- Субагент
- Агент, созданный другим агентом для отдельного поручения. Это роль в дереве работы: у субагента своя сессия и контекст. Дочернее положение само по себе не означает более слабую модель или фиксированно урезанный набор инструментов.
- Параллельное выполнение
- Перекрытие во времени нескольких работ. В Codex отдельно рассматривают независимые сессии агентов, одновременные вызовы инструментов и процессы внешних программ. Эти уровни не равнозначны.
- Неинтерактивный запуск
- Запуск агента программой или командой без диалогового терминального интерфейса. В Codex режим exec принимает постановку задачи и может выдавать поток событий JSONL и результат заданной структуры.
- Базовые инструкции
- Исходный текст правил поведения сессии, который обвязка включает в запрос к модели. Он выбирается из конфигурации, сохранённой истории или каталога модели и дополняется другими частями контекста.
- Каталог моделей
- Набор записей о моделях: их идентификаторах, возможностях, ограничениях и текстах инструкций. В Codex встроенный каталог models.json служит исходным источником этих данных; действующий каталог зависит от конфигурации, кеша и обновлений.
Подготовка к упражнениям
У каждой статьи есть небольшое задание по локальным исходникам с ожидаемым результатом. Разбор привязан к ревизии 727283cea5ba30e8cf8bbac6b68a03a4d91cf1b7. Поиск по коду проверен на этой копии. Он подтверждает наличие и устройство механизма, но не его включение в конкретной сессии.
Команды поиска выполняйте из корня своего checkout Codex. Нужны Git и ripgrep. В примерах нет обязательного пути владельца сайта: вместо него откройте свой каталог.
git rev-parse HEAD
rg --version
Как наблюдать поведение при запуске
В статьях с блоком «Наблюдение при запуске» используются CLI и доступ к настроенному провайдеру модели. Такие эксперименты расходуют ресурсы провайдера. Они приведены как задания читателю: в рамках этой публикации сеансы с LLM для них не запускались.
Сначала установите, какой бинарник вы запускаете. В Linux и macOS команда command -v codex показывает путь. Проверьте codex --version и codex exec --help. Версия установленного приложения и ревизия исходников могут различаться.
Чтобы исследовать именно свой checkout, соберите бинарник штатным способом. Нужны Rust toolchain из codex-rs/rust-toolchain.toml и системные зависимости из docs/install.md. Сборка может быть длительной; приведённая команда сборки здесь не выполнялась.
cd codex-rs
cargo build --release --bin codex
cd ..
./codex-rs/target/release/codex --version
./codex-rs/target/release/codex exec --help
После сборки замените codex в командах упражнений полным путём к этому бинарнику. На Windows используйте путь к codex.exe и адаптируйте команды оболочки. Авторизация и выбранная модель должны быть настроены для запускаемой версии.
Фиксируйте постановку, версию, доступные инструменты, события и фактический результат. Отказ, отсутствие инструмента и последовательное выполнение — тоже результаты опыта. Не называйте сценарий подтверждённым только потому, что он описан в промпте.