Tämän oppaan avulla otat Daybreakin käyttöön Codex CLI:ssä, määrität sen automatisoituja työnkulkuja ja SDK-integraatioita varten sekä selvität käyttöoikeuksiin tai kieltäytymisiin liittyviä ongelmia.

Huomaa, että näiden muutosten käyttöönotto edellyttää päivittämistä Codex CLI:n versioon 0.163.0 tai uudempaan. CLI:n päivitykset ovat vapaaehtoisia: nykyiset asennukset toimivat entiseen tapaan, kunnes päivität ne.

Jos automaatiosi asentaa paketin @openai/codex@latest, muutos voi tulla käyttöön seuraavan asennuksen tai päivityksen yhteydessä. Jos asensit Codex CLI:n globaalisti npm:llä, suorita npm install -g @openai/codex@latest ja varmista sitten päivitys suorittamalla codex --version.
Voit lykätä muutosta lukitsemalla versioksi @openai/codex@0.162.0. Kertaluonteinen asennus määrityksellä @latest ei päivity itsestään. Vanhempiin versioihin lukitut työnkulut toimivat entiseen tapaan.
Päivitä TypeScript-integraatioissa @openai/codex-sdk ja sen mukana toimitettava suoritusympäristö. Päivitä Python-integraatioissa openai-codex ja sen Codex-suoritusympäristö. Pelkkä globaalin CLI-asennuksen päivittäminen ei välttämättä päivitä SDK:n suoritusympäristöä. Jos määrität suoritettavalle tiedostolle mukautetun polun, päivitä myös kyseinen tiedosto.

Manuaalisesti määritettyjen mallitunnusten aiempi automaattinen käsittely säilyy CLI:ssä ja Codex Desktopissa, jos tunnukset puuttuvat muuten saatavilla olevasta luettelosta, vaikka Daybreak olisi käytössä. Pelkkä tunnusten puuttuminen luettelosta ei estä pyynnön onnistumista.

Kyberturvallisuusmallit saatetaan tuoda mallivalitsimeen erikseen. Kun mallit ovat saatavilla, tuettua versiota jo käyttävät näkevät ne ilman uutta latausta. Päivitä luettelo avaamalla mallivalitsin uudelleen tai käynnistämällä Codex uudelleen.

Ota Daybreak käyttöön vuorovaikutteisessa CLI:ssä

Käynnistä Codex käyttäen tavallista todennustapaasi.
Ota Daybreak käyttöön kirjoittamalla /daybreak.
Codex ilmoittaa: Daybreak on käytössä. Koskee uusia vuoroja.
Asetus koskee aktiivista ketjua, ja se tallennetaan uusien istuntojen oletukseksi.
Poista Daybreak käytöstä suorittamalla sama komento (/daybreak) uudelleen.

Ota Daybreak käyttöön ei-interaktiivisessa CLI-ajossa

Ei-interaktiiviset työnkulut suoritetaan ilman vuorovaikutteista käyttöliittymää, yleensä komennolla codex exec skripteissä, ajastetuissa tehtävissä tai CI-ympäristössä. Tällöin vuorovaikutteinen ”Ota Daybreak käyttöön” -kehote (/daybreak) ei ole käytettävissä. Sen sijaan voit:

Ottaa Daybreakin käyttöön yksittäisessä CLI-ajossa lisäämällä valitsimen -c daybreak=true jokaiseen komentoon, jossa haluat vähentää kieltäytymisiä. Voit esimerkiksi kirjoittaa:

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

Säilytä nykyinen kehote ja komennon muut valitsimet. Lisää tämä asetus jokaiseen kutsuun, jossa haluat käyttää Daybreakia, myös skriptien, ajastettujen tehtävien ja CI-määritysten komentoihin.
Asettaa Daybreakin oletukseksi uusille CLI-istunnoille ja -ajoille lisäämällä asetuksen daybreak=true Codexin lataamaan määritystiedostoon.
Käyttäjäkohtainen määritystiedosto on oletusarvoisesti ~/.codex/config.toml. Jos automaatiossasi on asetettu CODEX_HOME, käytä sen sijaan tiedostoa $CODEX_HOME/config.toml. Sijoita asetus ylimmälle tasolle, osioiden kuten [features] ulkopuolelle.
Tee muutos siinä ympäristössä, jossa automaatio todella suoritetaan. Kannettavasi määritysten päivittäminen ei päivitä CI-suorittajan tai etäkoneen määrityksiä.
Asetus koskee myös uusia vuorovaikutteisia istuntoja, jotka käyttävät samaa määritystiedostoa. Jatketut ja haarautetut istunnot säilyttävät tallennetun Daybreak-valintansa, eikä uusi oletusasetus korvaa sitä.
Huomaa, että komentorivillä annettu asetus ohittaa tallennetun määrityksen kyseisen kutsun ajaksi. Voit siis pitää määritystiedostossa asetuksen daybreak = true ja käyttää yksittäisessä ajossa valitsinta -c daybreak=false.

