Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs-site/src/content/docs/fr/reference/management-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,6 +163,21 @@ l'opération la plus récente de chaque client afin de conserver le point d'annu

Voir [Combos](/fr/guides/combos/) pour les stratégies cibles, les temps de recharge, les alias et les échecs de routage.

### Couches de prompt Codex

| Méthode et chemin | Objectif | Erreurs notables |
| --- | --- | --- |
| `GET /api/codex-prompt` | Lire l'instantané des couches de prompt : couches, variantes de base, sélection et état de drift | — |
| `GET /api/codex-prompt/text` | Sonder le texte du prompt visible par le modèle via `codex debug prompt-input` | Fail-soft : une sonde indisponible se dégrade en statut dans le corps, pas en erreur HTTP |
| `PUT /api/codex-prompt/toggle` | Activer ou désactiver une couche commutable | 400 corps invalide ou couche inconnue ; 409 `stale_revision`, `layer_not_toggleable` |
| `PUT /api/codex-prompt/custom` | Remplacer l'ensemble des couches personnalisées | 400 corps invalide, `invalid_characters`, `body_too_large` quand une couche UTF-8 normalisée dépasse 65 536 octets, `composed_too_large` au-delà de 131 072 octets ; 409 `stale_revision` |
| `PUT /api/codex-prompt/base/select` | Sélectionner le prompt de base par défaut ou une variante enregistrée | 400 corps invalide, `unknown_layer` pour un id qui ne correspond à aucune variante enregistrée ; 409 `stale_revision`, `developer_instructions_not_owned` quand la base actuelle est externe |
| `PUT /api/codex-prompt/base` | Créer (`id` omis ou `id: null`), modifier ou supprimer (`delete: true`) une variante de base. Un `id` fourni est réservé à la modification et doit référencer une variante enregistrée. `body` est normalisé (tabulations expansées, CR/CRLF convertis en LF) avant d'être mesuré ou stocké | 400 corps invalide, `unknown_layer` pour l'id `default` ou un id qui ne correspond à aucune variante enregistrée, `body_too_large` quand le corps UTF-8 normalisé dépasse 65 536 octets ; 409 `stale_revision` |
| `POST /api/codex-prompt/adopt` | Importer `developer_instructions` de `config.toml` comme couche personnalisée | 400 corps invalide, `invalid_characters`, `body_too_large`, `composed_too_large` ; 409 `config_unreadable`, `nothing_to_adopt`, `adopt_unsupported_form`, `stale_revision` |
| `POST /api/codex-prompt/repair` | Réparer le drift entre `config.toml` et la projection possédée | 400 corps invalide ; 409 `config_unreadable`, `nothing_to_repair`, `repair_unsupported`, `stale_revision` |

Voir [Couches de prompt Codex](/fr/guides/codex-prompt/) pour le modèle de couches et les clés écrites par chacune.

### Configuration, démarrage, synchronisation et mises à jour

| Méthode et chemin | Objectif | Erreurs notables |
Expand Down
15 changes: 15 additions & 0 deletions docs-site/src/content/docs/ja/reference/management-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,21 @@ Aside プロファイルの変更はこの場合でも一つだけ保存しま

ターゲット戦略、クールダウン、エイリアス、およびルーティングの失敗については、[コンボ](/guides/combos/) を参照してください。

### Codex プロンプトレイヤー

