See juhend aitab aktiveerida Daybreaki Codex CLI-s, seadistada seda automatiseeritud töövoogude ja SDK-integratsioonide jaoks ning lahendada juurdepääsu või mudeli keeldumistega seotud probleeme.

Nende muudatuste kasutamiseks pead uuendama Codex CLI versioonile 0.163.0 või uuemale. CLI uuendamine on vabatahtlik: olemasolevad paigaldused toimivad senisel viisil, kuni neid uuendad.

Kui sinu automatiseeritud töövoog paigaldab paketi @openai/codex@latest, võib see muudatus rakenduda järgmisel paigaldamisel või uuendamisel. Kui paigaldasid Codex CLI globaalselt npm-i abil, käivita npm install -g @openai/codex@latest ja seejärel uuenduse kontrollimiseks codex --version.
Muudatuse edasilükkamiseks fikseeri versiooniks @openai/codex@0.162.0. Ühekordne paigaldus tähisega @latest ei uuenda end ise. Vanematele versioonidele fikseeritud töövood toimivad senisel viisil edasi.
TypeScripti integratsioonide puhul uuenda paketti @openai/codex-sdk ja sellega kaasas olevat käituskeskkonda. Pythoni integratsioonide puhul uuenda paketti openai-codex ja selle Codexi käituskeskkonda. Ainult globaalse CLI uuendamine ei pruugi SDK käituskeskkonda uuendada. Kui oled määranud täitmisfailile kohandatud tee, uuenda ka seda täitmisfaili.

Käsitsi määratud mudeli-ID-sid, mis puuduvad muidu kättesaadavast kataloogist, käsitletakse CLI-s ja Codex Desktopis automaatselt senisel viisil ka siis, kui Daybreak on sisse lülitatud. Ainuüksi nende puudumine kataloogist ei takista päringu õnnestumist.

Küberturbemudelid võidakse mudelivalikusse lisada eraldi etapis. Kui need on lubatud, ei pea toetatud versiooni kasutajad uute kättesaadavate mudelite nägemiseks midagi uuesti alla laadima. Loendi värskendamiseks ava mudelivalik uuesti või taaskäivita Codex.

Daybreaki lubamine interaktiivses CLI-s

Käivita Codex tavapärase autentimisviisiga.
Daybreaki sisselülitamiseks sisesta /daybreak.
Codex kuvab teate Daybreak on. Applies to new turns.
See rakendub aktiivsele vestluslõimele ja salvestatakse uute seansside vaikesättena.
Daybreaki väljalülitamiseks käivita sama käsk (/daybreak) uuesti.

Daybreaki lubamine interaktiivse liideseta CLI-s

Interaktiivse kasutajaliideseta töövood käivitatakse tavaliselt käsuga codex exec skriptides, ajastatud töödes või pidevintegratsioonis (CI). Siin ei kuvata interaktiivset küsimust „Luba Daybreak“ (/daybreak). Selle asemel saad teha järgmist.

Luba Daybreak konkreetseks CLI käivituseks, lisades parameetri -c daybreak=true igale käsule, mille puhul soovid vähem keeldumisi. Näiteks võid sisestada:

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

Jäta olemasolev viip ja muud käsuvalikud alles. Lisa see säte igale käivituskäsule, mis peaks kasutama Daybreaki, sealhulgas skriptides, ajastatud töödes ja CI seadistuses olevatele käskudele.
Määra Daybreak uute CLI-seansside ja käivituste vaikevalikuks, lisades sätte daybreak=true Codexi laaditavasse seadistusfaili.
Kasutaja vaikeseadistus asub failis ~/.codex/config.toml. Kui sinu automatiseerimislahendus määrab muutuja CODEX_HOME, kasuta selle asemel faili $CODEX_HOME/config.toml. Paiguta säte tipptasemele, väljapoole jaotisi nagu [features].
Tee muudatus keskkonnas, kus automatiseeritud töö tegelikult käib. Sülearvuti seadistuse muutmine ei muuda CI käivituskeskkonna ega kaugarvuti seadistust.
Säte kehtib ka uutele interaktiivsetele seanssidele, mis kasutavad sama seadistust. Jätkatud ja hargnenud seanssides säilib salvestatud Daybreaki valik; uus vaikeväärtus seda ei asenda.
Pane tähele, et käsureal määratud säte tühistab selle käivituse ajaks salvestatud seadistuse. Seega võid jätta seadistusse daybreak = true ja kasutada üksiku käivituse jaoks parameetrit -c daybreak=false.

