Skip to content
Draft
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ description: Surfaces multi-agents, consignes de délégation, modèles privilé

Les paramètres des agents déterminent la surface de collaboration Codex annoncée, ainsi que la manière dont opencodex guide, route et limite les tâches déléguées.

## Contrôle de récupération des tâches v2 chiffrées

La récupération expérimentale est désactivée par défaut. Activez-la sous **Sous-agents → Paramètres → Récupérer les tâches v2 chiffrées** uniquement après avoir accepté l’avertissement de quota et de latence, ou utilisez `ocx agent recovery status`, `ocx agent recovery on` ou `ocx agent recovery off`. L’API équivalente est `GET/PUT /api/agent-task-recovery` ; `PUT` accepte seulement `{"enabled": boolean}`, écrit d’abord la configuration durable, puis met à jour l’état actif, tout en préservant les options avancées configurées manuellement.

## Champs de configuration des agents

| Champ | Type | Valeur par défaut | Signification |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ description: Entrées du fournisseur, authentification, points de terminaison, c
Un fournisseur indique à opencodex où se trouve un modèle, quel adaptateur de protocole il utilise et comment les requêtes sont
authentifiées.

## Routage OpenRouter par modèle dans le tableau de bord

Pour un fournisseur OpenRouter canonique, ouvrez **Fournisseurs → OpenRouter → Modèles → Routage du fournisseur par modèle**. Saisissez l’identifiant OpenRouter exact, chargez les endpoints, puis choisissez l’héritage de `openRouterRouting`, un ordre `order` ou une liste exclusive `only`. Le mode héritage supprime l’entrée correspondante de `modelOpenRouterRouting`. Les tags configurés mais absents d’une découverte restent visibles et peuvent être supprimés explicitement.

La découverte utilise la clé API OpenRouter configurée. Un refus d’autorisation ne modifie pas le routage enregistré. Les résultats valides sont mis en cache pendant cinq minutes ; **Actualiser** contourne ce cache, même après une liste vide.

## Champs de premier niveau liés aux fournisseurs

| Champ | Type | Par défaut | Signification |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ description: マルチエージェント サーフェス、委任ガイダンス

エージェント設定は、どの Codex コラボレーション サーフェスをアドバタイズするか、および opencodex が委任された作業をどのようにガイド、ルーティング、制限するかを制御します。

## 暗号化された v2 タスクの復旧コントロール

実験的な復旧機能は既定で無効です。クォータと遅延の警告を確認したうえで、**サブエージェント → 設定 → 暗号化された v2 タスクを復旧**から有効にするか、`ocx agent recovery status`、`ocx agent recovery on`、または `ocx agent recovery off` を使います。同等の API は `GET/PUT /api/agent-task-recovery` です。`PUT` は `{"enabled": boolean}` のみを受け付け、永続設定を先に書き込んでから実行中の状態を更新し、手動設定された高度なオプションを保持します。

## エージェントフィールド

|フィールド |タイプ |デフォルト |意味 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ description: プロバイダー エントリ、認証、エンドポイント、

プロバイダーは、opencodex に、モデルが存在する場所、モデルが通信するワイヤー アダプター、およびリクエストの認証方法を伝えます。

## ダッシュボードでのモデル別 OpenRouter ルーティング

正規の OpenRouter プロバイダーでは、**プロバイダー → OpenRouter → モデル → モデル別プロバイダー ルーティング**を開きます。正確な OpenRouter モデル ID を入力してエンドポイントを読み込み、`openRouterRouting` の継承、`order`、または `only` を選択します。継承を保存すると、対応する `modelOpenRouterRouting` エントリが削除されます。検出結果にない設定済みタグも表示され、明示的に削除できます。

検出には設定済みの OpenRouter API キーを使用します。認証が拒否されても保存済みルーティングは変更されません。成功した結果は 5 分間キャッシュされ、空の結果の後でも**更新**でキャッシュを回避できます。

## プロバイダー関連のトップレベルフィールド

|フィールド |タイプ |デフォルト |意味 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ description: 멀티 에이전트 표면, 위임 안내, 선호 모델, 대체

에이전트 설정은 어떤 Codex 협업 표면을 노출할지와, opencodex가 위임 작업을 어떻게 안내하고, 라우팅하고, 제한할지를 제어합니다.

## 암호화된 v2 작업 복구 제어

