S tem vodnikom vklopite Daybreak v orodju Codex CLI, ga nastavite za avtomatizirane poteke dela in integracije s SDK ter odpravite težave z dostopom ali zavračanjem zahtev.

Za dostop do teh sprememb morate Codex CLI nadgraditi na različico 0.163.0 ali novejšo. Nadgradnje vmesnika CLI so prostovoljne: obstoječe namestitve do posodobitve ohranijo trenutno delovanje.

Če vaš avtomatizirani postopek namešča @openai/codex@latest, lahko to spremembo prevzame ob naslednji namestitvi ali posodobitvi. Če ste Codex CLI globalno namestili z npm, zaženite npm install -g @openai/codex@latest, nato pa še codex --version, da preverite nadgradnjo.
Če želite spremembo odložiti, nastavite uporabo fiksne različice @openai/codex@0.162.0. Enkratna namestitev z uporabo @latest se ne posodablja samodejno. Delovni tokovi, vezani na starejše različice, ohranijo prejšnje delovanje.
Za integracije v jeziku TypeScript posodobite @openai/codex-sdk in priloženo izvajalno okolje. Za integracije v jeziku Python posodobite openai-codex in njegovo izvajalno okolje Codex. Samo posodobitev globalnega vmesnika CLI morda ne bo posodobila izvajalnega okolja SDK-ja. Če nastavite pot do izvršljive datoteke po meri, posodobite tudi to datoteko.

Ročno nastavljeni ID-ji modelov, ki jih ni v sicer dostopnem katalogu, bodo v vmesniku CLI in aplikaciji Codex Desktop še naprej samodejno obravnavani enako kot prej, tudi ko je Daybreak vklopljen. Zgolj to, da jih ni v katalogu, ne preprečuje uspešne izvedbe zahteve.

Modeli za kibernetsko varnost lahko postanejo na voljo v izbirniku modelov v ločeni uvedbi. Ko so omogočeni, uporabnikom, ki že uporabljajo podprto različico, ni treba ničesar znova prenesti, da bi videli nove modele. Za osvežitev seznama znova odprite izbirnik modelov ali znova zaženite Codex.

Omogočanje funkcije Daybreak v interaktivnem vmesniku CLI

Zaženite Codex z običajnim načinom preverjanja pristnosti.
Za vklop funkcije Daybreak vnesite /daybreak.
Codex bo prikazal sporočilo Daybreak je vklopljen. Velja za nove korake pogovora.
To bo veljalo za aktivno nit in se shranilo kot privzeta nastavitev za nove seje.
Za izklop funkcije Daybreak znova zaženite isti ukaz (/daybreak).

Omogočanje programa Daybreak v CLI brez interaktivnega vmesnika

Poteki dela brez interaktivnega uporabniškega vmesnika se običajno izvajajo z ukazom codex exec v skriptah, načrtovanih opravilih ali okolju CI. Tu ni interaktivnega poziva »Omogoči Daybreak« (/daybreak). Namesto tega lahko:

Omogočite Daybreak za posamezen zagon CLI tako, da vsakemu ukazu, pri katerem želite manj zavrnitev, dodate -c daybreak=true. Vnesete lahko na primer:

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

Ohranite obstoječi poziv in druge možnosti ukaza. To nastavitev dodajte vsakemu klicu, ki naj uporablja Daybreak, vključno z ukazi v skriptah, načrtovanih opravilih in konfiguraciji CI.
Nastavite Daybreak kot privzeto možnost za nove seje in zagone CLI tako, da v konfiguracijsko datoteko, ki jo naloži Codex, dodate daybreak=true.
Privzeta uporabniška konfiguracija je v datoteki ~/.codex/config.toml. Če vaša avtomatizacija nastavi CODEX_HOME, namesto tega uporabite $CODEX_HOME/config.toml. Nastavitev dodajte na najvišjo raven, zunaj razdelkov, kot je [features].
Spremembo izvedite v okolju, v katerem se avtomatizacija dejansko izvaja. S posodobitvijo konfiguracije na prenosniku ne posodobite konfiguracije izvajalnika CI ali oddaljenega računalnika.
Nastavitev velja tudi za nove interaktivne seje, ki uporabljajo isto konfiguracijo. Nadaljevane in razvejane seje ohranijo shranjeno izbiro za Daybreak; nova privzeta nastavitev v konfiguraciji je ne nadomesti.
Upoštevajte, da ima nastavitev v ukazni vrstici pri tem klicu prednost pred shranjeno konfiguracijo. Zato lahko v konfiguraciji ohranite daybreak = true, za posamezen zagon pa uporabite -c daybreak=false.