Daybreaki lubamine puhverserveri kaudu kasutatava inferentsiteenuse pakkujaga

Saad kasutada Daybreaki Codex CLI-s, suunates samal ajal inferentsipäringud läbi oma olemasoleva puhverserveri. Codex teeb mudelite kataloogi eraldi päringu, et selgitada välja, millised mudelid sinu projektis Daybreaki toetavad.

Enne alustamist veendu, et sul on Codex CLI-s toimiv puhverserveri kaudu kasutatav teenusepakkuja, OpenAI API-võti projektist, millel on juurdepääs nii Daybreakile kui ka soovitud mudelile, ning Codex CLI versioon v0.167.0.OpenAI dokumentatsioon projektile Daybreaki juurdepääsu andmise kohta

Uuenda puhverserveri kaudu kasutatava teenusepakkuja seadistust: ava ~/.codex/config.toml ja leia oma puhverserveri jaotis [model_providers.<id>]. Lisa sellesse jaotisse alloleva näite kaks viimast rida. Jäta olemasolev teenusepakkuja ID, puhverserveri URL ja autentimissätted alles.

[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

Kui sinu seadistuses on juba jaotis [model_providers.<id>.capabilities], lisa cyber_access_programs = true sinna ja jäta model_catalog_url teenusepakkuja ülemjaotisse.Codexi seadistuse teatmik
Autendi kataloogipäring, valides variandi, mis vastab sinu CLI kasutatavale identimisteabele.
1. Kui Codex kasutab OpenAI API-võtit, jäta alles 1. sammus toodud OpenAI kataloogi URL. Käivita Codex oma Daybreaki juurdepääsuga projekti võtmega, et see saaks end otse kataloogis autentida.
2. Kui Codex kasutab sinu puhverserveri identimisteavet, määra model_catalog_url väärtuseks oma puhverserveri kataloogimarsruudi täielik URL. Seadista see marsruut nii, et see teeks järgmist:
  1. Autendiks CLI päringu sinu tavapärase puhverserveri identimisteabega.
  2. Edastaks päringu aadressile https://chatgpt.com/backend-api/codex/models, kasutades sinu Daybreaki juurdepääsuga projekti OpenAI API-võtit.
  3. Tagastaks kataloogi vastuse Codexile.
Lülita Daybreak sisse, alustades uut Codex CLI seanssi oma puhverserveri kaudu kasutatava teenusepakkujaga. Vali mudel, millega on lubatud Daybreaki kasutada, ja sisesta seejärel /daybreak, et Daybreak sisse lülitada.
1. Kui Daybreak pole saadaval, kontrolli kõigepealt kataloogipäringut. Inferents võib õnnestuda ka siis, kui kataloogipäring nurjub. Veendu, et päring jõuaks OpenAI-ni õige projekti võtmega ning et projektil oleks juurdepääs nii Daybreakile kui ka valitud mudelile.

Daybreaki lubamine TypeScripti SDK kaudu

Edasta Daybreaki säte kliendi seadistuse kaudu:

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

Daybreaki väljalülitamiseks ja tavapäraste keeldumisreeglite kasutamiseks määra daybreak: false. Jäta olemasolev autentimisseadistus alles.

Daybreaki lubamine rakendusserveri või Pythoni SDK kaudu

1. Loe valitud mudeli availableAccessPrograms.cyber väärtused vastusest model/list, seejärel määra cyberAccessProgram päringu turn/start parameetrites.

a. Põhisarja mudeli ja Daybreak Blue juurdepääsuga konto puhul:

{ "cyberAccessProgram": "daybreakBlue" }

b. Küberturbemudeli ja Daybreak Redi juurdepääsuga konto puhul:

{ "cyberAccessProgram": "daybreakRed" }

c. Tavapäraste keeldumisreeglite kasutamiseks:

{ "cyberAccessProgram": "standard" }

2. Lisa valik igasse vestlusvooru, kus seda kasutada soovid; ära eelda, et parameetri väljajätmine lülitab Daybreaki välja. Otse rakendusserveriga ühenduvad kliendid peavad selle parameetri kasutamiseks lubama lähtestamisel võimekuse experimentalApi.

3. Pythoni SDK madala taseme CodexClient saab edastada sama parameetri:

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. See näide eeldab, et Daybreak Blue on valitud mudeli jaoks saadaval. Pythoni klient lubab eksperimentaalse API võimekuse vaikimisi. Üksnes vestluslõime salvestatud eelistus ei määra rakendusserveri vestlusvoorus kasutatavat programmi.

Kui lisasid kohaliku mudelikataloogi enne neid muudatusi

Kui API-võtmega sisselogimisel ei kuvatud varem oodatud mudeleid, võisid lisada kohaliku kataloogi faili config.toml sätte model_catalog_json kaudu. Codex kasutab automaatse kataloogi asemel seda kohalikku faili, mistõttu võib sinu mudeliloend aeguda. Kui automaatse kataloogi tugi on sinu keskkonnas saadaval, järgi sellele tagasilülitumiseks neid samme:

Ava config.toml. Codex CLI puhul ava ~/.codex/config.toml (või $CODEX_HOME/config.toml, kui oled määranud muutuja CODEX_HOME). Codex Desktopis ava Sätted > Seadistus ja vali seejärel Ava config.toml.
Keela kohalik kataloog ajutiselt. Lisa rea model_catalog_json algusesse #, salvesta fail ja taaskäivita Codex sama konto või API-võtmega. Jäta alles kõik kataloogi URL-id, mida sinu organisatsioon nõuab.
Kontrolli oma juurdepääsu. CLI-s käivita codex ja sisesta seejärel seansi sees /daybreak. Töölauarakenduses ava täpsem mudelivalik ja lülita Daybreak sisse. Kui sul on juurdepääs Daybreak Redile, kontrolli, et oodatud küberturbemudel ilmuks loendisse ja saaksid sellega päringu saata.
Jäta toimiv seadistus alles. Kui kontroll õnnestub, kustuta keelatud rida ja salvesta fail. Kui kontroll ebaõnnestub, eemalda #, salvesta fail ja taaskäivita Codex, et taastada eelmine seadistus.

Keeldumistega seotud tõrkeotsing CLI-s

Käivita tüüpiline ülesanne samade autentimisandmete, mudeli ja seadistusega, mida kasutab sinu automatiseeritud töövoog.
Kui Daybreak pole saadaval, kontrolli järgmist:
- Sinu kontol või API-projektil on juurdepääs Daybreakile.
- Valitud mudel toetab Daybreaki.
Interaktiivses CLI-s kontrolli, et Daybreak oleks sisse lülitatud. Interaktiivne CLI võib näidata keeldumisteadet, kui Daybreak on saadaval, kuid välja lülitatud: Daybreak is currently off. If you’re doing authorized security work, turn it on and try your request again.
- Kuvatakse küsimus Turn on Daybreak for your next request? ning valikud Enable Daybreak ja Not now.
- Vali Luba Daybreak, et lülitada see järgmise päringu jaoks sisse, ja proovi seejärel päringut uuesti. Pane tähele, et tagasilükatud päringut ei korrata automaatselt; pead selle ise uuesti esitama. Mõnest päringust võidakse siiski keelduda ka siis, kui Daybreak on sisse lülitatud.
- Vali Mitte praegu, et jätta Daybreak välja lülitatuks.
Automatiseeritud töövoogude puhul kontrolli, et daybreak=true jõuaks tegeliku Codexi protsessini ja mõni muu käsureasäte seda ei alistaks.

Daybreaki kasutamine Codex Security CLI-ga

Codex Security CLI kasutab turvaskannideks paketti @openai/codex-security. Selle juurdepääsuprogrammi valikud on eraldi eespool toodud üldistest Codex CLI näidetest.

API-võtmega autentimiseks kasuta võtit API-projektist, millel on Daybreaki juurdepääs, ja vali selgesõnaliselt sellele projektile lubatud programm. Daybreak Blue korral:

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

Kasuta väärtust daybreak_red ainult siis, kui sinu projektil on Daybreak Redi kasutamise luba, või väärtust standard tavapäraste kaitsemeetmete jaoks. Programmi valimine ei anna juurdepääsu sellele programmile ega täiendavatele mudelitele.

Autentimis- ja skannimisvalikud leiad Codex Security CLI teatmikust.

Daybreaki kasutamine Codex Security SDK-ga

Codex Security TypeScripti SDK (@openai/codex-security) käivitab turvaskanne rakendusest või arendustööriistast. See on eespool kirjeldatud üldisest Codex SDK-st eraldi.

Kasuta juurdepääsuloa saanud konto või API-projekti identimisteavet. Mõned küberturvalisuse päringud ja kaitstud leiud nõuavad juurdepääsu programmile Trusted Access for Cyber. SDK installimine ega mudeli valimine ei anna Daybreaki juurdepääsu.

Toetatud autentimisviisid, seadistusjuhised ja skannimisnäited leiad Codex Security SDK juhendist.

Daybreaki kasutamine Codex CLI-s