U ovom vodiču saznajte kako omogućiti Daybreak u alatu Codex CLI, konfigurirati ga za automatizirane radne procese i integracije sa SDK-om te riješiti probleme s pristupom ili odbijanjem zahtjeva.

Da biste pristupili ovim promjenama, trebate nadograditi Codex CLI na verziju 0.163.0 ili noviju. Nadogradnje CLI-ja nisu automatske: postojeće instalacije zadržavaju dosadašnji način rada dok ih ne ažurirate.

Ako vaša automatizacija instalira @openai/codex@latest, ovu promjenu može preuzeti pri sljedećoj instalaciji ili ažuriranju. Ako ste Codex CLI instalirali globalno putem npm-a, pokrenite npm install -g @openai/codex@latest, a zatim codex --version da biste potvrdili nadogradnju.
Da biste odgodili promjenu, fiksirajte verziju na @openai/codex@0.162.0. Jednokratna instalacija pomoću oznake @latest ne ažurira se sama. Tijekovi rada s fiksiranim starijim verzijama zadržavaju dosadašnji način rada.
Za integracije u TypeScriptu ažurirajte @openai/codex-sdk i priloženo izvršno okruženje. Za integracije u Pythonu ažurirajte openai-codex i njegovo izvršno okruženje za Codex. Samo ažuriranje globalnog CLI-ja možda neće ažurirati izvršno okruženje SDK-a. Ako postavite prilagođeni put do izvršne datoteke, ažurirajte i tu datoteku.

Na ručno postavljene ID-jeve modela koji nisu navedeni u inače dostupnom katalogu CLI i Codex Desktop i dalje će automatski primjenjivati dosadašnja pravila, čak i kada je Daybreak uključen. Sama činjenica da nisu u katalogu ne sprječava uspješno izvršavanje zahtjeva.

Modeli za kibernetičku sigurnost mogu se zasebno uvoditi u izbornik modela. Nakon što se omoguće, korisnici koji već imaju podržanu verziju ne trebaju ništa dodatno preuzimati da bi vidjeli novodostupne modele. Ponovno otvorite izbornik modela ili ponovno pokrenite Codex da biste osvježili popis.

Omogućivanje značajke Daybreak u interaktivnom CLI-ju

Pokrenite Codex uz uobičajeni način autentifikacije.
Da biste uključili Daybreak, unesite /daybreak.
Codex će prikazati poruku Daybreak je uključen. Primjenjuje se na nove korake razgovora.
To će se primijeniti na aktivnu nit razgovora i spremiti kao zadana postavka za nove sesije.
Da biste isključili Daybreak, ponovno pokrenite istu naredbu (/daybreak).

Omogućivanje programa Daybreak u neinteraktivnom načinu rada CLI-ja

Neinteraktivni tijekovi rada izvršavaju se bez interaktivnog korisničkog sučelja, najčešće putem naredbe codex exec u skriptama, zakazanim zadacima ili sustavu za kontinuiranu integraciju (CI). Ovdje nema interaktivnog upita „Omogući Daybreak” (/daybreak). Umjesto toga možete:

Uključiti Daybreak za pojedinačno pokretanje CLI-ja dodavanjem opcije -c daybreak=true svakoj naredbi za koju želite smanjiti učestalost odbijanja zahtjeva. Primjerice, možete unijeti:

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

Zadržite postojeći upit i ostale opcije naredbe. Dodajte tu postavku svakom pozivu koji treba upotrebljavati Daybreak, uključujući naredbe u skriptama, zakazanim zadacima i konfiguraciji CI-ja.
Postaviti Daybreak kao zadanu opciju za nove sesije i pokretanja CLI-ja dodavanjem postavke daybreak=true u konfiguracijsku datoteku koju Codex učitava.
Zadana korisnička konfiguracija nalazi se u datoteci ~/.codex/config.toml. Ako vaša automatizacija postavlja varijablu CODEX_HOME, umjesto toga upotrijebite $CODEX_HOME/config.toml. Postavite tu postavku na najvišu razinu, izvan odjeljaka kao što je [features].
Promjenu napravite u okruženju u kojem se automatizacija doista izvršava. Ažuriranjem konfiguracije prijenosnog računala ne ažurirate konfiguraciju izvršitelja CI zadataka ni udaljenog računala.
Postavka se primjenjuje i na nove interaktivne sesije koje upotrebljavaju istu konfiguraciju. Nastavljene i razgranate sesije zadržavaju spremljeni odabir za Daybreak; nova zadana vrijednost u konfiguraciji ne zamjenjuje ga.
Imajte na umu da postavka navedena u naredbenom retku ima prednost pred spremljenom konfiguracijom za taj poziv. Stoga u konfiguraciji možete zadržati daybreak = true, a za pojedinačno pokretanje upotrijebiti -c daybreak=false.

