Tento průvodce vám pomůže zapnout Daybreak v Codex CLI, nastavit jej pro automatizované pracovní postupy a integrace přes SDK a řešit problémy s přístupem nebo odmítáním požadavků.

Abyste mohli tyto změny využívat, musíte aktualizovat Codex CLI na verzi 0.163.0 nebo novější. Aktualizace CLI jsou dobrovolné: stávající instalace si zachovají dosavadní chování, dokud je neaktualizujete.

Pokud vaše automatizace instaluje @openai/codex@latest, může tuto změnu převzít při příští instalaci nebo aktualizaci. Pokud jste Codex CLI nainstalovali globálně pomocí npm, spusťte npm install -g @openai/codex@latest a poté ověřte aktualizaci příkazem codex --version.
Chcete-li změnu odložit, nastavte pevnou verzi @openai/codex@0.162.0. Jednorázová instalace pomocí @latest se sama neaktualizuje. Pracovní postupy s pevně nastavenými staršími verzemi si zachovají dosavadní chování.
U integrací v TypeScriptu aktualizujte @openai/codex-sdk i přibalené běhové prostředí. U integrací v Pythonu aktualizujte openai-codex i jeho běhové prostředí Codex. Samotná aktualizace globálně nainstalovaného CLI nemusí aktualizovat běhové prostředí SDK. Pokud máte nastavenou vlastní cestu ke spustitelnému souboru, aktualizujte i tento soubor.

S ručně nastavenými ID modelů, která chybí v jinak dostupném katalogu, budou CLI i Codex Desktop nadále automaticky zacházet jako dosud, i když je Daybreak zapnutý. Samotná nepřítomnost těchto ID v katalogu nebrání úspěšnému zpracování požadavku.

Modely pro kybernetickou bezpečnost mohou být v nabídce modelů zpřístupňovány samostatně. Po jejich zpřístupnění uživatelé podporované verze nemusí nic dalšího stahovat, aby se jim nově dostupné modely zobrazily. Seznam obnovíte opětovným otevřením nabídky modelů nebo restartováním Codex.

Zapnutí Daybreak v interaktivním CLI

Spusťte Codex s obvyklým způsobem ověřování.
Daybreak zapnete zadáním /daybreak.
Codex zobrazí zprávu Daybreak je zapnutý. Platí pro nové tahy.
Toto nastavení se použije pro aktivní vlákno a uloží se jako výchozí pro nové relace.
Daybreak vypnete opětovným spuštěním stejného příkazu (/daybreak).

Zapnutí Daybreak v CLI bez interaktivního rozhraní

Pracovní postupy bez interaktivního uživatelského rozhraní obvykle využívají codex exec ve skriptech, naplánovaných úlohách nebo v CI. Interaktivní výzva „Zapnout Daybreak“ (/daybreak) zde není k dispozici. Místo toho můžete:

Zapnout Daybreak pro konkrétní spuštění CLI přidáním -c daybreak=true ke každému příkazu, u kterého chcete omezit odmítání požadavků. Můžete například zadat:

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

Ponechte svůj stávající prompt i ostatní volby příkazu. Toto nastavení přidejte ke každému volání, které má používat Daybreak, včetně příkazů ve skriptech, naplánovaných úlohách a konfiguraci CI.
Nastavit Daybreak jako výchozí pro nové relace a spuštění CLI přidáním daybreak=true do konfiguračního souboru, který Codex načítá.
Výchozí uživatelská konfigurace je v souboru ~/.codex/config.toml. Pokud vaše automatizace nastavuje CODEX_HOME, použijte místo něj $CODEX_HOME/config.toml. Nastavení umístěte na nejvyšší úroveň, mimo sekce jako [features].
Změnu proveďte v prostředí, kde automatizace skutečně běží. Aktualizací konfigurace na svém notebooku nezměníte konfiguraci běhového prostředí CI ani vzdáleného počítače.
Nastavení platí také pro nové interaktivní relace, které používají stejnou konfiguraci. Obnovené a rozvětvené relace si ponechávají uložené nastavení Daybreak; nová výchozí hodnota v konfiguraci ho nepřepíše.
Pamatujte, že nastavení zadané na příkazovém řádku má pro dané volání přednost před uloženou konfigurací. V konfiguraci tedy můžete ponechat daybreak = true a pro jednotlivé spuštění použít -c daybreak=false.