|メソッドとパス |目的 |注目すべきエラー |
| --- | --- | --- |
| `GET /api/codex-prompt` | プロンプトレイヤーのスナップショット(レイヤー、基本バリアント、選択、drift 状態)を読み取ります | — |
| `GET /api/codex-prompt/text` | `codex debug prompt-input` を介してモデルに表示されるプロンプトテキストをプローブします | fail-soft: 利用できないプローブは HTTP エラーではなく本文のステータスに低下します |
| `PUT /api/codex-prompt/toggle` | 切り替え可能な 1 つのレイヤーを有効または無効にします | 400 無効な本文または不明なレイヤー; 409 `stale_revision`、`layer_not_toggleable` |
| `PUT /api/codex-prompt/custom` | カスタムレイヤーセットを置き換えます | 400 無効な本文、`invalid_characters`、正規化された UTF-8 レイヤーが 65,536 バイトを超えると `body_too_large`、131,072 バイトを超えると `composed_too_large`; 409 `stale_revision` |
| `PUT /api/codex-prompt/base/select` | デフォルトの基本プロンプトまたは保存された 1 つのバリアントを選択します | 400 無効な本文、保存されたバリアントに一致しない id には `unknown_layer`; 409 `stale_revision`、現在の base が外部の場合は `developer_instructions_not_owned` |
| `PUT /api/codex-prompt/base` | 1 つの基本バリアントを作成(`id` 省略または `id: null`)、編集、または削除(`delete: true`)します。指定された `id` は編集専用で、保存されたバリアントを参照する必要があります。`body` は測定・保存前に正規化されます(タブ展開、CR/CRLF を LF に折りたたみ) | 400 無効な本文、`default` id または保存されたバリアントに一致しない id には `unknown_layer`、正規化された UTF-8 本文が 65,536 バイトを超えると `body_too_large`; 409 `stale_revision` |
| `POST /api/codex-prompt/adopt` | `config.toml` の `developer_instructions` をカスタムレイヤーとしてインポートします | 400 無効な本文、`invalid_characters`、`body_too_large`、`composed_too_large`; 409 `config_unreadable`、`nothing_to_adopt`、`adopt_unsupported_form`、`stale_revision` |
| `POST /api/codex-prompt/repair` | `config.toml` と所有された projection 間の drift を修復します | 400 無効な本文; 409 `config_unreadable`、`nothing_to_repair`、`repair_unsupported`、`stale_revision` |

レイヤーモデルと各レイヤーが書き込むキーについては、[Codex プロンプトレイヤー](/guides/codex-prompt/) を参照してください。

### 設定、起動、同期、更新

|メソッドとパス |目的 |注目すべきエラー |
Expand Down
15 changes: 15 additions & 0 deletions docs-site/src/content/docs/ko/reference/management-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -141,6 +141,21 @@ Aside 프로필 변경은 이때도 한 가지를 저장합니다. 확인을 보

대상 전략, cooldown, alias, 라우팅 실패는 [Combos](/guides/combos/)를 참고하십시오.

### Codex 프롬프트 레이어

| Method and path | 목적 | 주요 오류 |
| --- | --- | --- |
| `GET /api/codex-prompt` | 프롬프트 레이어 스냅샷(레이어, 기본 변형, 선택, drift 상태)을 읽습니다 | — |
| `GET /api/codex-prompt/text` | `codex debug prompt-input`으로 모델에 표시되는 프롬프트 텍스트를 조사합니다 | fail-soft: 사용할 수 없는 probe는 HTTP 오류가 아니라 본문의 상태로 저하됩니다 |
| `PUT /api/codex-prompt/toggle` | 전환 가능한 레이어 하나를 켜거나 끕니다 | 400 잘못된 본문 또는 알 수 없는 레이어; 409 `stale_revision`, `layer_not_toggleable` |
| `PUT /api/codex-prompt/custom` | 사용자 지정 레이어 집합을 교체합니다 | 400 잘못된 본문, `invalid_characters`, 정규화된 UTF-8 레이어가 65,536바이트를 넘으면 `body_too_large`, 131,072바이트를 넘으면 `composed_too_large`; 409 `stale_revision` |
| `PUT /api/codex-prompt/base/select` | 기본 프롬프트 또는 저장된 변형 하나를 선택합니다 | 400 잘못된 본문, 저장된 변형과 일치하지 않는 id에는 `unknown_layer`; 409 `stale_revision`, 현재 base가 외부이면 `developer_instructions_not_owned` |
| `PUT /api/codex-prompt/base` | 기본 변형 하나를 생성(`id` 생략 또는 `id: null`), 편집 또는 삭제(`delete: true`)합니다. 제공된 `id`는 편집 전용이며 저장된 변형을 참조해야 합니다. `body`는 측정·저장 전에 정규화됩니다(탭 확장, CR/CRLF를 LF로 변환) | 400 잘못된 본문, `default` id 또는 저장된 변형과 일치하지 않는 id에는 `unknown_layer`, 정규화된 UTF-8 본문이 65,536바이트를 넘으면 `body_too_large`; 409 `stale_revision` |
| `POST /api/codex-prompt/adopt` | `config.toml`의 `developer_instructions`를 사용자 지정 레이어로 가져옵니다 | 400 잘못된 본문, `invalid_characters`, `body_too_large`, `composed_too_large`; 409 `config_unreadable`, `nothing_to_adopt`, `adopt_unsupported_form`, `stale_revision` |
| `POST /api/codex-prompt/repair` | `config.toml`과 소유 projection 사이의 drift를 복구합니다 | 400 잘못된 본문; 409 `config_unreadable`, `nothing_to_repair`, `repair_unsupported`, `stale_revision` |

