Skip to content
Merged
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,16 @@ Cela se distingue de la surface des sous-agents (voir
délégation initiée par le worker via les outils de collaboration de Codex. Le conseiller est un
sidecar côté proxy invisible du client — même un worker qui ne spawn jamais peut être conseillé.

## Question uniquement

Pour réduire les entrées répétées, activez l’option correspondante dans la page Advisor ou exécutez :

```sh
ocx advisor set --context-mode question-only
```

Ce mode envoie uniquement une instruction fixe et la question du worker (2 000 caractères conservés, puis un avis de troncature). Aucun historique, tâche, résultat d’outil, catalogue, identité du worker ou preuve de réparation n’est ajouté. Le worker doit fournir les informations nécessaires. Les questions vides sont refusées sans appel au fournisseur. Les consultations automatiques preflight et adaptive sont suspendues ; le consentement et les limites existantes restent requis. Le mode par défaut `context` conserve le comportement décrit ci-dessous. `--context-mode context` le rétablit.

## Configuration

Sur la page **Advisor**, choisissez le modèle dans le catalogue. Le sélecteur conserve exactement les identifiants natifs, de fournisseur, de compte, personnalisés et de combo. Les modèles désactivés ou en attente de sélection initiale ne sont pas proposés. Un identifiant enregistré absent du catalogue reste visible avec un avertissement, jusqu’à son remplacement ou sa suppression. Un échec de chargement conserve la sélection et propose de réessayer. Choisissez un modèle capable de fournir des conseils textuels : le catalogue ne garantit pas la compatibilité des consultations. La CLI et l’API acceptent toujours les chaînes de modèle prises en charge par le routeur.
Expand All @@ -36,6 +46,7 @@ Sur la page **Advisor**, choisissez le modèle dans le catalogue. Le sélecteur
| `model?` | `string` | — | Le modèle expert. Toute chaîne de modèle acceptée par le routeur : modèle natif seul (`gpt-6-astra`), `provider/model` explicite (`anthropic/claude-sonnet-4-6`, `xai/grok-...`) ou modèle natif qualifié par compte. Inter-fournisseurs entièrement pris en charge. |
| `effort?` | `string` | `"max"` | Intensité de raisonnement de l'appel conseiller (`low`–`ultra`). |
| `policy?` | `"manual" \| "preflight" \| "adaptive"` | `"manual"` | Quand consulter le conseiller. |
| `contextMode?` | `"context" \| "question-only"` | `"context"` | Partage du contexte. `question-only` exige une question explicite du worker et suspend les consultations automatiques. |
| `maxConsultationsPerTask?` | `integer` | `3` | Budget adaptatif par tâche (1 à 3 tentatives, appels manuels compris). |
| `timeoutMs?` | `number` | `120000` | Délai de la consultation en boucle locale. |
| `contextSharingConsent?` | `"v1"` | absent | Consentement de l'opérateur pour envoyer le contexte de la tâche au fournisseur conseiller configuré. Seul `"v1"` est courant. Une valeur absente, périmée ou autre n'autorise aucun envoi. `enabled: true` n'est pas ce consentement. |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,16 @@ description: manual、preflight、証拠に基づく adaptive ポリシーによ

これはサブエージェントサーフェス([エージェント設定](/ja/reference/configuration/agents/)を参照)とは異なります。サブエージェントは Codex のコラボレーションツールによるワーカー主導の委譲です。アドバイザーはクライアントから見えないプロキシ側のサイドカーです — 何も spawn しないワーカーでも助言を受けられます。

## 質問のみ送信

繰り返し入力を減らすには、Advisor ページで質問のみ送信を有効にするか、次を実行します。

```sh
ocx advisor set --context-mode question-only
```

このモードでは固定指示とワーカーの質問のみを送信します(最大2,000文字と切り詰め通知)。タスク、会話履歴、ツール結果、ツール一覧、ワーカー識別情報、修復の証拠は添付しません。必要な背景はワーカーが質問に含めます。空の質問はプロバイダーを呼び出さずに拒否します。preflight と adaptive の自動相談は停止します。手動相談、同意、既存の回数制限は維持します。既定の `context` は以下の動作を維持します。`--context-mode context` で戻せます。

## 設定

ダッシュボードの **Advisor** ページでカタログからモデルを選択します。ネイティブ、プロバイダー、アカウント指定、カスタム、コンボの識別子をそのまま保存します。無効なモデルと初期選択待ちのモデルは新規選択に表示されません。選択可能な一覧にない保存済み識別子は警告付きで保持され、別のモデルを選ぶか解除するまで変更されません。読み込みに失敗しても選択は保持され、再試行できます。テキストの助言を返せるモデルを選んでください。カタログは相談の互換性を保証しません。CLI と API は引き続きルーター対応のモデル文字列を受け付けます。
Expand All @@ -29,6 +39,7 @@ description: manual、preflight、証拠に基づく adaptive ポリシーによ
| `model?` | `string` | — | エキスパートモデル。ルーターが受け付ける任意のモデル文字列:ネイティブモデル(`gpt-6-astra`)、明示的な `provider/model`(`anthropic/claude-sonnet-4-6`、`xai/grok-...`)、アカウント修飾ネイティブモデル。クロスプロバイダーを完全にサポートします。 |
| `effort?` | `string` | `"max"` | アドバイザー呼び出しの推論強度(`low`〜`ultra`)。 |
| `policy?` | `"manual" \| "preflight" \| "adaptive"` | `"manual"` | 相談のタイミング。 |
| `contextMode?` | `"context" \| "question-only"` | `"context"` | コンテキスト共有。`question-only` はワーカーの明示的な質問を必要とし、自動相談を停止します。 |
| `maxConsultationsPerTask?` | `integer` | `3` | 適応型タスクの相談上限(1〜3回、手動呼び出しを含む)。 |
| `timeoutMs?` | `number` | `120000` | ループバック相談のタイムアウト。 |
| `contextSharingConsent?` | `"v1"` | なし | 設定されたアドバイザーのプロバイダーへタスク文脈を送ることへの操作者の同意。現在有効な値は `"v1"` だけです。欠落、古い値、その他の値ではタスク内容は送られません。`enabled: true` だけでは同意になりません。 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,16 @@ description: manual, preflight 및 증거 기반 adaptive 정책을 제공하는

이는 서브에이전트 서피스([에이전트 구성](/ko/reference/configuration/agents/) 참조)와 다릅니다. 서브에이전트는 Codex 협업 도구를 통한 워커 주도 위임입니다. 어드바이저는 클라이언트에게 보이지 않는 프록시 측 사이드카입니다 — 아무것도 spawn하지 않는 워커도 조언을 받을 수 있습니다.

## 질문만 전송

반복 입력을 줄이려면 Advisor 페이지에서 질문만 전송 옵션을 켜거나 다음을 실행하세요:

```sh
ocx advisor set --context-mode question-only
```

이 모드는 고정 지침과 워커의 질문만 전송합니다(최대 2,000자와 잘림 안내). 작업, 대화 기록, 도구 결과, 도구 목록, 워커 식별 정보 및 수정 증거는 첨부하지 않습니다. 워커가 필요한 배경을 질문에 포함해야 합니다. 빈 질문은 공급자 호출 없이 거부됩니다. preflight와 adaptive 자동 자문은 중지되며 수동 자문, 동의 및 기존 호출 제한은 유지됩니다. 기본값 `context`는 아래에 설명된 동작을 유지합니다. `--context-mode context`로 복원할 수 있습니다.

## 구성

대시보드 **어드바이저** 페이지에서 카탈로그 선택기로 전문가 모델을 선택하세요. 네이티브, 공급자, 계정 지정, 사용자 정의 및 콤보 선택자의 정확한 카탈로그 식별자를 저장합니다. 비활성 모델과 초기 선택 대기 모델은 새 선택에 표시하지 않습니다. 선택 가능한 목록에 없는 저장된 식별자는 경고와 함께 유지되며, 다른 모델을 선택하거나 지우기 전까지 변경되지 않습니다. 카탈로그 로드 실패 시 현재 선택을 보존하고 재시도를 제공합니다. 텍스트 조언을 반환할 수 있는 모델을 선택하세요. 카탈로그가 상담 호환성을 보장하지는 않습니다. CLI와 API는 라우터가 지원하는 모델 문자열을 계속 허용합니다.
Expand All @@ -29,6 +39,7 @@ description: manual, preflight 및 증거 기반 adaptive 정책을 제공하는
| `model?` | `string` | — | 전문가 모델. 라우터가 허용하는 모든 모델 문자열: 네이티브 모델(`gpt-6-astra`), 명시적 `provider/model`(`anthropic/claude-sonnet-4-6`, `xai/grok-...`), 계정 한정 네이티브 모델. 크로스 프로바이더를 완전히 지원합니다. |
| `effort?` | `string` | `"max"` | 어드바이저 호출의 추론 강도(`low`~`ultra`). |
| `policy?` | `"manual" \| "preflight" \| "adaptive"` | `"manual"` | 상담 시점. |
| `contextMode?` | `"context" \| "question-only"` | `"context"` | 맥락 공유. `question-only`는 워커의 명시적 질문을 요구하며 자동 자문을 중지합니다. |
| `maxConsultationsPerTask?` | `integer` | `3` | 적응형 작업 상담 한도(1–3회 시도, 수동 호출 포함). |
| `timeoutMs?` | `number` | `120000` | 루프백 상담 타임아웃. |
| `contextSharingConsent?` | `"v1"` | 없음 | 설정된 어드바이저 프로바이더로 작업 맥락을 보내는 운영자 동의. 현재 값은 `"v1"`뿐입니다. 없거나, 오래되었거나, 다른 값이면 작업 내용을 보내지 않습니다. `enabled: true`만으로는 동의가 아닙니다. |
Expand Down
11 changes: 11 additions & 0 deletions docs-site/src/content/docs/reference/configuration/advisor.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,16 @@ This is distinct from the subagent surface (see
delegation through Codex's collaboration tools. The advisor is a proxy-side sidecar the client
never sees — even a worker that never spawns anything can be advised.

## Question-only mode

To reduce repeated input, select **Send only the worker’s question** in the Advisor page, or run:

```sh
ocx advisor set --context-mode question-only
```

This opt-in setting sends only a fixed advisor instruction and the worker’s question (up to 2,000 retained characters plus a truncation notice). OpenCodex does not attach the task, conversation history, tool results, tool catalog, worker identity or repair evidence. The worker must write a self-contained question with essential background. Empty questions are rejected without a provider call. Automatic preflight and adaptive repair consultations are paused; manual calls, consent and existing consultation limits still apply. The default `context` mode keeps the context-sharing behavior described below. Use `--context-mode context` to restore it.
Comment thread
wanqianquexiaobai marked this conversation as resolved.
Resolved

## Configuration

On the dashboard **Advisor** page (under the **Subagents** sidebar row), choose the expert model from the catalog selector. It saves the exact catalog identifier, including native, provider, account-qualified, custom and combo selectors. Disabled models and models awaiting initial selection are not offered as new choices. A saved identifier missing from the selectable catalog remains visible with a warning and is preserved until you choose another model or clear it. Catalog loading failures preserve the selection and provide Retry. Choose a model that can return text advice: the catalog does not guarantee consultation compatibility. The CLI and API continue to accept router-supported model strings.
Expand All @@ -36,6 +46,7 @@ On the dashboard **Advisor** page (under the **Subagents** sidebar row), choose
| `model?` | `string` | — | The expert model. Any model string the router accepts: a bare native model (`gpt-6-astra`), an explicit `provider/model` (`anthropic/claude-sonnet-4-6`, `xai/grok-...`), or an account-qualified native model. Cross-provider is fully supported: the worker and the advisor do not need to share a provider. |
| `effort?` | `string` | `"max"` | Reasoning effort for the advisor call (`low` through `ultra`). |
| `policy?` | `"manual" \| "preflight" \| "adaptive"` | `"manual"` | When the advisor is consulted. |
| `contextMode?` | `"context" \| "question-only"` | `"context"` | Context sharing. `question-only` requires an explicit worker question and pauses automatic consultations. |
| `maxConsultationsPerTask?` | `integer` | `3` | Adaptive task allowance (1–3 attempts), including manual calls. |
| `timeoutMs?` | `number` | `120000` | Loopback consultation timeout. |
| `contextSharingConsent?` | `"v1"` | absent | Operator consent to send task context to the configured Advisor provider. Only `"v1"` is current. Absent, stale, or any other value means no task context is sent. |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,16 @@ description: Независимые консультации с политика

Это отличается от поверхности сабагентов (см. [Конфигурацию агентов](/ru/reference/configuration/agents/)): сабагенты — это инициированная воркером делегация через инструменты совместной работы Codex. Консультант — прокси-sidecar, невидимый для клиента: даже воркер, который никогда ничего не spawn-ит, может получить совет.

## Только вопрос

Чтобы сократить повторную передачу данных, включите соответствующий режим на странице Advisor или выполните:

```sh
ocx advisor set --context-mode question-only
```

Режим передаёт только фиксированную инструкцию и вопрос исполнителя (до 2 000 символов плюс уведомление об усечении). Задача, история, результаты инструментов, каталог, сведения об исполнителе и доказательства неудачного исправления не добавляются. Исполнитель должен включить необходимые сведения в вопрос. Пустой вопрос отклоняется без обращения к провайдеру. Автоматические консультации preflight и adaptive приостанавливаются; согласие и существующие ограничения сохраняются. Режим по умолчанию `context` сохраняет описанное ниже поведение. Команда `--context-mode context` восстанавливает его.

## Конфигурация

На странице **Advisor** выберите модель из каталога. Селектор сохраняет точные идентификаторы нативных моделей, провайдеров, аккаунтов, пользовательских моделей и combo. Отключённые модели и модели, ожидающие начального выбора, не предлагаются. Сохранённый идентификатор вне доступного списка остаётся видимым с предупреждением до замены или очистки. Ошибка загрузки сохраняет выбор и позволяет повторить попытку. Выберите модель для текстовых советов: каталог не гарантирует совместимость консультаций. CLI и API по-прежнему принимают строки моделей, поддерживаемые маршрутизатором.
Expand All @@ -29,6 +39,7 @@ description: Независимые консультации с политика
| `model?` | `string` | — | Экспертная модель. Любая строка модели, которую принимает роутер: «голая» нативная модель (`gpt-6-astra`), явный `provider/model` (`anthropic/claude-sonnet-4-6`, `xai/grok-...`) или модель с квалификацией аккаунта. Полная поддержка межпровайдерных сценариев. |
| `effort?` | `string` | `"max"` | Интенсивность рассуждений вызова консультанта (`low`–`ultra`). |
| `policy?` | `"manual" \| "preflight" \| "adaptive"` | `"manual"` | Когда консультировать. |
| `contextMode?` | `"context" \| "question-only"` | `"context"` | Передача контекста. `question-only` требует явного вопроса исполнителя и приостанавливает автоматические консультации. |
| `maxConsultationsPerTask?` | `integer` | `3` | Бюджет адаптивной задачи: 1–3 попытки, включая ручные вызовы. |
| `timeoutMs?` | `number` | `120000` | Тайм-аут loopback-консультации. |
| `contextSharingConsent?` | `"v1"` | нет | Согласие оператора отправлять контекст задачи настроенному провайдеру консультанта. Текущая версия только `"v1"`. Отсутствие, устаревшее или иное значение означает, что содержимое задачи не отправляется. `enabled: true` само по себе не согласие. |
Expand Down
Loading
Loading