Скористайтеся цим посібником, щоб увімкнути Daybreak у Codex CLI, налаштувати його для автоматизованих робочих процесів та інтеграцій із SDK і розв’язати проблеми з доступом або відмовами.

Зверніть увагу: щоб отримати доступ до цих змін, потрібно оновити Codex CLI до версії 0.163.0 або новішої. CLI оновлюється лише за вашим рішенням: установлені версії працюватимуть як раніше, доки ви їх не оновите.

Якщо ваша автоматизація встановлює @openai/codex@latest, ця зміна може застосуватися під час наступного встановлення або оновлення. Якщо ви встановили Codex CLI глобально через npm, виконайте npm install -g @openai/codex@latest, а потім codex --version, щоб перевірити оновлення.
Щоб відкласти зміну, зафіксуйте версію @openai/codex@0.162.0. Одноразове встановлення з @latest не забезпечує автоматичних оновлень. Робочі процеси із зафіксованими старішими версіями працюватимуть як раніше.
Для інтеграцій на TypeScript оновіть @openai/codex-sdk і середовище виконання, що входить до його складу. Для інтеграцій на Python оновіть openai-codex і його середовище виконання Codex. Оновлення лише глобально встановленого CLI може не оновити середовище виконання SDK. Якщо ви вказали власний шлях до виконуваного файлу, оновіть і цей файл.

До вручну заданих ідентифікаторів моделей, яких немає в каталозі, хоча сам каталог доступний, і надалі застосовуватимуться попередні правила автоматичної обробки в CLI та Codex Desktop, навіть коли Daybreak увімкнено. Сама лише їх відсутність у каталозі не заважає успішному виконанню запиту.

Моделі для кібербезпеки можуть з’являтися в меню вибору моделей за окремим графіком розгортання. Коли доступ до них буде ввімкнено, користувачам підтримуваної версії не потрібно буде нічого завантажувати, щоб побачити нові доступні моделі. Щоб оновити список, знову відкрийте меню вибору моделей або перезапустіть Codex.

Увімкнення Daybreak в інтерактивному CLI

Запустіть Codex зі звичним способом автентифікації.
Щоб увімкнути Daybreak, введіть /daybreak.
Codex повідомить: Daybreak увімкнено. Застосовується до нових кроків діалогу.
Це налаштування застосовуватиметься до активної гілки діалогу та збережеться як значення за замовчуванням для нових сеансів.
Щоб вимкнути Daybreak, виконайте ту саму команду (/daybreak) ще раз.

Увімкнення Daybreak у неінтерактивному режимі CLI

Неінтерактивні робочі процеси виконуються без інтерактивного інтерфейсу, зазвичай через codex exec у скриптах, завданнях за розкладом або CI. Тут немає інтерактивної пропозиції «Увімкнути Daybreak» (/daybreak). Натомість ви можете:

Увімкнути Daybreak для окремого запуску CLI, додавши -c daybreak=true до кожної команди, для якої потрібно зменшити кількість відмов. Наприклад, можна ввести:

codex exec -c daybreak=true "Review the changes in this repository."

Залиште свій запит та інші параметри команди без змін. Додавайте цей параметр до кожного виклику, який має використовувати Daybreak, зокрема до команд у скриптах, завданнях за розкладом і конфігурації CI.
Увімкнути Daybreak за замовчуванням для нових сеансів і запусків CLI, додавши daybreak=true до файлу конфігурації, який завантажує Codex.
За замовчуванням конфігурація користувача зберігається у файлі ~/.codex/config.toml. Якщо у вашій автоматизації задано CODEX_HOME, натомість використовуйте $CODEX_HOME/config.toml. Розмістіть параметр на верхньому рівні, поза розділами на кшталт [features].
Внесіть зміну в середовищі, де фактично виконується автоматизація. Оновлення конфігурації на вашому ноутбуці не оновлює конфігурацію виконавця CI чи віддаленої машини.
Цей параметр також застосовується до нових інтерактивних сеансів, які використовують ту саму конфігурацію. Відновлені та відгалужені сеанси зберігають попереднє налаштування Daybreak; нове значення за замовчуванням у конфігурації його не замінює.
Зверніть увагу: параметр командного рядка має пріоритет над збереженою конфігурацією для цього виклику. Тож ви можете залишити daybreak = true у конфігурації та використовувати -c daybreak=false для окремого запуску.

Увімкнення Daybreak із провайдером інференсу через проксі