레이어 모델과 각 레이어가 쓰는 키는 [Codex 프롬프트 레이어](/guides/codex-prompt/)를 참고하십시오.

### 구성, 시작, 동기화, 업데이트

| Method and path | 목적 | 주요 오류 |
Expand Down
15 changes: 15 additions & 0 deletions docs-site/src/content/docs/reference/management-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -228,6 +228,21 @@ completes.

See [Combos](/guides/combos/) for target strategies, cooldowns, aliases, and routing failures.

### Codex prompt layers

| Method and path | Purpose | Notable errors |
| --- | --- | --- |
| `GET /api/codex-prompt` | Read the prompt-layer snapshot: layers, base variants, selection, and drift state | — |
| `GET /api/codex-prompt/text` | Probe the model-visible prompt text via `codex debug prompt-input` | Fail-soft: an unavailable probe degrades to a status in the body, not an HTTP error |
| `PUT /api/codex-prompt/toggle` | Enable or disable one toggleable layer | 400 invalid body or unknown layer; 409 `stale_revision`, `layer_not_toggleable` |
| `PUT /api/codex-prompt/custom` | Replace the custom-layer set | 400 invalid body, `invalid_characters`, `body_too_large` when a normalized UTF-8 layer exceeds 65,536 bytes, `composed_too_large` over 131,072 bytes; 409 `stale_revision` |
| `PUT /api/codex-prompt/base/select` | Select the default base prompt or one stored variant | 400 invalid body, `unknown_layer` for an id matching no stored variant; 409 `stale_revision`, `developer_instructions_not_owned` when the current base is external |
| `PUT /api/codex-prompt/base` | Create (`id` omitted or `id: null`), edit, or delete (`delete: true`) one base variant. A supplied `id` is edit-only and must reference a stored variant. `body` is normalized (tabs expanded, CR/CRLF folded to LF) before it is measured or stored | 400 invalid body, `unknown_layer` for the `default` id or an id that matches no stored variant, `body_too_large` when the normalized UTF-8 body exceeds 65,536 bytes; 409 `stale_revision` |
| `POST /api/codex-prompt/adopt` | Import `developer_instructions` from `config.toml` as a custom layer | 400 invalid body, `invalid_characters`, `body_too_large`, `composed_too_large`; 409 `config_unreadable`, `nothing_to_adopt`, `adopt_unsupported_form`, `stale_revision` |
| `POST /api/codex-prompt/repair` | Repair drift between `config.toml` and the owned projection | 400 invalid body; 409 `config_unreadable`, `nothing_to_repair`, `repair_unsupported`, `stale_revision` |

See [Codex prompt layers](/guides/codex-prompt/) for the layer model and the keys each layer writes.

### Configuration, startup, sync, and updates

| Method and path | Purpose | Notable errors |
Expand Down
15 changes: 15 additions & 0 deletions docs-site/src/content/docs/ru/reference/management-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,21 @@ GUI-сессия в стиле loopback не выпускается.

О стратегиях целей, cooldown, alias и routing-failure см. [Combos](/guides/combos/).

### Слои промпта Codex

