Bu kılavuzla Codex CLI'da Daybreak'i etkinleştirin, otomatik iş akışları ve SDK entegrasyonları için yapılandırın, erişim sorunlarını veya modelin istekleri reddetmesiyle ilgili sorunları giderin.

Bu değişikliklerden yararlanmak için Codex CLI 0.163.0 veya daha yeni bir sürüme yükseltmeniz gerekir. CLI yükseltmeleri isteğe bağlıdır: Mevcut kurulumlar, siz güncelleyene kadar aynı şekilde çalışmaya devam eder.

Otomasyonunuz @openai/codex@latest paketini yüklüyorsa bir sonraki yükleme veya güncellemede bu değişikliği alabilir. Codex CLI'ı npm ile global olarak yüklediyseniz npm install -g @openai/codex@latest komutunu çalıştırın, ardından yükseltmeyi doğrulamak için codex --version komutunu çalıştırın.
Değişikliği ertelemek için sürümü @openai/codex@0.162.0 olarak sabitleyin. @latest kullanılarak yapılan tek seferlik bir yükleme kendiliğinden güncellenmez. Eski sürümlere sabitlenmiş iş akışları önceki gibi çalışmaya devam eder.
TypeScript entegrasyonları için @openai/codex-sdk paketini ve onunla birlikte gelen çalışma zamanını güncelleyin. Python entegrasyonları için openai-codex paketini ve paketin Codex çalışma zamanını güncelleyin. Yalnızca global CLI'ı güncellemek, SDK'nın çalışma zamanını güncellemeyebilir. Özel bir yürütülebilir dosya yolu yapılandırdıysanız o dosyayı da güncelleyin.

Kataloğa erişilebildiği hâlde katalogda yer almayan, elle yapılandırılmış model kimlikleri CLI ve Codex Desktop'ta, Daybreak AÇIK olsa bile, önceki otomatik işleyişe göre ele alınmaya devam eder. Bu kimliklerin katalogda bulunmaması, tek başına bir isteğin başarılı olmasını engellemez.

Siber modellerin model seçicide kullanıma sunulması ayrı bir takvimle gerçekleşebilir. Bu modeller kullanıma sunulduğunda, hâlihazırda desteklenen bir sürümde olan kullanıcıların yeni modelleri görmek için başka bir indirme yapması gerekmez. Listeyi yenilemek için model seçiciyi yeniden açın veya Codex'i yeniden başlatın.

Etkileşimli CLI'da Daybreak'i etkinleştirme

Codex'i her zamanki kimlik doğrulama yönteminizle başlatın.
Daybreak'i AÇMAK için /daybreak yazın.
Codex, Daybreak açık. Yeni turlar için geçerlidir. mesajını gösterir.
Bu ayar etkin konuşmaya uygulanır ve yeni oturumlar için varsayılan olarak kaydedilir.
Daybreak'i KAPATMAK için aynı komutu (/daybreak) yeniden çalıştırın.

Etkileşimsiz CLI'de Daybreak'i etkinleştirin

Etkileşimsiz iş akışları, etkileşimli bir kullanıcı arayüzü olmadan, genellikle betiklerde, zamanlanmış görevlerde veya CI ortamında codex exec aracılığıyla çalışır. Burada etkileşimli bir “Daybreak'i etkinleştir” (/daybreak) istemi yoktur. Bunun yerine şunları yapabilirsiniz:

Daha az ret yanıtı almak istediğiniz her komuta -c daybreak=true ekleyerek belirli bir CLI çalıştırmasında Daybreak'i etkinleştirin. Örneğin, şunu girebilirsiniz:

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

Mevcut prompt'unuzu ve diğer komut seçeneklerini koruyun. Betiklerdeki, zamanlanmış görevlerdeki ve CI yapılandırmasındaki komutlar da dahil olmak üzere, Daybreak'i kullanması gereken her çağrıya bu ayarı ekleyin.
Codex'in yüklediği yapılandırma dosyasına daybreak=true ekleyerek Daybreak'i yeni CLI oturumları ve çalıştırmaları için varsayılan yapın.
Varsayılan kullanıcı yapılandırması ~/.codex/config.toml dosyasındadır. Otomasyonunuz CODEX_HOME değişkenini ayarlıyorsa bunun yerine $CODEX_HOME/config.toml dosyasını kullanın. Ayarı, [features] gibi bölümlerin dışında, en üst düzeye yerleştirin.
Değişikliği otomasyonun fiilen çalıştığı ortamda yapın. Dizüstü bilgisayarınızın yapılandırmasını güncellemek, CI çalıştırıcısını veya uzak makineyi güncellemez.
Bu ayar, aynı yapılandırmayı kullanan yeni etkileşimli oturumlar için de geçerlidir. Devam ettirilen ve çatallanan oturumlar, kayıtlı Daybreak tercihlerini korur; yapılandırmada belirlenen yeni varsayılan değer bu tercihin yerini almaz.
Komut satırında belirtilen bir ayarın, ilgili çağrı için kayıtlı yapılandırmanın önüne geçtiğini unutmayın. Bu nedenle yapılandırmanızda daybreak = true ayarını tutabilir ve tek bir çalıştırma için -c daybreak=false kullanabilirsiniz.

