Термины

Поток или Тред (thread)

Идентифицируемая история работы агента и связанное с ней состояние в Codex. Поток и тред — синонимы. Поток может включать несколько ходов выполнения и не обязательно отображается пользователю как переписка. ThreadId обозначает объект приложения, а не поток или процесс операционной системы.

Поток и тред в этом справочнике означают один объект. Он может использоваться в терминале, программном запуске или системе из нескольких агентов. Наличие потока не требует видимого диалога с человеком или обмена репликами между несколькими сторонами.

Зачем нужен отдельный идентификатор

Вы можете продолжить работу с сохранённой историей потока. ThreadManager умеет создавать и получать потоки. Новый субагент получает дочерний тред; при fork часть истории может наследоваться.

История и исполняемая сессия

Сохранённый поток может существовать, пока вычисления не идут. Загруженная сессия содержит состояние выполнения. Поэтому перечисление потоков, число активных агентов и число запросов к модели — разные показатели.

Проверка своей интеграции

Для обработки нескольких независимых заявок отдельные потоки позволяют не смешивать их истории. При этом изоляция данных и файлов требует собственных правил. Разные ThreadId не означают разные рабочие каталоги или права.

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

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

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

  • codex-rs/core/src/thread_manager.rs — start_thread. Создаёт поток и связанную сессию.
  • codex-rs/exec/src/cli.rs — Command. CLI поддерживает продолжение и fork.

Практика: различить поток и ход

Найдите создание потока и команды продолжения.

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

Команды для изучения исходников
rg -n 'pub async fn start_thread|pub async fn get_thread|spawn_child_thread' codex-rs/core/src/thread_manager.rs
rg -n 'Resume|Fork' codex-rs/exec/src/cli.rs

Что найти: Управление thread существует отдельно от run_turn.

Вопрос для проверки: Если отправить два сообщения в один поток, появятся ли обязательно два ThreadId?

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

Нет. Один поток может содержать несколько ходов; новое сообщение может также направляться в текущий ход через механизм steering.

Написать мне