Omogočanje programa Daybreak pri ponudniku sklepanja prek posredniškega strežnika

Daybreak lahko uporabljate v orodju Codex CLI, medtem ko zahteve za sklepanje usmerjate prek obstoječega posredniškega strežnika. Codex z ločeno poizvedbo v katalogu modelov ugotovi, kateri modeli podpirajo Daybreak za vaš projekt.

Pred začetkom preverite, ali imate v orodju Codex CLI delujočega ponudnika prek posredniškega strežnika, ključ API OpenAI iz projekta z dostopom do programa Daybreak in želenega modela ter različico v0.167.0 orodja Codex CLI.Dokumentacija OpenAI o dostopu projekta do programa Daybreak

Posodobite ponudnika prek posredniškega strežnika tako, da odprete ~/.codex/config.toml in poiščete razdelek [model_providers.<id>] za svoj posredniški strežnik. V ta razdelek dodajte zadnji dve vrstici spodnjega primera. Ohranite obstoječi ID ponudnika, URL posredniškega strežnika in nastavitve preverjanja pristnosti.

[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

Če vaša konfiguracija že vsebuje razdelek [model_providers.<id>.capabilities], vanj dodajte cyber_access_programs = true, model_catalog_url pa ohranite v nadrejenem razdelku ponudnika.Referenčna dokumentacija za konfiguracijo orodja Codex
Nastavite preverjanje pristnosti za poizvedbo v katalogu tako, da izberete možnost, ki ustreza poverilnicam, ki jih uporablja vaš CLI.
1. Če Codex uporablja ključ API OpenAI, ohranite URL kataloga OpenAI iz 1. koraka. Zaženite Codex s ključem iz projekta z omogočenim programom Daybreak, da lahko svojo pristnost preveri neposredno pri katalogu.
2. Če Codex uporablja poverilnice vašega posredniškega strežnika, nastavite model_catalog_url na celotni URL poti do kataloga na svojem posredniškem strežniku. To pot konfigurirajte tako, da:
  1. Preveri pristnost zahteve CLI z vašimi običajnimi poverilnicami za posredniški strežnik.
  2. Posreduje zahtevo na https://chatgpt.com/backend-api/codex/models s ključem API OpenAI iz projekta z omogočenim programom Daybreak.
  3. Vrne odgovor kataloga orodju Codex.
Vklopite Daybreak tako, da začnete novo sejo Codex CLI s svojim ponudnikom prek posredniškega strežnika. Izberite model, ki je upravičen do uporabe programa Daybreak, nato pa vnesite /daybreak, da program vklopite.
1. Če Daybreak ni na voljo, najprej preverite poizvedbo v katalogu. Sklepanje lahko uspe, tudi če zahteva za katalog ne uspe. Preverite, ali zahteva doseže OpenAI s ključem iz predvidenega projekta in ali ima projekt dostop tako do programa Daybreak kot do izbranega modela.

Omogočanje funkcije Daybreak prek SDK-ja za TypeScript

Nastavitev za Daybreak posredujte prek konfiguracije odjemalca:

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

Uporabite daybreak: false, da izklopite Daybreak in uporabite običajno obravnavo zavrnitev. Ohranite obstoječo konfiguracijo preverjanja pristnosti.

Omogočanje funkcije Daybreak prek aplikacijskega strežnika ali SDK-ja za Python

1. Iz model/list preberite vrednosti availableAccessPrograms.cyber za izbrani model, nato v parametrih turn/start nastavite cyberAccessProgram.

a. Za model iz glavne serije in račun z dostopom do Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Za model za kibernetsko varnost in račun z dostopom do Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Za običajno obravnavo zavrnitev:

{ "cyberAccessProgram": "standard" }

2. Izbiro vključite v vsak korak pogovora, ki naj jo uporablja; ne predpostavljajte, da izpustitev parametra izklopi Daybreak. Odjemalci, ki se neposredno povezujejo z aplikacijskim strežnikom, morajo za uporabo tega parametra med inicializacijo omogočiti zmožnost experimentalApi.

3. Nizkonivojski odjemalec CodexClient v SDK-ju za Python lahko posreduje isti parameter:

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. Ta primer predpostavlja, da je Daybreak Blue na voljo za izbrani model. Odjemalec za Python privzeto omogoči zmožnost eksperimentalnega API-ja. Sama shranjena nastavitev niti ne določa programa za korak pogovora na aplikacijskem strežniku.

Če ste pred temi spremembami dodali lokalni katalog modelov

Če se vam po prijavi s ključem API prej niso prikazali pričakovani modeli, ste morda dodali lokalni katalog z nastavitvijo model_catalog_json v datoteki config.toml. Codex namesto samodejnega kataloga uporablja to lokalno datoteko, zato lahko vaš seznam modelov zastara. Ko je v vašem okolju na voljo podpora za samodejni katalog, sledite tem korakom, da preklopite nazaj:

Odprite config.toml. Za Codex CLI odprite ~/.codex/config.toml (ali $CODEX_HOME/config.toml, če ste nastavili CODEX_HOME). V aplikaciji Codex Desktop pojdite v Nastavitve > Konfiguracija, nato izberite Odpri config.toml.
Začasno onemogočite lokalni katalog. Na začetek vrstice model_catalog_json dodajte #, shranite datoteko in znova zaženite Codex z istim računom ali ključem API. Ohranite vse URL-je katalogov, ki jih zahteva vaša organizacija.
Preverite svoj dostop. V vmesniku CLI zaženite codex, nato v seji vnesite /daybreak. V namizni aplikaciji odprite napredni izbirnik modelov in vklopite Daybreak. Če imate dostop do Daybreak Red, preverite, ali se prikaže pričakovani model za kibernetsko varnost in ali lahko z njim pošljete zahtevo.
Ohranite konfiguracijo, ki deluje. Če je preverjanje uspešno, izbrišite onemogočeno vrstico in shranite datoteko. Če ni uspešno, odstranite #, shranite datoteko in znova zaženite Codex, da obnovite prejšnjo nastavitev.

Odpravljanje težav z zavrnitvami v vmesniku CLI

Zaženite značilno opravilo z istimi poverilnicami, modelom in konfiguracijo, kot jih uporablja vaš avtomatizirani postopek.
Če Daybreak ni na voljo, preverite naslednje:
- Vaš račun ali projekt API ima dostop do funkcije Daybreak.
- Izbrani model podpira Daybreak.
V interaktivnem vmesniku CLI preverite, ali je Daybreak vklopljen. Interaktivni vmesnik CLI lahko prikaže sporočilo o zavrnitvi, ko je Daybreak na voljo, vendar izklopljen: Daybreak je trenutno izklopljen. Če opravljate pooblaščeno varnostno delo, ga vklopite in znova pošljite zahtevo.
- Prikaže se vprašanje Želite vklopiti Daybreak za naslednjo zahtevo? z možnostma Omogoči Daybreak in Ne zdaj.
- Izberite Omogoči Daybreak, da ga vklopite za naslednjo zahtevo, nato zahtevo pošljite znova. Upoštevajte, da se zavrnjena zahteva ne ponovi samodejno; poslati jo morate znova. Nekatere zahteve so lahko zavrnjene tudi, ko je Daybreak vklopljen.
- Izberite Ne zdaj, da Daybreak ostane izklopljen.
Pri avtomatiziranih postopkih preverite, ali je nastavitev daybreak=true dejansko posredovana procesu Codex in je ne preglasi druga nastavitev ukazne vrstice.

Uporaba programa Daybreak z orodjem Codex Security CLI

Codex Security CLI za varnostne preglede uporablja @openai/codex-security. Njegove možnosti za programe dostopa so ločene od zgornjih splošnih primerov za Codex CLI.

Za preverjanje pristnosti s ključem API uporabite ključ iz projekta API z omogočenim programom Daybreak in izrecno izberite program, odobren za ta projekt. Za Daybreak Blue:

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

Možnost daybreak_red uporabite le, če je vaš projekt odobren za Daybreak Red, za standardne zaščitne ukrepe pa uporabite standard. Z izbiro programa ne pridobite dostopa do tega programa ali dodatnih modelov.

Možnosti preverjanja pristnosti in pregledovanja najdete v referenčni dokumentaciji za Codex Security CLI.

Uporaba programa Daybreak s kompletom Codex Security SDK

Codex Security TypeScript SDK (@openai/codex-security) izvaja varnostne preglede iz aplikacije ali razvijalskega orodja. Ločen je od zgoraj opisanega splošnega kompleta Codex SDK.

Uporabite poverilnice za svoj odobreni račun ali projekt API. Nekatere zahteve s področja kibernetske varnosti in zaščitene ugotovitve zahtevajo dostop prek programa Trusted Access for Cyber. Z namestitvijo kompleta SDK ali izbiro modela ne pridobite dostopa do programa Daybreak.

Za podprte načine preverjanja pristnosti, konfiguracijo in primere pregledov upoštevajte vodnik za Codex Security SDK.

Uporaba funkcije Daybreak v vmesniku Codex CLI