| Метод и путь | Назначение | Особые ошибки |
| --- | --- | --- |
| `GET /api/codex-prompt` | Прочитать снимок слоёв промпта: слои, базовые варианты, выбор и состояние drift | — |
| `GET /api/codex-prompt/text` | Проверить текст промпта, видимый модели, через `codex debug prompt-input` | Fail-soft: недоступный probe деградирует до статуса в теле, а не HTTP-ошибки |
| `PUT /api/codex-prompt/toggle` | Включить или выключить один переключаемый слой | 400 invalid body или unknown layer; 409 `stale_revision`, `layer_not_toggleable` |
| `PUT /api/codex-prompt/custom` | Заменить набор пользовательских слоёв | 400 invalid body, `invalid_characters`, `body_too_large`, когда нормализованный UTF-8 слой превышает 65 536 байт, `composed_too_large` свыше 131 072 байт; 409 `stale_revision` |
| `PUT /api/codex-prompt/base/select` | Выбрать базовый промпт по умолчанию или один сохранённый вариант | 400 invalid body, `unknown_layer` для id, не совпадающего ни с одним сохранённым вариантом; 409 `stale_revision`, `developer_instructions_not_owned`, когда текущий base внешний |
| `PUT /api/codex-prompt/base` | Создать (`id` опущен или `id: null`), изменить или удалить (`delete: true`) один базовый вариант. Указанный `id` предназначен только для редактирования и должен ссылаться на сохранённый вариант. `body` нормализуется (табуляции раскрываются, CR/CRLF сворачиваются в LF) до измерения или сохранения | 400 invalid body, `unknown_layer` для id `default` или id, не совпадающего ни с одним сохранённым вариантом, `body_too_large`, когда нормализованное UTF-8 тело превышает 65 536 байт; 409 `stale_revision` |
| `POST /api/codex-prompt/adopt` | Импортировать `developer_instructions` из `config.toml` как пользовательский слой | 400 invalid body, `invalid_characters`, `body_too_large`, `composed_too_large`; 409 `config_unreadable`, `nothing_to_adopt`, `adopt_unsupported_form`, `stale_revision` |
| `POST /api/codex-prompt/repair` | Устранить drift между `config.toml` и принадлежащей projection | 400 invalid body; 409 `config_unreadable`, `nothing_to_repair`, `repair_unsupported`, `stale_revision` |

О модели слоёв и ключах, которые записывает каждый слой, см. [Слои промпта Codex](/guides/codex-prompt/).

### Конфигурация, startup, sync и updates

| Метод и путь | Назначение | Особые ошибки |
Expand Down
15 changes: 15 additions & 0 deletions docs-site/src/content/docs/tr/reference/management-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -167,6 +167,21 @@ her istemcinin en yeni işlemi sunucu tarafında korunur.
Hedef stratejileri, soğuma süreleri, takma adlar ve yönlendirme hataları için
[Kombolar](/tr/guides/combos/) sayfasına bakın.

### Codex istem katmanları