Ви можете використовувати Daybreak у Codex CLI, спрямовуючи запити інференсу через наявний проксі. Codex окремо звертається до каталогу моделей, щоб визначити, які моделі підтримують Daybreak для вашого проєкту.

Перш ніж почати, переконайтеся, що в Codex CLI налаштовано робочого проксі-провайдера, у вас є ключ API OpenAI із проєкту з доступом до Daybreak і потрібної моделі, а також установлено Codex CLI версії v0.167.0.Документація OpenAI щодо доступу проєктів до Daybreak

Оновіть налаштування проксі-провайдера: відкрийте ~/.codex/config.toml і знайдіть розділ [model_providers.<id>] для вашого проксі. Додайте до цього розділу останні два рядки з наведеного нижче прикладу. Залиште наявні ID провайдера, URL-адресу проксі та налаштування автентифікації без змін.

[model_providers.proxy]
name = "Proxied with Cyber"
base_url = "https://<your-proxy>/v1"
model_catalog_url = "<https://chatgpt.com/backend-api/codex/models>"
capabilities.cyber_access_programs = true

Якщо у вашій конфігурації вже є розділ [model_providers.<id>.capabilities], додайте cyber_access_programs = true до нього, а model_catalog_url залиште в батьківському розділі провайдера.Довідник із конфігурації Codex
Налаштуйте автентифікацію для звернення до каталогу, вибравши варіант, що відповідає обліковим даним вашого CLI.
1. Якщо Codex використовує ключ API OpenAI, залиште URL-адресу каталогу OpenAI з кроку 1. Запустіть Codex із ключем від проєкту, у якому ввімкнено Daybreak, щоб він міг пройти автентифікацію безпосередньо в каталозі.
2. Якщо Codex використовує облікові дані вашого проксі, задайте для model_catalog_url повну URL-адресу маршруту каталогу на вашому проксі. Налаштуйте цей маршрут так, щоб він:
  1. Автентифікував запит CLI за допомогою ваших звичайних облікових даних проксі.
  2. Пересилав запит на https://chatgpt.com/backend-api/codex/models, використовуючи ключ API OpenAI із проєкту, у якому ввімкнено Daybreak.
  3. Повертав відповідь каталогу до Codex.
Увімкніть Daybreak, розпочавши новий сеанс Codex CLI з вашим проксі-провайдером. Виберіть модель, для якої доступний Daybreak, а потім введіть /daybreak, щоб увімкнути його.
1. Якщо Daybreak недоступний, спершу перевірте звернення до каталогу. Інференс може працювати успішно, навіть якщо запит до каталогу завершується помилкою. Переконайтеся, що запит надходить до OpenAI з ключем від потрібного проєкту й що цей проєкт має доступ і до Daybreak, і до вибраної моделі.

Увімкнення Daybreak через SDK для TypeScript

Передайте параметр Daybreak через конфігурацію клієнта:

import { Codex } from "@openai/codex-sdk";
const codex = new Codex({
config: { daybreak: true },
});
const thread = codex.startThread();
const result = await thread.run("Review the changes in this repository.");
console.log(result.finalResponse);

Використайте daybreak: false, щоб вимкнути Daybreak і повернутися до звичайних правил відмов. Залиште поточну конфігурацію автентифікації без змін.

Увімкнення Daybreak через сервер застосунків або SDK для Python

1. Отримайте значення availableAccessPrograms.cyber для вибраної моделі з model/list, а потім задайте cyberAccessProgram у параметрах turn/start.

а. Для моделі основної лінійки й облікового запису з доступом до Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

б. Для моделі для кібербезпеки й облікового запису з доступом до Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

в. Для звичайних правил відмов:

{ "cyberAccessProgram": "standard" }

2. Передавайте вибране значення на кожному кроці діалогу, де воно має застосовуватися; не вважайте, що відсутність параметра вимикає Daybreak. Щоб використовувати цей параметр, клієнти, які безпосередньо звертаються до сервера застосунків, мають увімкнути можливість experimentalApi під час ініціалізації.

3. Низькорівневий CodexClient із SDK для Python може передавати той самий параметр:

from openai_codex.client import CodexClient
with CodexClient() as client:
client.initialize()
thread = client.thread_start()
turn = client.turn_start(
thread.thread.id,
"Review the changes in this repository.",
params={"cyberAccessProgram": "daybreakBlue"},
)
client.wait_for_turn_completed(turn.turn.id)

4. У цьому прикладі припускається, що Daybreak Blue доступний для вибраної моделі. Клієнт Python вмикає можливість експериментального API за замовчуванням. Саме лише збережене налаштування гілки діалогу не визначає програму для кроку діалогу на сервері застосунків.