Zapnutí Daybreak při přístupu k poskytovateli inference přes proxy

Daybreak můžete v Codex CLI používat i při směrování požadavků na inferenci přes stávající proxy. Codex samostatným dotazem do katalogu modelů zjišťuje, které modely podporují Daybreak pro váš projekt.

Než začnete, ujistěte se, že máte v Codex CLI funkčního poskytovatele přes proxy a klíč OpenAI API z projektu s přístupem k Daybreak i k modelu, který chcete používat. Potřebujete také Codex CLI v0.167.0.Dokumentace OpenAI k přístupu projektu k Daybreak

Aktualizujte nastavení poskytovatele přes proxy: otevřete ~/.codex/config.toml a najděte sekci [model_providers.<id>] pro svou proxy. Do této sekce přidejte poslední dva řádky z níže uvedeného příkladu. Ponechte stávající ID poskytovatele, URL proxy a nastavení ověřování.

[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

Pokud už vaše konfigurace obsahuje sekci [model_providers.<id>.capabilities], vložte cyber_access_programs = true do ní a model_catalog_url ponechte v nadřazené sekci poskytovatele.Referenční dokumentace konfigurace Codex
Nastavte ověřování dotazů do katalogu výběrem možnosti, která odpovídá přihlašovacím údajům používaným vaším CLI.
1. Pokud Codex používá klíč OpenAI API, ponechte URL katalogu OpenAI z kroku 1. Spusťte Codex s klíčem z projektu s povoleným přístupem k Daybreak, aby se mohl ověřit přímo vůči katalogu.
2. Pokud Codex používá přihlašovací údaje k vaší proxy, nastavte model_catalog_url na úplnou URL trasy katalogu na vaší proxy. Tuto trasu nakonfigurujte tak, aby:
  1. Ověřila požadavek z CLI pomocí vašich obvyklých přihlašovacích údajů k proxy.
  2. Předala požadavek na https://chatgpt.com/backend-api/codex/models s použitím klíče OpenAI API z vašeho projektu s povoleným přístupem k Daybreak.
  3. Vrátila odpověď katalogu do Codex.
Zapněte Daybreak tak, že spustíte novou relaci Codex CLI se svým poskytovatelem přes proxy. Vyberte model, který podporuje Daybreak, a poté Daybreak zapněte zadáním /daybreak.
1. Pokud Daybreak není dostupný, nejprve zkontrolujte dotaz do katalogu. Inference může proběhnout úspěšně, i když požadavek na katalog selže. Ověřte, že požadavek dorazí do OpenAI s klíčem ze zamýšleného projektu a že má tento projekt přístup k Daybreak i k vybranému modelu.

Zapnutí Daybreak pomocí SDK pro TypeScript

Předejte nastavení Daybreak v konfiguraci klienta:

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);

Nastavením daybreak: false vypnete Daybreak a obnovíte běžné chování při odmítání požadavků. Ponechte stávající konfiguraci ověřování.

Zapnutí Daybreak pomocí aplikačního serveru nebo SDK pro Python

1. Načtěte hodnoty availableAccessPrograms.cyber vybraného modelu z model/list a poté nastavte cyberAccessProgram v parametrech turn/start.

a. Pro model z hlavní řady a účet s přístupem k Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Pro model pro kybernetickou bezpečnost a účet s přístupem k Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Pro běžné chování při odmítání požadavků:

{ "cyberAccessProgram": "standard" }

2. Tuto volbu uveďte u každého tahu, pro který má platit; nepředpokládejte, že vynechání parametru Daybreak vypne. Klienti připojení přímo k aplikačnímu serveru musí při inicializaci povolit funkci experimentalApi, aby mohli tento parametr používat.

3. Nízkoúrovňový CodexClient v SDK pro Python může předat stejný parametr:

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. Tento příklad předpokládá, že je Daybreak Blue dostupný pro vybraný model. Klient pro Python má podporu experimentálního API ve výchozím nastavení povolenou. Samotná uložená předvolba vlákna neurčuje program pro tah na aplikačním serveru.

Pokud jste před těmito změnami přidali místní katalog modelů

