Az útmutató segít engedélyezni a Daybreaket a Codex CLI-ben, beállítani automatizált munkafolyamatokhoz és SDK-integrációkhoz, valamint elhárítani a hozzáférési és válaszmegtagadási problémákat.

A változások eléréséhez a Codex CLI 0.163.0-s vagy újabb verziójára kell frissítened. A CLI frissítése nem automatikus: a meglévő telepítések működése a frissítésig változatlan marad.

Ha az automatizált folyamatod az @openai/codex@latest csomagot telepíti, a következő telepítéskor vagy frissítéskor már életbe léphet ez a változás. Ha a Codex CLI-t globálisan, npm-mel telepítetted, futtasd az npm install -g @openai/codex@latest parancsot, majd a codex --version paranccsal ellenőrizd a frissítést.
A változás elhalasztásához rögzítsd a verziót erre: @openai/codex@0.162.0. Az @latest használatával egyszer telepített csomag nem frissíti önmagát. A régebbi verziókhoz rögzített munkafolyamatok működése változatlan marad.
TypeScript-integrációk esetén frissítsd az @openai/codex-sdk csomagot és a hozzá mellékelt futtatókörnyezetet. Python-integrációk esetén frissítsd az openai-codex csomagot és annak Codex-futtatókörnyezetét. Önmagában a globális CLI frissítése nem feltétlenül frissíti az SDK futtatókörnyezetét. Ha egyéni elérési utat állítottál be a végrehajtható fájlhoz, frissítsd az ott található fájlt is.

Az egyébként elérhető katalógusból hiányzó, kézzel beállított modellazonosítókat a CLI és a Codex Desktop továbbra is a korábbi automatikus módon kezeli, még bekapcsolt Daybreak esetén is. Önmagában az, hogy nem szerepelnek a katalógusban, nem akadályozza a kérés sikeres végrehajtását.

A kiberbiztonsági modellek külön ütemezés szerint válhatnak elérhetővé a modellválasztóban. Amint elérhetővé válnak, a már támogatott verziót használóknak nem kell újabb letöltés ahhoz, hogy lássák az új modelleket. A lista frissítéséhez nyisd meg újra a modellválasztót, vagy indítsd újra a Codexet.

A Daybreak bekapcsolása az interaktív CLI-ben

Indítsd el a Codexet a megszokott hitelesítési móddal.
A Daybreak bekapcsolásához írd be a /daybreak parancsot.
A Codex ezt jelzi vissza: A Daybreak bekapcsolva. Az új körökre érvényes.
Ez az aktív szálra lesz érvényes, és az új munkamenetek alapértelmezett beállításaként is mentésre kerül.
A Daybreak kikapcsolásához futtasd újra ugyanazt a parancsot (/daybreak).

A Daybreak engedélyezése nem interaktív CLI-módban

A nem interaktív munkafolyamatok interaktív felhasználói felület nélkül futnak, jellemzően a codex exec paranccsal, szkriptekben, ütemezett feladatokban vagy CI-környezetben. Itt nem jelenik meg interaktív „Daybreak engedélyezése” (/daybreak) kérdés. Ehelyett a következőket teheted:

Engedélyezd a Daybreak használatát egy adott CLI-futtatáshoz: add hozzá a -c daybreak=true beállítást minden olyan parancshoz, amelynél kevesebb elutasítást szeretnél. Például ezt írhatod be:

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

A meglévő utasítást és a parancs többi beállítását hagyd meg. Add hozzá ezt a beállítást minden olyan parancshíváshoz, amelynek a Daybreak használatával kell futnia, beleértve a szkriptekben, ütemezett feladatokban és CI-konfigurációkban szereplő parancsokat is.
Tedd alapértelmezetté a Daybreak használatát az új CLI-munkamenetekhez és -futtatásokhoz: add hozzá a daybreak=true beállítást a Codex által betöltött konfigurációs fájlhoz.
Az alapértelmezett felhasználói konfigurációs fájl a ~/.codex/config.toml. Ha az automatizálásod beállítja a CODEX_HOME változót, akkor helyette a $CODEX_HOME/config.toml fájlt használd. A beállítást a legfelső szinten helyezd el, az olyan szakaszokon kívül, mint a [features].
Abban a környezetben végezd el a módosítást, ahol az automatizálás ténylegesen fut. A laptopod konfigurációjának frissítése nem frissíti a CI-futtatókörnyezet vagy egy távoli gép konfigurációját.
A beállítás az ugyanazt a konfigurációt használó új interaktív munkamenetekre is érvényes. A folytatott és elágaztatott munkamenetek megőrzik a mentett Daybreak-beállításukat; ezt a konfiguráció új alapértéke nem írja felül.
Ne feledd, hogy a parancssori beállítás az adott parancshívásnál felülírja a mentett konfigurációt. Így a konfigurációban megtarthatod a daybreak = true beállítást, egy adott futtatáshoz pedig használhatod a -c daybreak=false beállítást.

A Daybreak engedélyezése proxyn keresztül elért inferenciaszolgáltatóval