실험적 복구는 기본적으로 꺼져 있습니다. 할당량과 지연 경고를 확인한 뒤 **하위 에이전트 → 설정 → 암호화된 v2 작업 복구**에서 켜거나 `ocx agent recovery status`, `ocx agent recovery on`, 또는 `ocx agent recovery off`를 사용하세요. 동일한 API는 `GET/PUT /api/agent-task-recovery`입니다. `PUT`은 `{"enabled": boolean}`만 허용하며, 영구 설정을 먼저 기록한 뒤 활성 상태를 갱신하고 수동으로 설정한 고급 옵션은 보존합니다.

## 에이전트 필드

| 필드 | 형식 | 기본값 | 의미 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ description: 공급자 항목, 인증, 엔드포인트, 모델 카탈로그, 할

공급자는 opencodex에 모델의 위치, 사용하는 와이어 어댑터, 요청 인증 방식을 알려줍니다.

## 대시보드의 모델별 OpenRouter 라우팅

정식 OpenRouter 공급자에서 **공급자 → OpenRouter → 모델 → 모델별 공급자 라우팅**을 엽니다. 정확한 OpenRouter 모델 ID를 입력하고 엔드포인트를 불러온 뒤 `openRouterRouting` 상속, `order`, 또는 `only`를 선택합니다. 상속을 저장하면 해당 `modelOpenRouterRouting` 항목이 제거됩니다. 검색 결과에서 사라진 구성 태그도 계속 표시되며 명시적으로 제거할 수 있습니다.

검색은 구성된 OpenRouter API 키를 사용합니다. 인증이 거부되어도 저장된 라우팅은 변경되지 않습니다. 성공한 결과는 5분 동안 캐시되며, 빈 결과 뒤에도 **새로 고침**으로 캐시를 우회할 수 있습니다.

## 공급자 관련 최상위 필드

| 필드 | 타입 | 기본값 | 의미 |
Expand Down
14 changes: 14 additions & 0 deletions docs-site/src/content/docs/reference/configuration/agents.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,6 +187,20 @@ Enable this only when the additional authenticated request, quota use, plaintext
and private-backend dependency are acceptable. Prefer a native ChatGPT child or v1 heterogeneous
delegation when they are not.

The dashboard exposes the same explicit opt-in under **Subagents → Settings → Recover encrypted V2
tasks** and shows the quota/latency warning before enabling it. Headless users can use:

```bash
ocx agent recovery status
ocx agent recovery on
ocx agent recovery off
```

The management API equivalent is `GET/PUT /api/agent-task-recovery`; `PUT` accepts only
`{"enabled": boolean}` and preserves advanced `model`, `timeoutMs`, and `cacheEntries` values that
were configured manually. The route commits this field-scoped change to disk before mirroring it into
the running proxy, so a persistence failure cannot enable or disable live recovery by itself.

This recovery path applies to direct-routed children. At most 32 recovery requests can be active at
once; additional misses fail closed. Combo routing keeps its existing native-only filter for
encrypted tasks and does not invoke recovery.
Expand Down
25 changes: 25 additions & 0 deletions docs-site/src/content/docs/reference/configuration/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -361,6 +361,31 @@ Model keys are exact native OpenRouter ids, without the outer opencodex provider
`openrouter/anthropic-claude-sonnet-5` restores native `anthropic/claude-sonnet-5` before applying
the model rule.

### Discover and select providers in the dashboard

For canonical OpenRouter providers (`openai-chat` plus `https://openrouter.ai/api/v1`), open
**Providers → OpenRouter → Models → Provider routing by model**. Enter an exact OpenRouter model id,
load its available endpoints, then choose one of three behaviors:

- inherit the provider-wide `openRouterRouting` value; saving this mode removes that model's
`modelOpenRouterRouting` entry, so the provider-wide value applies again;
- prioritize selected endpoint tags with `order`;
- restrict routing to selected endpoint tags with `only`.

Selections preserve the exact endpoint `tag` returned by OpenRouter, including region or speed
suffixes such as `google-vertex/us-east5` or `deepinfra/turbo`. Configured tags that disappear from a
later discovery response remain visible and can be removed explicitly; they are never silently
deleted.