Omogućivanje programa Daybreak uz pružatelja inferencije putem proxyja

Daybreak možete upotrebljavati u alatu Codex CLI uz usmjeravanje zahtjeva za inferenciju kroz postojeći proxy. Codex zasebno dohvaća katalog modela kako bi utvrdio koji modeli podržavaju Daybreak za vaš projekt.

Prije početka provjerite imate li ispravno postavljenog pružatelja proxyja u alatu Codex CLI, OpenAI API ključ iz projekta s pristupom programu Daybreak i modelu koji želite upotrebljavati te verziju v0.167.0 alata Codex CLI.Dokumentacija OpenAI o pristupu projektu programu Daybreak

Ažurirajte postavke pružatelja proxyja tako da otvorite ~/.codex/config.toml i pronađete odjeljak [model_providers.<id>] za svoj proxy. U taj odjeljak dodajte posljednja dva retka iz primjera u nastavku. Zadržite postojeći ID pružatelja, URL proxyja i postavke autentifikacije.

[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

Ako vaša konfiguracija već sadrži odjeljak [model_providers.<id>.capabilities], u njega dodajte cyber_access_programs = true, a model_catalog_url zadržite u nadređenom odjeljku pružatelja.Referentna dokumentacija za konfiguraciju alata Codex
Postavite autentifikaciju za dohvat kataloga odabirom opcije koja odgovara vjerodajnicama koje upotrebljava vaš CLI.
1. Ako Codex upotrebljava OpenAI API ključ, zadržite URL kataloga OpenAI iz 1. koraka. Pokrenite Codex s ključem iz projekta s omogućenim programom Daybreak kako bi se mogao autentificirati izravno pri pristupu katalogu.
2. Ako Codex upotrebljava vjerodajnice vašeg proxyja, postavite model_catalog_url na puni URL rute za katalog na proxyju. Konfigurirajte tu rutu tako da:
  1. Autentificira zahtjev CLI-ja s pomoću uobičajenih vjerodajnica za proxy.
  2. Proslijedi zahtjev na https://chatgpt.com/backend-api/codex/models uz OpenAI API ključ iz projekta s omogućenim programom Daybreak.
  3. Vrati odgovor kataloga alatu Codex.
Uključite Daybreak tako da pokrenete novu sesiju alata Codex CLI sa svojim pružateljem proxyja. Odaberite model koji podržava Daybreak, a zatim unesite /daybreak da biste ga uključili.
1. Ako Daybreak nije dostupan, najprije provjerite dohvat kataloga. Inferencija može uspjeti čak i ako zahtjev za katalog ne uspije. Provjerite stiže li zahtjev do OpenAI s ključem iz odgovarajućeg projekta te ima li projekt pristup i programu Daybreak i odabranom modelu.

Omogućivanje značajke Daybreak putem SDK-a za TypeScript

Proslijedite postavku za Daybreak putem konfiguracije klijenta:

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

Upotrijebite daybreak: false da biste isključili Daybreak i primjenjivali uobičajena pravila odbijanja zahtjeva. Zadržite postojeću konfiguraciju autentifikacije.

Omogućivanje značajke Daybreak putem aplikacijskog poslužitelja ili SDK-a za Python

1. Pročitajte vrijednosti availableAccessPrograms.cyber odabranog modela iz model/list, a zatim postavite cyberAccessProgram u parametrima za turn/start.

a. Za model iz glavne serije i račun s pristupom programu Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Za model za kibernetičku sigurnost i račun s pristupom programu Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Za uobičajena pravila odbijanja zahtjeva:

{ "cyberAccessProgram": "standard" }

2. Uključite odabranu vrijednost u svaki korak razgovora na koji se treba primijeniti; nemojte pretpostaviti da izostavljanje parametra isključuje Daybreak. Klijenti koji se izravno povezuju s aplikacijskim poslužiteljem moraju tijekom inicijalizacije omogućiti značajku experimentalApi da bi mogli upotrebljavati ovaj parametar.

3. CodexClient, niskorazinski klijent u SDK-u za Python, može proslijediti isti parametar:

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. U ovom se primjeru pretpostavlja da je Daybreak Blue dostupan za odabrani model. Klijent za Python prema zadanim postavkama omogućuje značajku eksperimentalnog API-ja. Sama spremljena postavka niti razgovora ne određuje program za korak razgovora na aplikacijskom poslužitelju.

Ako ste prije ovih promjena dodali lokalni katalog modela

Ako vam se nakon prijave API ključem prije nisu prikazivali očekivani modeli, možda ste dodali lokalni katalog pomoću postavke model_catalog_json u datoteci config.toml. Codex upotrebljava tu lokalnu datoteku umjesto automatskog kataloga, pa vaš popis modela može zastarjeti. Kada podrška za automatski katalog postane dostupna u vašem okruženju, slijedite ove korake da biste se vratili na njega:

Otvorite config.toml. Za Codex CLI otvorite ~/.codex/config.toml (ili $CODEX_HOME/config.toml ako ste postavili CODEX_HOME). U aplikaciji Codex Desktop otvorite Postavke > Konfiguracija, a zatim odaberite Otvori config.toml.
Privremeno onemogućite lokalni katalog. Dodajte # na početak retka model_catalog_json, spremite datoteku i ponovno pokrenite Codex s istim računom ili API ključem. Ostavite nepromijenjene sve URL-ove kataloga koje vaša organizacija zahtijeva.
Provjerite pristup. U CLI-ju pokrenite codex, a zatim unutar sesije unesite /daybreak. U aplikaciji Desktop otvorite napredni izbornik modela i uključite Daybreak. Ako imate pristup programu Daybreak Red, provjerite prikazuje li se očekivani model za kibernetičku sigurnost i možete li putem njega poslati zahtjev.
Zadržite konfiguraciju koja radi. Ako je provjera uspješna, izbrišite redak koji ste onemogućili i spremite datoteku. Ako nije, uklonite #, spremite datoteku i ponovno pokrenite Codex da biste vratili prethodne postavke.

Rješavanje problema s odbijanjem zahtjeva u CLI-ju

Pokrenite reprezentativan zadatak s istim vjerodajnicama, modelom i konfiguracijom koje upotrebljava vaša automatizacija.
Ako Daybreak nije dostupan, provjerite sljedeće:
- Vaš račun ili API projekt ima pristup značajci Daybreak.
- Odabrani model podržava Daybreak.
U interaktivnom CLI-ju provjerite je li Daybreak uključen. Interaktivni CLI može prikazati poruku o odbijanju kada je Daybreak dostupan, ali isključen: Daybreak je trenutačno isključen. Ako obavljate ovlaštene sigurnosne aktivnosti, uključite ga i ponovno pošaljite zahtjev.
- Prikazuje se upit Uključiti Daybreak za sljedeći zahtjev? s opcijama Omogući Daybreak i Ne sada.
- Odaberite Omogući Daybreak da biste ga uključili za sljedeći zahtjev, a zatim ponovno pošaljite zahtjev. Odbijeni zahtjev ne šalje se ponovno automatski; morate ga ponovno poslati. Neki zahtjevi mogu biti odbijeni i kada je Daybreak uključen.
- Odaberite Ne sada da bi Daybreak ostao isključen.
Za automatizacije provjerite prosljeđuje li se daybreak=true samom procesu Codex i nadjačava li tu postavku neka druga postavka naredbenog retka.

Upotreba programa Daybreak uz Codex Security CLI

Codex Security CLI upotrebljava @openai/codex-security za sigurnosna skeniranja. Njegove opcije programa pristupa odvojene su od prethodno navedenih općih primjera za Codex CLI.

Za autentifikaciju API ključem upotrijebite ključ iz API projekta s omogućenim programom Daybreak i izričito odaberite program odobren za taj projekt. Za Daybreak Blue:

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

Upotrijebite daybreak_red samo ako je vaš projekt odobren za Daybreak Red, odnosno standard za standardne zaštitne mjere. Odabirom programa ne dobivate pristup tom programu ni dodatnim modelima.

Opcije autentifikacije i skeniranja potražite u referentnoj dokumentaciji za Codex Security CLI.

Upotreba programa Daybreak uz Codex Security SDK

Codex Security SDK za TypeScript (@openai/codex-security) pokreće sigurnosna skeniranja iz aplikacije ili razvojnog alata. Odvojen je od prethodno opisanog općeg SDK-a za Codex.

Upotrijebite vjerodajnice za odobreni račun ili API projekt. Za neke zahtjeve povezane s kibernetičkom sigurnošću i zaštićene nalaze potreban je Trusted Access for Cyber. Instalacijom SDK-a ili odabirom modela ne dobivate pristup programu Daybreak.

Podržane načine autentifikacije, konfiguraciju i primjere skeniranja potražite u vodiču za Codex Security SDK.

Upotreba značajke Daybreak u Codex CLI-ju