Urmează acest ghid pentru a activa Daybreak în Codex CLI, a-l configura pentru fluxuri de lucru automatizate și integrări prin SDK și a rezolva problemele de acces sau refuzurile.

Reține că, pentru a beneficia de aceste modificări, trebuie să actualizezi Codex CLI la versiunea 0.163.0 sau una ulterioară. Actualizările CLI sunt opționale: instalările existente își păstrează comportamentul actual până când le actualizezi.

Dacă automatizarea ta instalează @openai/codex@latest, poate prelua această modificare la următoarea instalare sau actualizare. Dacă ai instalat Codex CLI la nivel global cu npm, rulează npm install -g @openai/codex@latest, apoi rulează codex --version pentru a confirma actualizarea.
Pentru a amâna modificarea, fixează versiunea la @openai/codex@0.162.0. O instalare efectuată o singură dată folosind @latest nu se actualizează automat. Fluxurile de lucru fixate la versiuni mai vechi își păstrează comportamentul anterior.
Pentru integrările TypeScript, actualizează @openai/codex-sdk și mediul de execuție inclus. Pentru integrările Python, actualizează openai-codex și mediul său de execuție Codex. Este posibil ca simpla actualizare a CLI-ului instalat global să nu actualizeze mediul de execuție al unui SDK. Dacă configurezi o cale personalizată către un executabil, actualizează și executabilul respectiv.

ID-urile de model configurate manual care lipsesc dintr-un catalog altfel disponibil vor fi tratate automat ca înainte în CLI și Codex Desktop, chiar și atunci când Daybreak este activat. Simpla lor absență din catalog nu împiedică procesarea cu succes a unei cereri.

Modelele de securitate cibernetică pot fi introduse treptat, separat, în selectorul de modele. Odată activat accesul, utilizatorii care folosesc deja o versiune compatibilă nu trebuie să descarce nimic în plus pentru a vedea modelele nou disponibile. Redeschide selectorul de modele sau repornește Codex pentru a reîmprospăta lista.

Activarea Daybreak în CLI-ul interactiv

Pornește Codex folosind metoda obișnuită de autentificare.
Pentru a activa Daybreak, introdu /daybreak.
Codex va afișa Daybreak este activat. Se aplică turelor noi.
Această setare se va aplica firului de conversație activ și va fi salvată ca opțiune implicită pentru sesiunile noi.
Pentru a dezactiva Daybreak, rulează din nou aceeași comandă (/daybreak).

Activează Daybreak în CLI fără interfață interactivă

Fluxurile de lucru de tip headless rulează fără o interfață interactivă, de obicei prin codex exec în scripturi, sarcini programate sau procese de integrare continuă (CI). Aici nu apare mesajul interactiv „Activează Daybreak” (/daybreak). În schimb, poți:

Activa Daybreak pentru o anumită rulare CLI adăugând -c daybreak=true la fiecare comandă pentru care vrei mai puține refuzuri. De exemplu, poți introduce:

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

Păstrează solicitarea existentă și celelalte opțiuni ale comenzii. Adaugă această setare la fiecare apel care trebuie să folosească Daybreak, inclusiv la comenzile din scripturi, sarcini programate și configurația CI.
Seta Daybreak ca opțiune implicită pentru noile sesiuni și rulări CLI adăugând daybreak=true în fișierul de configurare încărcat de Codex.
Fișierul implicit de configurare a utilizatorului este ~/.codex/config.toml. Dacă automatizarea ta setează CODEX_HOME, folosește în schimb $CODEX_HOME/config.toml. Plasează setarea la nivelul superior, în afara secțiunilor precum [features].
Fă modificarea în mediul în care rulează efectiv automatizarea. Actualizarea configurației laptopului tău nu actualizează configurația unui executant CI sau a unei mașini la distanță.
Setarea se aplică și noilor sesiuni interactive care folosesc aceeași configurație. Sesiunile reluate și cele ramificate păstrează opțiunea Daybreak salvată; o nouă valoare implicită din configurație nu o înlocuiește.
Reține că o setare din linia de comandă are prioritate față de configurația salvată pentru apelul respectiv. Prin urmare, poți păstra daybreak = true în configurație și poți folosi -c daybreak=false pentru o anumită rulare.