Endpoint discovery uses OpenRouter's authenticated
`GET /api/v1/models/{author}/{slug}/endpoints` API on demand and caches successful results in memory
for five minutes. It authenticates with the configured OpenRouter API key, the same credential class
used for inference. If OpenRouter rejects that key, existing routing remains unchanged and manual JSON
configuration is still available. opencodex never returns the key to the browser or includes upstream
error bodies in the dashboard response. At most eight distinct endpoint discoveries run concurrently;
additional unique requests receive a bounded busy response while callers for an existing discovery
still share that request.

## Static model allowlists

Set `liveModels: false` to expose only `models`. If `models` is empty or omitted, the provider exposes
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@ description: Multi-agent surface, guidance при делегировании, pr
Настройки агентов управляют тем, какая collaboration surface Codex рекламируется и как opencodex
подсказывает, маршрутизирует и ограничивает делегированную работу.

## Управление восстановлением зашифрованных v2-задач

Экспериментальное восстановление по умолчанию выключено. Включайте его через **Подагенты → Настройки → Восстанавливать зашифрованные v2-задачи** только после подтверждения предупреждения о quota и latency либо используйте `ocx agent recovery status`, `ocx agent recovery on` или `ocx agent recovery off`. Эквивалентный API — `GET/PUT /api/agent-task-recovery`; `PUT` принимает только `{"enabled": boolean}`, сначала сохраняет durable-конфигурацию, затем обновляет активное состояние и сохраняет расширенные параметры, заданные вручную.

## Поля агентов

| Поле | Тип | По умолчанию | Значение |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ description: Записи провайдеров, аутентификация,
Провайдер сообщает opencodex, где живёт модель, на каком wire-adapter'е она работает и как
аутентифицируются запросы.

## Маршрутизация OpenRouter по модели в дашборде

Для канонического OpenRouter откройте **Провайдеры → OpenRouter → Модели → Маршрутизация провайдера по модели**. Укажите точный OpenRouter model id, загрузите endpoint'ы и выберите наследование `openRouterRouting`, порядок `order` или ограничение `only`. Сохранение наследования удаляет соответствующую запись `modelOpenRouterRouting`. Настроенные tag'и, которых больше нет в результате discovery, остаются видимыми и могут быть явно удалены.

Discovery использует настроенный API-ключ OpenRouter. Отказ авторизации не меняет сохранённую маршрутизацию. Успешный результат кэшируется на пять минут; **Обновить** обходит кэш даже после пустого результата.

## Верхнеуровневые поля, связанные с провайдерами

| Поле | Тип | По умолчанию | Значение |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ Ajan ayarları hangi Codex işbirliği yüzeyinin tanıtılacağını ve opencod
devredilen işleri nasıl yönlendireceğini, yönlendireceğini ve sınırlayacağını
kontrol eder.

## Şifrelenmiş v2 görev kurtarma denetimi

Deneysel kurtarma varsayılan olarak kapalıdır. Kota ve gecikme uyarısını kabul ettikten sonra **Alt ajanlar → Ayarlar → Şifrelenmiş v2 görevlerini kurtar** yolundan etkinleştirin veya `ocx agent recovery status`, `ocx agent recovery on` ya da `ocx agent recovery off` kullanın. Eşdeğer API `GET/PUT /api/agent-task-recovery`'dir. `PUT` yalnızca `{"enabled": boolean}` kabul eder, etkin durumu güncellemeden önce kalıcı yapılandırmayı yazar ve elle yapılandırılmış gelişmiş seçenekleri korur.

## Ajan alanları

| Alan | Tip | Varsayılan | Anlamı |
Expand Down Expand Up @@ -246,5 +250,3 @@ ile `xhigh` arasını sunar.

v1, varsayılan ve v2 davranışının yeni başlayanlara yönelik açıklaması için [Alt
ajan yüzeyleri](/tr/guides/sub-agent-surface/) sayfasına bakın.


Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ description: Sağlayıcı girdileri, kimlik doğrulama, uç noktalar, model kata
Bir sağlayıcı, opencodex'e bir modelin nerede yaşadığını, hangi hat adaptörünü
konuştuğunu ve isteklerin nasıl doğrulandığını söyler.

## Kontrol panelinde model başına OpenRouter yönlendirmesi

Kurallı bir OpenRouter sağlayıcısında **Sağlayıcılar → OpenRouter → Modeller → Model başına sağlayıcı yönlendirmesi** yolunu açın. Tam OpenRouter model kimliğini girip uçları yükleyin; ardından `openRouterRouting` kalıtımını, `order` sırasını veya `only` kısıtını seçin. Kalıtımı kaydetmek ilgili `modelOpenRouterRouting` girdisini kaldırır. Keşifte artık dönmeyen yapılandırılmış etiketler görünür kalır ve açıkça kaldırılabilir.