Daybreakin käyttöönotto välityspalvelimen kautta käytettävällä päättelypalvelulla

Voit käyttää Daybreakia Codex CLI:ssä ja reitittää päättelypyynnöt nykyisen välityspalvelimesi kautta. Codex selvittää erillisellä malliluettelohaulla, mitkä mallit tukevat Daybreakia projektissasi.

Varmista ennen aloittamista, että Codex CLI:ssä on toimiva välityspalveluntarjoajan määritys ja että sinulla on OpenAI-API-avain projektista, jolla on pääsy Daybreakiin ja haluamaasi malliin. Tarvitset myös Codex CLI:n version v0.167.0.OpenAI:n ohjeet projektin Daybreak-käyttöoikeudesta

Päivitä välityspalveluntarjoajan määritys avaamalla ~/.codex/config.toml ja etsimällä välityspalvelimesi [model_providers.<id>]-osio. Lisää alla olevan esimerkin kaksi viimeistä riviä kyseiseen osioon. Säilytä nykyinen palveluntarjoajan tunnus, välityspalvelimen URL-osoite ja todennusasetukset.

[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

Jos määritystiedostossasi on jo [model_providers.<id>.capabilities]-osio, lisää cyber_access_programs = true siihen ja jätä model_catalog_url ylemmän tason palveluntarjoajaosioon.Codexin määritysten viiteopas
Määritä luettelohaun todennus valitsemalla CLI:n käyttämiä tunnistetietoja vastaava vaihtoehto.
1. Jos Codex käyttää OpenAI-API-avainta, säilytä vaiheessa 1 annettu OpenAI:n luettelon URL-osoite. Suorita Codex sen projektin avaimella, jossa Daybreak on käytössä, jotta Codex voi todentautua suoraan luettelopalveluun.
2. Jos Codex käyttää välityspalvelimesi tunnistetietoja, aseta model_catalog_url-arvoksi välityspalvelimesi luetteloreitin täydellinen URL-osoite. Määritä reitti tekemään seuraavat toimet:
  1. Todenna CLI-pyyntö välityspalvelimesi tavanomaisilla tunnistetiedoilla.
  2. Välitä pyyntö osoitteeseen https://chatgpt.com/backend-api/codex/models käyttäen OpenAI-API-avainta projektista, jossa Daybreak on käytössä.
  3. Palauta luettelopalvelun vastaus Codexille.
Ota Daybreak käyttöön aloittamalla uusi Codex CLI -istunto välityspalveluntarjoajallasi. Valitse Daybreakia tukeva malli ja ota Daybreak käyttöön kirjoittamalla /daybreak.
1. Jos Daybreak ei ole käytettävissä, tarkista ensin luettelohaun toiminta. Päättely voi onnistua, vaikka luettelopyyntö epäonnistuisi. Varmista, että pyyntö saapuu OpenAI:lle tarkoitetun projektin avaimella ja että projektilla on pääsy sekä Daybreakiin että valittuun malliin.

Ota Daybreak käyttöön TypeScript SDK:n kautta

Välitä Daybreak-asetus asiakasohjelman asetuksissa:

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

Poista Daybreak käytöstä ja palauta normaali kieltäytymiskäytäntö asetuksella daybreak: false. Säilytä nykyiset todennusasetuksesi.

Ota Daybreak käyttöön sovelluspalvelimen tai Python SDK:n kautta

1. Lue valitun mallin availableAccessPrograms.cyber-arvot model/list-vastauksesta ja määritä sitten cyberAccessProgram kutsun turn/start parametreissa.

a. Kun käytössä on perusmalli ja tili, jolla on Daybreak Blue -käyttöoikeus:

{ "cyberAccessProgram": "daybreakBlue" }

b. Kun käytössä on kyberturvallisuusmalli ja tili, jolla on Daybreak Red -käyttöoikeus:

{ "cyberAccessProgram": "daybreakRed" }

c. Normaali kieltäytymiskäytäntö:

{ "cyberAccessProgram": "standard" }

2. Sisällytä valinta jokaiseen vuoroon, jossa sitä tarvitaan. Älä oleta, että parametrin pois jättäminen poistaa Daybreakin käytöstä. Suoraan sovelluspalvelimeen yhteydessä olevien asiakasohjelmien on otettava experimentalApi-ominaisuus käyttöön alustuksen aikana, jotta ne voivat käyttää tätä parametria.

3. Python SDK:n matalan tason CodexClient voi välittää saman parametrin:

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. Tässä esimerkissä oletetaan, että Daybreak Blue on saatavilla valitulle mallille. Python-asiakasohjelma ottaa kokeellisen API-ominaisuuden käyttöön oletusarvoisesti. Pelkkä ketjuun tallennettu asetus ei valitse ohjelmaa sovelluspalvelimen vuorolle.

Jos lisäsit paikallisen malliluettelon ennen näitä muutoksia

Jos API-avaimella kirjautuminen ei aiemmin näyttänyt odottamiasi malleja, olet saattanut lisätä paikallisen luettelon config.toml-tiedoston model_catalog_json-asetuksella. Codex käyttää tätä paikallista tiedostoa automaattisen luettelon sijaan, joten malliluettelosi voi vanhentua. Kun automaattisen luettelon tuki on saatavilla ympäristössäsi, palaa sen käyttöön seuraavasti:

Avaa config.toml. Jos käytät Codex CLI:tä, avaa ~/.codex/config.toml (tai $CODEX_HOME/config.toml, jos olet määrittänyt muuttujan CODEX_HOME). Siirry Codex Desktopissa kohtaan Asetukset > Määritykset ja valitse sitten Avaa config.toml.
Poista paikallinen luettelo tilapäisesti käytöstä. Lisää # merkin model_catalog_json sisältävän rivin alkuun, tallenna tiedosto ja käynnistä Codex uudelleen samalla tilillä tai API-avaimella. Säilytä mahdollinen organisaatiosi edellyttämä luettelon URL-osoite.
Tarkista käyttöoikeutesi. Käynnistä CLI:ssä codex ja kirjoita sitten istunnossa /daybreak. Avaa Desktopissa mallivalitsimen lisäasetukset ja ota Daybreak käyttöön. Jos sinulla on Daybreak Red -käyttöoikeus, varmista, että odottamasi kyberturvallisuusmalli näkyy ja että voit lähettää pyynnön sitä käyttäen.
Säilytä toimivat asetukset. Jos tarkistus onnistuu, poista käytöstä poistamasi rivi ja tallenna tiedosto. Jos tarkistus epäonnistuu, palauta aiemmat asetuksesi poistamalla #, tallentamalla tiedosto ja käynnistämällä Codex uudelleen.

Kieltäytymisten vianmääritys CLI:ssä

Suorita tyypillinen tehtävä samoilla tunnistetiedoilla, mallilla ja asetuksilla kuin automaatiossasi.
Jos Daybreak ei ole saatavilla, varmista seuraavat asiat:
- Tililläsi tai API-projektillasi on Daybreak-käyttöoikeus.
- Valittu malli tukee Daybreakia.
Tarkista vuorovaikutteisessa CLI:ssä, että Daybreak on käytössä. Vuorovaikutteinen CLI voi näyttää kieltäytymisviestin, kun Daybreak on saatavilla mutta pois käytöstä: Daybreak on tällä hetkellä pois käytöstä. Jos teet valtuutettua tietoturvatyötä, ota se käyttöön ja yritä pyyntöäsi uudelleen.
- Näkyviin tulee kysymys Otetaanko Daybreak käyttöön seuraavaa pyyntöäsi varten? ja vaihtoehdot Ota Daybreak käyttöön ja Ei nyt.
- Valitse Ota Daybreak käyttöön, niin se on käytössä seuraavassa pyynnössäsi. Yritä sitten pyyntöä uudelleen. Huomaa, että hylättyä pyyntöä ei yritetä automaattisesti uudelleen, vaan sinun on lähetettävä se uudelleen. Joistakin pyynnöistä saatetaan silti kieltäytyä, vaikka Daybreak olisi käytössä.
- Valitse Ei nyt, jos haluat jättää Daybreakin pois käytöstä.
Varmista automaatioissa, että daybreak=true välittyy varsinaiselle Codex-prosessille eikä toinen komentoriviasetus ohita sitä.

Käytä Daybreakia Codex Security CLI:ssä

Codex Security CLI käyttää tietoturvatarkistuksiin pakettia @openai/codex-security. Sen käyttöoikeusohjelmien valinnat ovat erillisiä edellä esitetyistä yleisistä Codex CLI -esimerkeistä.

Kun todennat API-avaimella, käytä avainta API-projektista, jossa Daybreak on käytössä, ja valitse erikseen ohjelma, johon projektille on myönnetty pääsy. Daybreak Blue -ohjelmalle komento on:

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

Käytä arvoa daybreak_red vain, jos projektillesi on myönnetty pääsy Daybreak Red -ohjelmaan. Arvolla standard käytetään tavanomaisia suojatoimia. Ohjelman valitseminen ei anna pääsyä kyseiseen ohjelmaan tai muihin malleihin.

Katso todennus- ja tarkistusvaihtoehdot Codex Security CLI:n viiteoppaasta.

Käytä Daybreakia Codex Security SDK:ssa

Codex Securityn TypeScript SDK:n (@openai/codex-security) avulla voi suorittaa tietoturvatarkistuksia sovelluksesta tai kehittäjätyökalusta. Se on erillinen edellä kuvatusta yleisestä Codex SDK:sta.

Käytä hyväksytyn tilisi tai API-projektisi tunnistetietoja. Jotkin kyberturvallisuuspyynnöt ja suojatut löydökset edellyttävät Trusted Access for Cyber -käyttöoikeutta. SDK:n asentaminen tai mallin valitseminen ei anna pääsyä Daybreakiin.

Katso tuetut todennus- ja määritystavat sekä tarkistusesimerkit Codex Security SDK:n oppaasta.

Daybreakin käyttö Codex CLI:ssä