Якщо ви додали локальний каталог моделей до цих змін

Якщо раніше після входу за допомогою ключа API ви не бачили очікуваних моделей, можливо, ви додали локальний каталог через model_catalog_json у файлі config.toml. Codex використовує цей локальний файл замість автоматичного каталогу, тому ваш список моделей може застаріти. Коли у вашому середовищі стане доступною підтримка автоматичного каталогу, виконайте ці дії, щоб повернутися до нього:

Відкрийте config.toml. Для Codex CLI відкрийте ~/.codex/config.toml (або $CODEX_HOME/config.toml, якщо ви задали CODEX_HOME). У Codex Desktop перейдіть до Налаштування > Конфігурація, а потім виберіть Відкрити config.toml.
Тимчасово вимкніть локальний каталог. Додайте # на початку рядка model_catalog_json, збережіть файл і перезапустіть Codex із тим самим обліковим записом або ключем API. Залиште без змін усі URL-адреси каталогів, обов’язкові у вашій організації.
Перевірте свій доступ. У CLI запустіть codex, а потім введіть /daybreak у межах сеансу. У Desktop відкрийте розширене меню вибору моделей і ввімкніть Daybreak. Якщо ви маєте доступ до Daybreak Red, перевірте, чи відображається очікувана модель для кібербезпеки та чи можете ви надіслати їй запит.
Збережіть конфігурацію, що працює. Якщо перевірка успішна, видаліть вимкнений рядок і збережіть файл. Якщо ні, видаліть #, збережіть файл і перезапустіть Codex, щоб відновити попередні налаштування.

Усунення проблем із відмовами в CLI

Запустіть типове завдання з тими самими обліковими даними, моделлю та конфігурацією, які використовує ваша автоматизація.
Якщо Daybreak недоступний, перевірте, чи:
- Ваш обліковий запис або проєкт API має доступ до Daybreak.
- Вибрана модель підтримує Daybreak.
В інтерактивному CLI перевірте, чи ввімкнено Daybreak. Якщо Daybreak доступний, але вимкнений, інтерактивний CLI може показати повідомлення про відмову: Daybreak зараз вимкнено. Якщо ви виконуєте роботи з безпеки з належним дозволом, увімкніть його та повторіть запит.
- З’явиться запитання Увімкнути Daybreak для наступного запиту? з варіантами Увімкнути Daybreak або Не зараз.
- Виберіть Увімкнути Daybreak, щоб увімкнути його для наступного запиту, а потім повторіть запит. Зверніть увагу: відхилений запит не повторюється автоматично — його потрібно надіслати ще раз. Деякі запити можуть отримувати відмову навіть з увімкненим Daybreak.
- Виберіть Не зараз, щоб залишити Daybreak вимкненим.
Для автоматизацій перевірте, чи daybreak=true справді передається процесу Codex і не перевизначається іншим параметром командного рядка.

Використання Daybreak із Codex Security CLI

Codex Security CLI використовує @openai/codex-security для сканування безпеки. Його параметри програм доступу відрізняються від наведених вище загальних прикладів для Codex CLI.

Для автентифікації за ключем API використовуйте ключ із проєкту API, у якому ввімкнено Daybreak, і явно виберіть програму, доступ до якої схвалено для цього проєкту. Для Daybreak Blue:

npx @openai/codex-security scan . --auth api-key --cyber-access-program daybreak_blue

Використовуйте daybreak_red, лише якщо для вашого проєкту схвалено доступ до Daybreak Red, або standard для стандартних захисних обмежень. Вибір програми не надає доступу до неї чи до додаткових моделей.

Відомості про параметри автентифікації та сканування наведено в довіднику Codex Security CLI.

Використання Daybreak із Codex Security SDK

Codex Security SDK для TypeScript (@openai/codex-security) дає змогу запускати сканування безпеки із застосунку чи інструмента розробника. Це окремий SDK, відмінний від описаного вище загального Codex SDK.

Використовуйте облікові дані облікового запису чи проєкту API, для якого схвалено доступ. Для деяких запитів із кібербезпеки та доступу до захищених результатів перевірок потрібна участь у програмі Trusted Access for Cyber. Установлення SDK чи вибір моделі не надає доступу до Daybreak.

Підтримувані способи автентифікації, налаштування та приклади сканування наведено в посібнику з Codex Security SDK.

Використання Daybreak у Codex CLI