Keşif yapılandırılmış OpenRouter API anahtarını kullanır. Yetkilendirme reddi kayıtlı yönlendirmeyi değiştirmez. Başarılı sonuçlar beş dakika önbelleğe alınır; boş bir sonuçtan sonra bile **Yenile** önbelleği atlar.

## Sağlayıcı ile ilgili üst düzey alanlar

| Alan | Tip | Varsayılan | Anlamı |
Expand Down Expand Up @@ -478,5 +484,3 @@ bildirir; senkronize edilen katalog `xhigh`'ı ayrı tutarken `max` bildirir.
"visionSidecar": { "enabled": true }
}
```


Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ description: 多代理界面、委派引导、首选模型、回退链、原生

代理设置控制会公开哪种 Codex 协作界面,以及 opencodex 如何引导、路由并限制委派工作。

## 加密 v2 任务恢复控制

实验性恢复功能默认关闭。确认配额和延迟警告后,可在**子代理 → 设置 → 恢复加密的 v2 任务**中启用,或分别使用 `ocx agent recovery status`、`ocx agent recovery on` 或 `ocx agent recovery off`。对应 API 为 `GET/PUT /api/agent-task-recovery`;`PUT` 只接受 `{"enabled": boolean}`,会先写入持久配置,再更新运行中的状态,并保留手动配置的高级选项。

## 代理字段

| 字段 | 类型 | 默认值 | 含义 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ description: 提供者条目、身份验证、端点、模型目录、配额、

提供者用于告诉 opencodex 模型位于哪里、使用哪种线协议适配器,以及请求如何进行身份验证。

## 在仪表板中按模型配置 OpenRouter 路由

对于规范 OpenRouter 提供者,请打开**提供者 → OpenRouter → 模型 → 按模型的提供者路由**。输入精确的 OpenRouter 模型 ID,加载 endpoint,然后选择继承 `openRouterRouting`、使用 `order` 排序或使用 `only` 限制。保存继承模式会删除对应的 `modelOpenRouterRouting` 条目。发现结果中已不存在的已配置 tag 仍会显示,并可明确移除。

发现功能使用已配置的 OpenRouter API 密钥。授权失败不会更改已保存的路由。成功结果会缓存五分钟;即使结果为空,也可通过**刷新**绕过缓存。

## 提供者相关顶级字段

| 字段 | 类型 | 默认值 | 含义 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ description: 多代理介面、委派指引、偏好模型、fallback 鏈、原

Agent 設定控制要廣告哪個 Codex 協作介面,以及 opencodex 如何引導、路由並限制委派的工作。

## 加密 v2 任務復原控制

實驗性復原功能預設關閉。確認配額與延遲警告後,可在**子代理 → 設定 → 復原加密的 v2 任務**中啟用,或分別使用 `ocx agent recovery status`、`ocx agent recovery on` 或 `ocx agent recovery off`。對應 API 為 `GET/PUT /api/agent-task-recovery`;`PUT` 僅接受 `{"enabled": boolean}`,會先寫入持久設定,再更新執行中的狀態,並保留手動設定的進階選項。

## Agent 欄位

| 欄位 | 型別 | 預設值 | 意義 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ description: 供應商項目、認證、端點、模型目錄、配額、context

供應商告訴 opencodex 模型在哪裡、它使用哪種 wire adapter,以及請求如何被認證。

## 在儀表板中依模型設定 OpenRouter 路由

對於規範 OpenRouter 供應商,請開啟**供應商 → OpenRouter → 模型 → 依模型的供應商路由**。輸入精確的 OpenRouter model ID、載入 endpoint,然後選擇繼承 `openRouterRouting`、使用 `order` 排序或以 `only` 限制。儲存繼承模式會移除對應的 `modelOpenRouterRouting` 項目。探索結果中已不存在的已設定 tag 仍會顯示,並可明確移除。

探索使用已設定的 OpenRouter API 金鑰。授權失敗不會變更已儲存的路由。成功結果會快取五分鐘;即使結果為空,也能透過**重新整理**略過快取。

## 供應商相關的頂層欄位

| 欄位 | 型別 | 預設值 | 意義 |
Expand Down
Loading
Loading