Pokud se vám dříve po přihlášení pomocí klíče API nezobrazovaly očekávané modely, možná jste přidali místní katalog pomocí model_catalog_json v souboru config.toml. Codex používá tento místní soubor místo automatického katalogu, takže váš seznam modelů může zastarat. Jakmile bude ve vašem prostředí dostupná podpora automatického katalogu, přepněte na něj zpět podle těchto kroků:

Otevřete config.toml. Pro Codex CLI otevřete ~/.codex/config.toml (nebo $CODEX_HOME/config.toml, pokud jste nastavili CODEX_HOME). V Codex Desktop přejděte do Nastavení > Konfigurace a vyberte Otevřít config.toml.
Dočasně vypněte místní katalog. Na začátek řádku model_catalog_json přidejte #, uložte soubor a restartujte Codex se stejným účtem nebo klíčem API. Případnou adresu URL katalogu vyžadovanou vaší organizací ponechte beze změny.
Ověřte svůj přístup. V CLI spusťte codex a poté v relaci zadejte /daybreak. V aplikaci Desktop otevřete pokročilou nabídku modelů a zapněte Daybreak. Pokud máte přístup k Daybreak Red, ověřte, že se zobrazuje očekávaný model pro kybernetickou bezpečnost a že s ním můžete odeslat požadavek.
Ponechte funkční konfiguraci. Pokud ověření proběhne úspěšně, smažte zakomentovaný řádek a soubor uložte. Pokud ověření selže, odstraňte #, uložte soubor a restartujte Codex, čímž obnovíte předchozí nastavení.

Řešení problémů s odmítáním požadavků v CLI

Spusťte typickou úlohu se stejnými přihlašovacími údaji, modelem a konfigurací, jaké používá vaše automatizace.
Pokud Daybreak není dostupný, ověřte, že:
- Váš účet nebo projekt API má přístup k Daybreak.
- Vybraný model podporuje Daybreak.
V interaktivním CLI zkontrolujte, že je Daybreak zapnutý. Pokud je Daybreak dostupný, ale vypnutý, může interaktivní CLI zobrazit zprávu o odmítnutí: Daybreak je momentálně vypnutý. Pokud provádíte autorizované bezpečnostní činnosti, zapněte ho a zkuste požadavek zadat znovu.
- Zobrazí se dotaz Zapnout Daybreak pro příští požadavek? s možnostmi Zapnout Daybreak a Teď ne.
- Vyberte Zapnout Daybreak, čímž ho zapnete pro příští požadavek, a poté požadavek zkuste zadat znovu. Odmítnutý požadavek se automaticky neopakuje; musíte ho zadat znovu. Některé požadavky mohou být odmítnuty i se zapnutým Daybreak.
- Výběrem možnosti Teď ne ponecháte Daybreak vypnutý.
U automatizací ověřte, že se nastavení daybreak=true skutečně předává procesu Codex a že ho nepřepisuje jiné nastavení příkazového řádku.

Použití Daybreak s Codex Security CLI

Codex Security CLI používá k bezpečnostním kontrolám @openai/codex-security. Možnosti nastavení přístupového programu jsou oddělené od obecných příkladů pro Codex CLI uvedených výše.

Pro ověřování pomocí klíče API použijte klíč z projektu API s povoleným přístupem k Daybreak a výslovně vyberte program schválený pro daný projekt. Pro Daybreak Blue:

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

Hodnotu daybreak_red použijte pouze v případě, že má váš projekt schválený přístup k Daybreak Red. Pro standardní ochranná opatření použijte standard. Výběrem programu nezískáte přístup k tomuto programu ani k dalším modelům.

Možnosti ověřování a bezpečnostních kontrol najdete v referenční dokumentaci Codex Security CLI.

Použití Daybreak s Codex Security SDK

Codex Security SDK pro TypeScript (@openai/codex-security) spouští bezpečnostní kontroly z aplikace nebo vývojářského nástroje. Jde o samostatnou sadu, odlišnou od obecné sady Codex SDK popsané výše.

Použijte přihlašovací údaje ke svému schválenému účtu nebo projektu API. Některé požadavky týkající se kybernetické bezpečnosti a chráněná zjištění vyžadují přístup v rámci programu Trusted Access for Cyber. Instalací SDK ani výběrem modelu nezískáte přístup k Daybreak.

Podporované způsoby ověřování, konfiguraci a příklady bezpečnostních kontrol najdete v průvodci Codex Security SDK.

Používání Daybreak v Codex CLI