A Daybreak használható a Codex CLI-ben úgy is, hogy az inferenciakéréseket a meglévő proxydon keresztül továbbítod. A Codex külön lekérdezi a modellkatalógust, hogy megállapítsa, mely modellek támogatják a Daybreak használatát a projektedben.

Mielőtt elkezded, győződj meg arról, hogy van működő proxyszolgáltatód a Codex CLI-ben, valamint OpenAI API-kulcsod egy olyan projektből, amely hozzáfér a Daybreakhez és a használni kívánt modellhez. Emellett a Codex CLI v0.167.0 verziójára is szükséged lesz.OpenAI-dokumentáció a projektek Daybreak-hozzáféréséről

Frissítsd a proxyszolgáltatód beállításait: nyisd meg a ~/.codex/config.toml fájlt, és keresd meg a proxydhoz tartozó [model_providers.<id>] szakaszt. Add hozzá az alábbi példa utolsó két sorát ehhez a szakaszhoz. Tartsd meg a meglévő szolgáltatóazonosítót, proxy-URL-t és hitelesítési beállításokat.

[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

Ha a konfigurációdban már van [model_providers.<id>.capabilities] szakasz, helyezd oda a cyber_access_programs = true beállítást, a model_catalog_url beállítást pedig hagyd a szolgáltató szülőszakaszában.A Codex konfigurációs referenciadokumentációja
Állítsd be a katalóguslekérdezés hitelesítését: válaszd a CLI által használt hitelesítő adatoknak megfelelő lehetőséget.
1. Ha a Codex OpenAI API-kulcsot használ, tartsd meg az 1. lépésben megadott OpenAI-katalógus URL-jét. Futtasd a Codexet annak a projektnek a kulcsával, amelyben engedélyezve van a Daybreak, hogy közvetlenül hitelesíthesse magát a katalógusnál.
2. Ha a Codex a proxyd hitelesítő adatait használja, állítsd a model_catalog_url értékét a proxyd egyik katalógusútvonalának teljes URL-jére. Állítsd be az útvonalat úgy, hogy:
  1. A szokásos proxyhitelesítő adataiddal hitelesítse a CLI-kérést.
  2. Továbbítsa a kérést a https://chatgpt.com/backend-api/codex/models címre annak a projektnek az OpenAI API-kulcsával, amelyben engedélyezve van a Daybreak.
  3. Visszaküldje a katalógus válaszát a Codexnek.
Kapcsold be a Daybreaket: indíts új Codex CLI-munkamenetet a proxyszolgáltatóddal. Válassz egy Daybreak használatára jogosult modellt, majd a bekapcsoláshoz írd be a /daybreak parancsot.
1. Ha a Daybreak nem érhető el, először a katalóguslekérdezést ellenőrizd. Az inferencia akkor is sikeres lehet, ha a katalóguslekérdezés sikertelen. Ellenőrizd, hogy a kérés a megfelelő projekt kulcsával érkezik-e az OpenAI-hoz, és hogy a projekt hozzáfér-e mind a Daybreakhez, mind a kiválasztott modellhez.

A Daybreak bekapcsolása a TypeScript SDK-val

Add át a Daybreak beállítását a klienskonfigurációban:

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

A daybreak: false beállítással kikapcsolhatod a Daybreaket, és visszatérhetsz a szokásos elutasítási működéshez. Hagyd meg a meglévő hitelesítési konfigurációdat.

A Daybreak bekapcsolása az alkalmazásszerverrel vagy a Python SDK-val

1. Olvasd ki a kiválasztott modell availableAccessPrograms.cyber értékeit a model/list válaszából, majd állítsd be a cyberAccessProgram értékét a turn/start paraméterei között.

a. Általános modell és Daybreak Blue-hozzáféréssel rendelkező fiók esetén:

{ "cyberAccessProgram": "daybreakBlue" }

b. Kiberbiztonsági modell és Daybreak Red-hozzáféréssel rendelkező fiók esetén:

{ "cyberAccessProgram": "daybreakRed" }

c. A szokásos elutasítási működéshez:

{ "cyberAccessProgram": "standard" }

2. Minden olyan körben add meg a választott értéket, amelyben használni szeretnéd; ne feltételezd, hogy a paraméter elhagyása kikapcsolja a Daybreaket. Az alkalmazásszerverhez közvetlenül kapcsolódó klienseknek az inicializálás során engedélyezniük kell az experimentalApi funkciót a paraméter használatához.

3. A Python SDK alacsony szintű CodexClient kliense ugyanezt a paramétert tudja átadni:

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. Ez a példa feltételezi, hogy a Daybreak Blue elérhető a kiválasztott modellhez. A Python-kliens alapértelmezés szerint engedélyezi a kísérleti API-funkciót. Önmagában a szálhoz mentett beállítás nem választ ki programot az alkalmazásszerveren indított körhöz.

Ha a változások előtt helyi modellkatalógust adtál hozzá

Ha korábban az API-kulccsal való bejelentkezés után nem jelentek meg a várt modellek, előfordulhat, hogy hozzáadtál egy helyi katalógust a config.toml fájl model_catalog_json beállításával. A Codex ezt a helyi fájlt használja az automatikus katalógus helyett, így a modelllistád elavulhat. Amint az automatikus katalógus támogatása elérhetővé válik a környezetedben, az alábbi lépésekkel válthatsz vissza:

Nyisd meg a config.toml fájlt. A Codex CLI esetén nyisd meg a ~/.codex/config.toml fájlt (vagy a $CODEX_HOME/config.toml fájlt, ha beállítottad a CODEX_HOME változót). A Codex Desktopban lépj a Beállítások > Konfiguráció menüpontra, majd válaszd a config.toml megnyitása lehetőséget.
Ideiglenesen kapcsold ki a helyi katalógust. Tegyél egy # jelet a model_catalog_json sor elejére, mentsd a fájlt, majd indítsd újra a Codexet ugyanazzal a fiókkal vagy API-kulccsal. A szervezeted által előírt katalógus-URL-eket hagyd változatlanul.
Ellenőrizd a hozzáférésedet. A CLI-ben indítsd el a codex parancsot, majd a munkamenetben írd be a /daybreak parancsot. A Desktopban nyisd meg a Speciális modellválasztót, és kapcsold be a Daybreaket. Ha rendelkezel Daybreak Red-hozzáféréssel, ellenőrizd, hogy megjelenik-e a várt kiberbiztonsági modell, és tudsz-e kérést küldeni vele.
Tartsd meg a működő konfigurációt. Ha az ellenőrzés sikeres, töröld a kikapcsolt sort, és mentsd a fájlt. Ha sikertelen, távolítsd el a # jelet, mentsd a fájlt, majd indítsd újra a Codexet a korábbi beállítások visszaállításához.

Elutasítások hibaelhárítása a CLI-ben

Futtass egy jellemző feladatot az automatizált folyamatodban használt hitelesítő adatokkal, modellel és konfigurációval.
Ha a Daybreak nem érhető el, ellenőrizd a következőket:
- A fiókod vagy az API-projekted rendelkezik Daybreak-hozzáféréssel.
- A kiválasztott modell támogatja a Daybreaket.
Az interaktív CLI-ben ellenőrizd, hogy a Daybreak be van-e kapcsolva. Ha a Daybreak elérhető, de ki van kapcsolva, az interaktív CLI elutasító üzenetet jeleníthet meg: A Daybreak jelenleg ki van kapcsolva. Ha engedéllyel végzel biztonsági munkát, kapcsold be, és próbáld újra a kérésedet.
- A megjelenő kérdés: Bekapcsolod a Daybreaket a következő kérésedhez? A választható lehetőségek: Daybreak bekapcsolása vagy Most nem.
- Válaszd a Daybreak bekapcsolása lehetőséget a következő kéréshez való bekapcsoláshoz, majd próbáld újra a kérést. Az elutasított kérés nem indul újra automatikusan; újra el kell küldened. Egyes kéréseket bekapcsolt Daybreak mellett is elutasíthat a rendszer.
- Válaszd a Most nem lehetőséget, ha kikapcsolva szeretnéd hagyni a Daybreaket.
Automatizált folyamatoknál ellenőrizd, hogy a daybreak=true beállítás valóban eljut-e a Codex-folyamathoz, és nem írja-e felül egy másik parancssori beállítás.

A Daybreak használata a Codex Security CLI-vel

A Codex Security CLI az @openai/codex-security csomagot használja a biztonsági vizsgálatokhoz. Hozzáférési programokra vonatkozó beállításai elkülönülnek a fenti általános Codex CLI-példáktól.

API-kulcsos hitelesítéshez használj olyan API-projekthez tartozó kulcsot, amelyben engedélyezve van a Daybreak, és kifejezetten válaszd ki a projekthez jóváhagyott programot. A Daybreak Blue esetében:

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

A daybreak_red értéket csak akkor használd, ha a projekted jóváhagyást kapott a Daybreak Red használatára; a szokásos védelmi intézkedésekhez a standard értéket válaszd. Egy program kiválasztása nem biztosít hozzáférést sem az adott programhoz, sem további modellekhez.

A hitelesítési és vizsgálati beállításokat a Codex Security CLI referenciadokumentációjában találod.

A Daybreak használata a Codex Security SDK-val

A Codex Security TypeScript SDK (@openai/codex-security) alkalmazásból vagy fejlesztői eszközből futtat biztonsági vizsgálatokat. Ez különálló eszköz a fent ismertetett általános Codex SDK-tól.

A jóváhagyott fiókod vagy API-projekted hitelesítő adatait használd. Egyes kiberbiztonsági kérésekhez és védett vizsgálati eredményekhez Trusted Access for Cyber hozzáférés szükséges. Az SDK telepítése vagy egy modell kiválasztása nem biztosít Daybreak-hozzáférést.

A támogatott hitelesítési módokhoz, a konfiguráláshoz és a vizsgálati példákhoz kövesd a Codex Security SDK útmutatóját.

A Daybreak használata a Codex CLI-ben