| Yöntem ve yol | Amaç | Dikkate değer hatalar |
| --- | --- | --- |
| `GET /api/codex-prompt` | İstem katmanı anlık görüntüsünü okuyun: katmanlar, temel varyantlar, seçim ve drift durumu | — |
| `GET /api/codex-prompt/text` | `codex debug prompt-input` üzerinden modele görünen istem metnini yoklayın | Fail-soft: kullanılamayan yoklama HTTP hatası yerine gövdede bir duruma düşer |
| `PUT /api/codex-prompt/toggle` | Değiştirilebilir bir katmanı etkinleştirin veya devre dışı bırakın | 400 geçersiz gövde veya bilinmeyen katman; 409 `stale_revision`, `layer_not_toggleable` |
| `PUT /api/codex-prompt/custom` | Özel katman kümesini değiştirin | 400 geçersiz gövde, `invalid_characters`, normalleştirilmiş UTF-8 katmanı 65.536 baytı aşarsa `body_too_large`, 131.072 baytı aşarsa `composed_too_large`; 409 `stale_revision` |
| `PUT /api/codex-prompt/base/select` | Varsayılan temel istemi veya kayıtlı bir varyantı seçin | 400 geçersiz gövde, kayıtlı varyantla eşleşmeyen bir id için `unknown_layer`; 409 `stale_revision`, mevcut temel istem harici olduğunda `developer_instructions_not_owned` |
| `PUT /api/codex-prompt/base` | Bir temel varyantı oluşturun (`id` atlandı veya `id: null`), düzenleyin veya silin (`delete: true`). Sağlanan `id` yalnızca düzenleme içindir ve kayıtlı bir varyanta başvurmalıdır. `body` ölçülmeden veya saklanmadan önce normalleştirilir (sekmeler genişletilir, CR/CRLF LF'e katlanır) | 400 geçersiz gövde, `default` id veya kayıtlı varyantla eşleşmeyen bir id için `unknown_layer`, normalleştirilmiş UTF-8 gövdesi 65.536 baytı aşarsa `body_too_large`; 409 `stale_revision` |
| `POST /api/codex-prompt/adopt` | `config.toml` içindeki `developer_instructions` değerini özel katman olarak içe aktarın | 400 geçersiz gövde, `invalid_characters`, `body_too_large`, `composed_too_large`; 409 `config_unreadable`, `nothing_to_adopt`, `adopt_unsupported_form`, `stale_revision` |
| `POST /api/codex-prompt/repair` | `config.toml` ile sahip olunan projeksiyon arasındaki drift'i onarın | 400 geçersiz gövde; 409 `config_unreadable`, `nothing_to_repair`, `repair_unsupported`, `stale_revision` |

Katman modeli ve her katmanın yazdığı anahtarlar için [Codex İstem Katmanları](/tr/guides/codex-prompt/) sayfasına bakın.

### Yapılandırma, başlangıç, senkronizasyon ve güncellemeler

| Yöntem ve yol | Amaç | Dikkate değer hatalar |
Expand Down
15 changes: 15 additions & 0 deletions docs-site/src/content/docs/zh-cn/reference/management-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,21 @@ Aside 配置档的变更在这种情况下仍会保存一件事:确认之后

关于目标策略、冷却、别名和路由失败,请参见 [Combos](/guides/combos/)。

### Codex 提示词层

| 方法和路径 | 用途 | 典型错误 |
| --- | --- | --- |
| `GET /api/codex-prompt` | 读取提示词层快照:层、基础变体、选择和 drift 状态 | — |
| `GET /api/codex-prompt/text` | 通过 `codex debug prompt-input` 探测模型可见的提示词文本 | 故障弱化:不可用的探测降级为正文中的状态,而非 HTTP 错误 |
| `PUT /api/codex-prompt/toggle` | 启用或禁用一个可切换的层 | 400 无效正文或未知层;409 `stale_revision`、`layer_not_toggleable` |
| `PUT /api/codex-prompt/custom` | 替换自定义层集合 | 400 无效正文、`invalid_characters`、规范化 UTF-8 层超过 65,536 字节时 `body_too_large`、超过 131,072 字节时 `composed_too_large`;409 `stale_revision` |
| `PUT /api/codex-prompt/base/select` | 选择默认基础提示词或一个已保存的变体 | 400 无效正文、与任何已保存变体都不匹配的 id 返回 `unknown_layer`;409 `stale_revision`、当前基础提示词为外部时 `developer_instructions_not_owned` |
| `PUT /api/codex-prompt/base` | 创建(省略 `id` 或 `id: null`)、编辑或删除(`delete: true`)一个基础变体。提供的 `id` 仅用于编辑,必须引用已保存的变体。`body` 在测量或存储前会被规范化(制表符展开,CR/CRLF 折叠为 LF) | 400 无效正文、`default` id 或与任何已保存变体都不匹配的 id 返回 `unknown_layer`、规范化 UTF-8 正文超过 65,536 字节时 `body_too_large`;409 `stale_revision` |
| `POST /api/codex-prompt/adopt` | 将 `config.toml` 中的 `developer_instructions` 导入为自定义层 | 400 无效正文、`invalid_characters`、`body_too_large`、`composed_too_large`;409 `config_unreadable`、`nothing_to_adopt`、`adopt_unsupported_form`、`stale_revision` |
| `POST /api/codex-prompt/repair` | 修复 `config.toml` 与受管 projection 之间的 drift | 400 无效正文;409 `config_unreadable`、`nothing_to_repair`、`repair_unsupported`、`stale_revision` |

有关层模型和每个层写入的键,请参见 [Codex 提示词层](/guides/codex-prompt/)。

### 配置、启动、同步和更新

| 方法和路径 | 用途 | 典型错误 |
Expand Down
Loading
Loading