Proxy üzerinden erişilen bir çıkarım sağlayıcısıyla Daybreak'i etkinleştirme

Çıkarım isteklerini mevcut proxy'niz üzerinden yönlendirirken Codex CLI'de Daybreak'i kullanabilirsiniz. Codex, projenizde hangi modellerin Daybreak'i desteklediğini belirlemek için ayrı bir model kataloğu sorgusu yapar.

Başlamadan önce Codex CLI'de çalışan bir proxy sağlayıcınız ve hem Daybreak'e hem de kullanmak istediğiniz modele erişimi olan bir projeye ait OpenAI API anahtarınız olduğundan emin olun. Ayrıca Codex CLI'nin v0.167.0 sürümünü kullanmanız gerekir.Projelerin Daybreak erişimi hakkında OpenAI belgeleri

~/.codex/config.toml dosyasını açıp proxy'nize ait [model_providers.<id>] bölümünü bularak proxy sağlayıcınızı güncelleyin. Aşağıdaki örneğin son iki satırını bu bölüme ekleyin. Mevcut sağlayıcı kimliğinizi, proxy URL'nizi ve kimlik doğrulama ayarlarınızı koruyun.

[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

Yapılandırmanızda zaten bir [model_providers.<id>.capabilities] bölümü varsa cyber_access_programs = true ayarını oraya ekleyin ve model_catalog_url ayarını üst sağlayıcı bölümünde tutun.Codex yapılandırma başvuru kılavuzu
CLI'nizin kullandığı kimlik bilgilerine uygun seçeneği belirleyerek katalog sorgusu için kimlik doğrulamasını ayarlayın.
1. Codex bir OpenAI API anahtarı kullanıyorsa 1. adımdaki OpenAI katalog URL'sini koruyun. Katalogda doğrudan kimlik doğrulayabilmesi için Codex'i Daybreak'in etkin olduğu projenizin anahtarıyla çalıştırın.
2. Codex proxy'nizin kimlik bilgilerini kullanıyorsa model_catalog_url değerini, proxy'nizdeki bir katalog rotasının tam URL'si olarak ayarlayın. Bu rotayı aşağıdakileri yapacak şekilde yapılandırın:
  1. Her zamanki proxy kimlik bilgilerinizi kullanarak CLI isteğinin kimliğini doğrulama.
  2. Daybreak'in etkin olduğu projenizin OpenAI API anahtarını kullanarak isteği https://chatgpt.com/backend-api/codex/models adresine iletme.
  3. Katalog yanıtını Codex'e döndürme.
Proxy sağlayıcınızla yeni bir Codex CLI oturumu başlatarak Daybreak'i açın. Daybreak kullanımına uygun bir model seçin, ardından Daybreak'i açmak için /daybreak yazın.
1. Daybreak kullanılamıyorsa önce katalog sorgusunu kontrol edin. Katalog isteği başarısız olsa bile çıkarım işlemi başarılı olabilir. İsteğin OpenAI'a doğru projeye ait bir anahtarla ulaştığını ve projenin hem Daybreak'e hem de seçilen modele erişimi olduğunu doğrulayın.

TypeScript SDK aracılığıyla Daybreak'i etkinleştirme

Daybreak ayarını istemci yapılandırması üzerinden iletin:

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

Daybreak'i kapatmak ve normal ret davranışını kullanmak için daybreak: false ayarını kullanın. Mevcut kimlik doğrulama yapılandırmanızı koruyun.

Uygulama sunucusu veya Python SDK aracılığıyla Daybreak'i etkinleştirme

1. Seçili modelin availableAccessPrograms.cyber değerlerini model/list üzerinden okuyun, ardından turn/start parametrelerinde cyberAccessProgram değerini ayarlayın.

a. Ana seriden bir model ve Daybreak Blue erişimi olan bir hesap için:

{ "cyberAccessProgram": "daybreakBlue" }

b. Bir siber model ve Daybreak Red erişimi olan bir hesap için:

{ "cyberAccessProgram": "daybreakRed" }

c. Normal ret davranışı için:

{ "cyberAccessProgram": "standard" }

2. Bu seçimin kullanılacağı her tura seçimi ekleyin; parametreyi belirtmemenin Daybreak'i kapattığını varsaymayın. Uygulama sunucusuna doğrudan bağlanan istemciler, bu parametreyi kullanmak için başlatma sırasında experimentalApi özelliğini etkinleştirmelidir.

3. Python SDK'nın düşük seviyeli CodexClient istemcisi aynı parametreyi iletebilir:

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. Bu örnekte, Daybreak Blue'nun seçili model için kullanılabilir olduğu varsayılır. Python istemcisi, deneysel API özelliğini varsayılan olarak etkinleştirir. Kaydedilmiş bir konuşma tercihi, tek başına bir uygulama sunucusu turu için program seçmez.

Bu değişikliklerden önce yerel bir model kataloğu eklediyseniz

Daha önce API anahtarıyla oturum açtığınızda beklediğiniz modeller görünmediyse config.toml dosyasındaki model_catalog_json ayarını kullanarak yerel bir katalog eklemiş olabilirsiniz. Codex, otomatik katalog yerine bu yerel dosyayı kullanır. Bu nedenle model listeniz güncelliğini yitirebilir. Ortamınızda otomatik katalog desteği kullanıma sunulduğunda, otomatik kataloğa geri dönmek için şu adımları izleyin:

config.toml dosyasını açın. Codex CLI için ~/.codex/config.toml dosyasını (veya CODEX_HOME değişkenini ayarladıysanız $CODEX_HOME/config.toml dosyasını) açın. Codex Desktop'ta Ayarlar > Yapılandırma bölümüne gidin, ardından config.toml dosyasını aç seçeneğini seçin.
Yerel kataloğu geçici olarak devre dışı bırakın. model_catalog_json satırının başına # ekleyin, dosyayı kaydedin ve Codex'i aynı hesap veya API anahtarıyla yeniden başlatın. Kuruluşunuzun zorunlu tuttuğu katalog URL'lerini olduğu gibi bırakın.
Erişiminizi doğrulayın. CLI'da codex komutunu çalıştırın, ardından oturum içinde /daybreak yazın. Desktop'ta Gelişmiş model seçiciyi açın ve Daybreak'i açın. Daybreak Red erişiminiz varsa beklediğiniz bir siber modelin göründüğünü ve bu modeli kullanarak istek gönderebildiğinizi doğrulayın.
Çalışan yapılandırmayı koruyun. Kontrol başarılı olursa devre dışı bıraktığınız satırı silin ve dosyayı kaydedin. Başarısız olursa önceki yapılandırmanızı geri yüklemek için # işaretini kaldırın, dosyayı kaydedin ve Codex'i yeniden başlatın.

CLI'da ret sorunlarını giderme

Otomasyonunuzun kullandığı kimlik bilgileri, model ve yapılandırmayla tipik bir iş çalıştırın.
Daybreak kullanılamıyorsa şunları doğrulayın:
- Hesabınızın veya API projenizin Daybreak erişimi var.
- Seçili model Daybreak'i destekliyor.
Etkileşimli CLI'da Daybreak'in Açık olduğunu kontrol edin. Daybreak kullanılabilir ancak KAPALI olduğunda etkileşimli CLI bir ret mesajı gösterebilir: Daybreak şu anda kapalı. Yetkili bir güvenlik çalışması yürütüyorsanız Daybreak'i açıp isteğinizi yeniden deneyin.
- İletide Bir sonraki isteğiniz için Daybreak açılsın mı? sorusu sorulur ve Daybreak'i etkinleştir veya Şimdi değil seçenekleri sunulur.
- Bir sonraki isteğiniz için Daybreak'i açmak üzere Daybreak'i etkinleştir seçeneğini seçin, ardından isteği yeniden deneyin. Reddedilen isteğin otomatik olarak yeniden denenmediğini unutmayın; isteği tekrar göndermeniz gerekir. Daybreak AÇIK olsa bile bazı istekler yine de reddedilebilir.
- Daybreak'i KAPALI bırakmak için Şimdi değil seçeneğini seçin.
Otomasyonlarda, daybreak=true ayarının doğrudan Codex sürecine iletildiğini ve başka bir komut satırı ayarı tarafından geçersiz kılınmadığını doğrulayın.

Daybreak'i Codex Security CLI ile kullanın

Codex Security CLI, güvenlik taramaları için @openai/codex-security paketini kullanır. Erişim programı seçenekleri, yukarıdaki genel Codex CLI örneklerinden ayrıdır.

API anahtarıyla kimlik doğrulamak için Daybreak'in etkin olduğu bir API projesine ait anahtarı kullanın ve o proje için onaylanan programı açıkça seçin. Daybreak Blue için:

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

daybreak_red seçeneğini yalnızca projeniz Daybreak Red için onaylıysa, standard seçeneğini ise standart koruma önlemleri için kullanın. Bir programı seçmek, o programa veya ek modellere erişim sağlamaz.

Kimlik doğrulama ve tarama seçenekleri için Codex Security CLI başvuru kılavuzuna bakın.

Daybreak'i Codex Security SDK ile kullanın

Codex Security TypeScript SDK (@openai/codex-security), bir uygulama veya geliştirici aracı üzerinden güvenlik taramaları çalıştırır. Yukarıda açıklanan genel Codex SDK'den ayrıdır.

Onaylı hesabınızın veya API projenizin kimlik bilgilerini kullanın. Bazı siber güvenlik istekleri ve korumalı bulgular için Trusted Access for Cyber gerekir. SDK'yi yüklemek veya bir model seçmek Daybreak erişimi sağlamaz.

Desteklenen kimlik doğrulama, yapılandırma ve tarama örnekleri için Codex Security SDK kılavuzunu izleyin.

Codex CLI'da Daybreak kullanımı