Activarea Daybreak cu un furnizor de inferență accesat prin proxy

Poți folosi Daybreak în Codex CLI direcționând cererile de inferență prin proxy-ul existent. Codex interoghează separat catalogul de modele pentru a afla ce modele acceptă Daybreak pentru proiectul tău.

Înainte de a începe, asigură-te că ai un furnizor proxy funcțional în Codex CLI, o cheie API OpenAI dintr-un proiect cu acces la Daybreak și la modelul pe care vrei să-l folosești, precum și versiunea v0.167.0 a Codex CLI.Documentația OpenAI despre accesul proiectelor la Daybreak

Actualizează furnizorul proxy deschizând ~/.codex/config.toml și găsind secțiunea [model_providers.<id>] pentru proxy-ul tău. Adaugă ultimele două linii din exemplul de mai jos în acea secțiune. Păstrează ID-ul furnizorului, adresa URL a proxy-ului și setările de autentificare existente.

[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

Dacă în configurație există deja o secțiune [model_providers.<id>.capabilities], adaugă cyber_access_programs = true acolo și păstrează model_catalog_url în secțiunea părinte a furnizorului.Documentație de referință pentru configurarea Codex
Autentifică interogarea catalogului alegând opțiunea care corespunde datelor de autentificare folosite de CLI.
1. Dacă Codex folosește o cheie API OpenAI, păstrează adresa URL a catalogului OpenAI de la pasul 1. Rulează Codex cu cheia din proiectul tău cu Daybreak activat, astfel încât să se poată autentifica direct la catalog.
2. Dacă Codex folosește datele de autentificare ale proxy-ului tău, setează model_catalog_url la adresa URL completă a unei rute de catalog de pe proxy-ul tău. Configurează acea rută astfel încât:
  1. Să autentifice cererea CLI folosind datele tale obișnuite de autentificare pentru proxy.
  2. Să redirecționeze cererea către https://chatgpt.com/backend-api/codex/models folosind cheia API OpenAI din proiectul tău cu Daybreak activat.
  3. Să returneze răspunsul catalogului către Codex.
Activează Daybreak pornind o nouă sesiune Codex CLI cu furnizorul tău proxy. Selectează un model eligibil pentru Daybreak, apoi introdu /daybreak pentru a activa funcția.
1. Dacă Daybreak nu este disponibil, verifică mai întâi interogarea catalogului. Inferența poate reuși chiar și atunci când cererea către catalog eșuează. Verifică dacă cererea ajunge la OpenAI cu o cheie din proiectul vizat și dacă proiectul are acces atât la Daybreak, cât și la modelul selectat.

Activarea Daybreak prin SDK-ul TypeScript

Transmite setarea Daybreak prin configurația clientului:

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

Folosește daybreak: false pentru a dezactiva Daybreak și a reveni la comportamentul obișnuit de refuz. Păstrează configurația de autentificare existentă.

Activarea Daybreak prin serverul de aplicații sau SDK-ul Python

1. Citește valorile availableAccessPrograms.cyber ale modelului selectat din model/list, apoi setează cyberAccessProgram în parametrii turn/start.

a. Pentru un model din gama principală și un cont cu acces la Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Pentru un model de securitate cibernetică și un cont cu acces la Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Pentru comportamentul obișnuit de refuz:

{ "cyberAccessProgram": "standard" }

2. Include opțiunea selectată la fiecare tură care ar trebui să o folosească; nu presupune că omiterea parametrului dezactivează Daybreak. Clienții care se conectează direct la serverul de aplicații trebuie să activeze funcționalitatea experimentalApi în timpul inițializării pentru a folosi acest parametru.

3. CodexClient, clientul de nivel scăzut al SDK-ului Python, poate transmite același parametru:

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. Acest exemplu presupune că Daybreak Blue este disponibil pentru modelul selectat. Clientul Python activează implicit funcționalitatea API experimentală. O preferință salvată pentru firul de conversație nu este suficientă pentru a selecta un program pentru o tură pe serverul de aplicații.

Dacă ai adăugat un catalog local de modele înainte de aceste modificări

Dacă autentificarea cu o cheie API nu afișa anterior modelele așteptate, este posibil să fi adăugat un catalog local folosind model_catalog_json în config.toml. Codex folosește acel fișier local în locul catalogului automat, așa că lista ta de modele poate deveni învechită. Odată ce mediul tău acceptă catalogul automat, urmează acești pași pentru a reveni la el:

Deschide config.toml. Pentru Codex CLI, deschide ~/.codex/config.toml (sau $CODEX_HOME/config.toml dacă ai setat CODEX_HOME). În Codex Desktop, accesează Setări > Configurație, apoi selectează Deschide config.toml.
Dezactivează temporar catalogul local. Adaugă # la începutul liniei model_catalog_json, salvează fișierul și repornește Codex cu același cont sau aceeași cheie API. Păstrează neschimbate toate adresele URL de catalog impuse de organizația ta.
Verifică accesul. În CLI, pornește codex, apoi introdu /daybreak în sesiune. În Desktop, deschide selectorul avansat de modele și activează Daybreak. Dacă ai acces la Daybreak Red, verifică dacă apare un model de securitate cibernetică așteptat și dacă poți trimite o cerere folosindu-l.
Păstrează configurația funcțională. Dacă verificarea reușește, șterge linia pe care ai dezactivat-o și salvează fișierul. Dacă nu reușește, elimină #, salvează și repornește Codex pentru a restabili configurația anterioară.

Depanarea refuzurilor în CLI

Rulează o sarcină reprezentativă cu aceleași date de autentificare, același model și aceeași configurație ca automatizarea ta.
Dacă Daybreak nu este disponibil, verifică următoarele:
- Contul sau proiectul tău API are acces la Daybreak.
- Modelul selectat acceptă Daybreak.
În CLI-ul interactiv, verifică dacă Daybreak este activat. CLI-ul interactiv poate afișa un mesaj de refuz atunci când Daybreak este disponibil, dar dezactivat: Daybreak este dezactivat momentan. Dacă desfășori activități de securitate autorizate, activează-l și trimite din nou cererea.
- Mesajul afișează întrebarea Activezi Daybreak pentru următoarea cerere? și oferă opțiunile Activează Daybreak sau Nu acum.
- Selectează Activează Daybreak pentru a-l activa pentru următoarea cerere, apoi trimite din nou cererea. Reține că cererea refuzată nu este retrimisă automat; trebuie să o trimiți din nou. Unele cereri pot fi refuzate în continuare, chiar dacă Daybreak este activat.
- Selectează Nu acum pentru a lăsa Daybreak dezactivat.
Pentru automatizări, verifică dacă daybreak=true ajunge la procesul Codex efectiv și nu este suprascris de o altă setare din linia de comandă.

Folosește Daybreak cu Codex Security CLI

Codex Security CLI folosește @openai/codex-security pentru scanări de securitate. Opțiunile sale pentru programele de acces sunt separate de exemplele generale pentru Codex CLI de mai sus.

Pentru autentificarea cu o cheie API, folosește o cheie dintr-un proiect API cu Daybreak activat și selectează explicit programul aprobat pentru acel proiect. Pentru Daybreak Blue:

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

Folosește daybreak_red doar dacă proiectul tău este aprobat pentru Daybreak Red sau standard pentru măsurile de protecție standard. Selectarea unui program nu îți acordă acces la acel program sau la modele suplimentare.

Consultă documentația de referință pentru Codex Security CLI pentru opțiunile de autentificare și scanare.

Folosește Daybreak cu Codex Security SDK

SDK-ul TypeScript pentru Codex Security (@openai/codex-security) execută scanări de securitate dintr-o aplicație sau dintr-un instrument de dezvoltare. Acesta este separat de SDK-ul general Codex descris mai sus.

Folosește datele de autentificare pentru contul sau proiectul API aprobat. Unele cereri de securitate cibernetică și rezultate protejate necesită Trusted Access for Cyber. Instalarea SDK-ului sau selectarea unui model nu îți acordă acces la Daybreak.

Consultă ghidul Codex Security SDK pentru metodele de autentificare acceptate, configurare și exemple de scanare.

Utilizarea Daybreak în Codex CLI