Skip to content
Merged
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
18 changes: 12 additions & 6 deletions docs-site/src/content/docs/fr/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,13 +135,19 @@ Les vérifications de quota Google Antigravity utilisent des points de terminais

Les déclarations d’outils Google sont compilées selon la classe du point de terminaison sélectionné.
Lorsque le débogage du fournisseur est activé — avec `ocx debug provider on`, le bouton Logs du
tableau de bord ou `OCX_DEBUG=1` — la perte de schéma lors de la conversion de compatibilité émet un enregistrement
tableau de bord ou `OCX_DEBUG=1` — la perte de schéma lors de la conversion de compatibilité sur le
chemin où la politique est absente ou vaut `compatible` émet un enregistrement
`[ocx:google:google-tool-schema-loss]` (à suivre avec `ocx debug provider logs -f`) ne contenant que
la version du rapport, la classe du point de terminaison, un indicateur `lossy`, des catégories de
perte fixes avec des compteurs bornés et un indicateur de troncature. Les noms d’outils et de
propriétés, les chemins, les valeurs et le texte du schéma ne sont jamais inclus. Ce diagnostic
observe la conversion compatible existante sans rejeter la requête. Les schémas de sortie natifs
n’entrent pas dans ce diagnostic. Consultez la
la version du rapport, la classe du point de terminaison, un indicateur `lossy`, un compteur borné de
comparaisons indéterminées, des catégories de perte fixes avec des compteurs bornés et un indicateur de troncature. Les noms d’outils et de
propriétés, les chemins, les valeurs et le texte du schéma ne sont jamais inclus. Avec une politique
absente ou `compatible`, ce diagnostic observe la conversion sans la refuser. Sous `reject-lossy`,
une compilation initialement avec perte ou dont la comparaison bornée est indéterminée est refusée
avant l’envoi ; aucun enregistrement de perte distinct n’est émis pour la requête refusée. Sous `reject-lossy`, une
réparation Vertex ou Cloud Code Assist qui supprimerait des contraintes émet un enregistrement
`google-tool-schema-repair` également sans contenu et renvoie le 400 d’origine sans nouvel envoi ;
avec une politique absente ou `compatible`, la requête réparée est rejouée comme auparavant. AI Studio direct ne tente jamais cette réparation. Les schémas
de sortie natifs restent hors de ces deux chemins. Consultez la
[référence des commandes de débogage](/fr/reference/cli/agents/).


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -148,6 +148,7 @@ sauvegarde dont le contenu diffère, puis réécrit en identifiants sans préfix
| `escapeBuiltinToolNames?` | `boolean` | Échapper aux noms d'outils intégrés pour les passerelles compatibles Anthropic et les restaurer lors des appels renvoyés. |
| `anthropicEofTolerance?` | `boolean` | Laissez une passerelle compatible Anthropic compléter un flux qui se termine avant `message_stop`, uniquement lorsque du texte visible ou une entrée complète d'outil d'objet JSON a été reçue. Désactivé par défaut. |
| `googleMode?` | `"ai-studio" \| "vertex" \| "cloud-code-assist"` | Mode Google transport/auth. Par défaut `ai-studio`. |
| `googleToolSchemaPolicy?` | `"compatible" \| "reject-lossy"` | Google uniquement. Une valeur absente ou `compatible` conserve le schéma compatible et la réparation 400 existante hors mode direct. `reject-lossy` refuse une perte initiale ou une comparaison bornée indéterminée avant l’envoi et bloque une réparation Vertex ou Cloud Code Assist qui ouvrirait des contraintes. AI Studio direct n’effectue jamais cette réparation. |
| `project?` | `string` | ID du projet Vertex ou Antigravity Cloud Code Assist. |
| `location?` | `string` | Région Vertex ; la valeur de repli de l'environnement est `GOOGLE_CLOUD_LOCATION`. |
| `mcpServers?` | `Record<string, CursorMcpServerConfig>` | Cursor uniquement : serveurs MCP sur entrée-sortie standard ou HTTP diffusé en continu. |
Expand Down
16 changes: 11 additions & 5 deletions docs-site/src/content/docs/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,11 +213,17 @@ Google Antigravity account and provider quota probes use fixed Google accounting

Google tool declarations are compiled against the selected endpoint class. When provider debug is
on — `ocx debug provider on`, the dashboard Logs toggle, or `OCX_DEBUG=1` — schema loss during compatibility
conversion emits a `[ocx:google:google-tool-schema-loss]` record (tail with `ocx debug provider logs -f`)
carrying only the report version, endpoint class, a `lossy` indicator, fixed loss categories with
bounded counts, and a truncation flag. Tool and property names, paths, values, and schema text are
never included. This diagnostic observes the existing compatible conversion and does not reject
the request. Native output schemas are outside this diagnostic. See the
conversion on the omitted or `compatible` policy path emits a `[ocx:google:google-tool-schema-loss]`
record (tail with `ocx debug provider logs -f`)
carrying only the report version, endpoint class, a `lossy` indicator, a bounded uncertainty count,
fixed loss categories with bounded counts, and a truncation flag. Tool and property names, paths, values, and schema text are
never included. With an omitted or `compatible` policy, this diagnostic observes the existing
conversion without rejecting it. Under `reject-lossy`, an initially lossy or comparison-indeterminate
compilation is refused before dispatch; no separate loss record is emitted for the refused request. Under
`reject-lossy`, a Vertex or Cloud Code Assist repair that would erase constraints emits a similarly
content-free `google-tool-schema-repair` record and returns the original 400 without a changed send;
with an omitted or `compatible` policy, the repaired request is replayed as before. Direct AI
Studio never performs this repair. Native output schemas are outside both policy paths. See the
[debug command reference](/reference/cli/agents/).


Expand Down
13 changes: 9 additions & 4 deletions docs-site/src/content/docs/ja/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,12 +124,17 @@ Google Antigravity のアカウント・プロバイダーのクォータ確認

Google のツール宣言は、選択されたエンドポイントクラスに合わせてコンパイルされます。
`ocx debug provider on`、ダッシュボードの Logs トグル、または `OCX_DEBUG=1` でプロバイダー
デバッグを有効にすると、互換性変換でのスキーマ損失は
デバッグを有効にすると、ポリシーの省略時または `compatible` の互換性変換でのスキーマ損失は
`[ocx:google:google-tool-schema-loss]` レコードを出力します(`ocx debug provider logs -f` で
追跡できます)。レコードに含まれるのは、レポートのバージョン、エンドポイントクラス、
`lossy` インジケーター、上限付き件数を伴う固定の損失カテゴリ、切り詰めフラグだけです。
ツール名、プロパティ名、パス、値、スキーマ本文は含まれません。この診断は既存の互換変換を
観測するだけで、要求を拒否しません。ネイティブ出力スキーマは診断対象外です。
`lossy` インジケーター、判定不能な比較の上限付き件数、上限付き件数を伴う固定の損失カテゴリ、切り詰めフラグだけです。
ツール名、プロパティ名、パス、値、スキーマ本文は含まれません。ポリシーの省略時または
`compatible` では変換を拒否せず観測します。`reject-lossy` では、初期コンパイルに損失がある場合、
または上限付き比較が判定不能な場合、送信前に拒否します。拒否されたリクエストに別の損失レコードは
出力されません。`reject-lossy` では、制約を消す Vertex または Cloud Code Assist の修復は同様に内容を含まない
`google-tool-schema-repair` を出力し、変更送信を行わず元の 400 を返します。ポリシーの省略時または
`compatible` では、修復済みリクエストを従来どおり再送します。直接 AI Studio は
この修復を行いません。ネイティブ出力スキーマは両方のポリシー経路の対象外です。
[デバッグコマンドのリファレンス](/ja/reference/cli/agents/)も参照してください。


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,7 @@ account を削除しても mapping は保持され、同じ id を再追加す
| `escapeBuiltinToolNames?` | `boolean` | Anthropic 互換ゲートウェイの組み込みツール名をエスケープし、返された呼び出しで復元します。 |
| `anthropicEofTolerance?` | `boolean` | `message_stop` 前にストリームが終了しても、可視テキストまたは完全な JSON オブジェクトのツール入力が受信済みの場合に限り完了を許可します(Anthropic 互換ゲートウェイ向け)。デフォルトはオフ。 |
| `googleMode?` | `"ai-studio" \| "vertex" \| "cloud-code-assist"` | Google トランスポート/認証モード。デフォルトは`ai-studio`です。 |
| `googleToolSchemaPolicy?` | `"compatible" \| "reject-lossy"` | Google 専用です。省略時または `compatible` は互換スキーマと既存の非直接 400 修復を維持します。`reject-lossy` は初期損失または判定不能な上限付き比較を送信前に拒否し、制約を開く Vertex/Cloud Code Assist 修復を保留します。直接 AI Studio はこの修復を行いません。 |
| `project?` | `string` | Vertex または Antigravity Cloud Code Assist プロジェクト ID。 |
| `location?` | `string` |頂点の位置。環境フォールバックは `GOOGLE_CLOUD_LOCATION` です。 |
| `mcpServers?` | `Record<string, CursorMcpServerConfig>` |カーソルのみ: 標準入出力またはストリーミング可能な HTTP MCP サーバー。 |
Expand Down
15 changes: 10 additions & 5 deletions docs-site/src/content/docs/ko/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,12 +121,17 @@ Google Antigravity 계정·제공자 할당량 확인은 모델 목록 폴백을
### Google 도구 스키마 손실 진단

Google 도구 선언은 선택된 엔드포인트 클래스에 맞춰 컴파일됩니다. `ocx debug provider on`,
대시보드 Logs 토글 또는 `OCX_DEBUG=1`로 프로바이더 디버그를 켜면 호환성 변환 중 스키마 손실이
발생하면 `[ocx:google:google-tool-schema-loss]` 레코드를 기록합니다
대시보드 Logs 토글 또는 `OCX_DEBUG=1`로 프로바이더 디버그를 켜면 정책을 생략하거나
`compatible`인 호환성 변환 중 스키마 손실이 발생할 때 `[ocx:google:google-tool-schema-loss]` 레코드를 기록합니다
(`ocx debug provider logs -f`로 tail할 수 있습니다). 이 레코드에는 보고서 버전, 엔드포인트
클래스, `lossy` 표시, 상한이 있는 개수를 포함한 고정 손실 범주, 잘림 여부만 들어갑니다.
도구명과 속성명, 경로, 값, 스키마 본문은 포함하지 않습니다. 이 진단은 기존 호환 변환을
관찰할 뿐 요청을 거부하지 않습니다. 네이티브 출력 스키마는 이 진단의 대상이 아닙니다.
클래스, `lossy` 표시, 판정 불가능한 비교의 상한 개수, 상한이 있는 개수를 포함한 고정 손실 범주, 잘림 여부만 들어갑니다.
도구명과 속성명, 경로, 값, 스키마 본문은 포함하지 않습니다. 정책을 생략하거나
`compatible`이면 변환을 거부하지 않고 관찰합니다. `reject-lossy`에서는 초기 컴파일에 손실이 있거나
상한 비교를 판정할 수 없으면 전송 전에 거부합니다. 거부된 요청에는 별도의 손실 레코드를 기록하지
않습니다. `reject-lossy`에서는 제약을 지우는 Vertex 또는 Cloud Code Assist 복구가 동일하게 내용이 없는
`google-tool-schema-repair`를 기록하고 변경 전송 없이 원래 400을 반환합니다. 정책을 생략하거나
`compatible`이면 복구된 요청을 이전과 같이 다시 전송합니다. 직접 AI Studio는
이 복구를 수행하지 않습니다. 네이티브 출력 스키마는 두 정책 경로 모두의 대상이 아닙니다.
[디버그 명령어 참고 문서](/ko/reference/cli/agents/)도 확인하세요.


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,7 @@ managed map을 활성화하면 privacy-safe selector를 만들고, 이후 계정
| `escapeBuiltinToolNames?` | `boolean` | Anthropic 호환 게이트웨이를 위해 내장 도구 이름을 이스케이프하고, 반환된 호출에서는 다시 복원합니다. |
| `anthropicEofTolerance?` | `boolean` | `message_stop` 전에 스트림이 끝나도 표시 텍스트 또는 완전한 JSON 객체 툴 입력을 받은 경우에만 완료를 허용합니다(Anthropic 호환 게이트웨이용). 기본값은 꺼짐. |
| `googleMode?` | `"ai-studio" \| "vertex" \| "cloud-code-assist"` | Google 전송/인증 모드입니다. 기본값은 `ai-studio`입니다. |
| `googleToolSchemaPolicy?` | `"compatible" \| "reject-lossy"` | Google 전용입니다. 생략하거나 `compatible`이면 호환 스키마와 기존 비직접 400 복구를 유지합니다. `reject-lossy`는 초기 손실 또는 판정 불가능한 상한 비교를 전송 전에 거부하고 제약을 개방하는 Vertex 또는 Cloud Code Assist 복구를 보류합니다. 직접 AI Studio는 이 복구를 수행하지 않습니다. |
| `project?` | `string` | Vertex 또는 Antigravity Cloud Code Assist 프로젝트 id입니다. |
| `location?` | `string` | Vertex 위치입니다. 환경 변수 폴백은 `GOOGLE_CLOUD_LOCATION`입니다. |
| `mcpServers?` | `Record<string, CursorMcpServerConfig>` | Cursor 전용입니다. stdio 또는 Streamable HTTP MCP 서버입니다. |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -218,6 +218,7 @@ Providers can expose a built-in shorthand, such as `agy` for `google-antigravity
| `escapeBuiltinToolNames?` | `boolean` | Escape built-in tool names for Anthropic-compatible gateways and restore them in returned calls. |
| `anthropicEofTolerance?` | `boolean` | Let an Anthropic-compatible gateway complete a stream that ends before `message_stop`, only when visible text or a complete JSON-object tool input was received. Off by default. |
| `googleMode?` | `"ai-studio" \| "vertex" \| "cloud-code-assist"` | Google transport/auth mode. Default `ai-studio`. |
| `googleToolSchemaPolicy?` | `"compatible" \| "reject-lossy"` | Google only. Omitted/`compatible` preserves the compatible tool schema and existing non-direct 400 repair. `reject-lossy` rejects initial schema loss or an indeterminate bounded comparison before dispatch and withholds a Vertex or Cloud Code Assist repair that would open constraints. Direct AI Studio never performs that repair. |
| `directGeminiWireRenames?` | `boolean` | Google only. Applies only to direct AI Studio requests. Omitted or `true` keeps the `-tiered` wire rename for Gemini Flash ids (`gemini-3.7-flash` -> `gemini-3.7-flash-tiered`); `false` sends the requested bare ids to the wire unchanged. Vertex preserves the requested model ID, and Cloud Code Assist routing is unchanged. Set `false` when the configured upstream still serves the bare ids. |
| `project?` | `string` | Vertex or Antigravity Cloud Code Assist project id. |
| — | — | Antigravity account quota probes (`retrieveUserQuota` and `retrieveUserQuotaSummary`) always go to Google's own Cloud Code host through the pinned outbound transport, regardless of a configured `baseUrl`; the account bearer is never sent to an operator-configured endpoint and a redirect aborts the probe. Only the model-list fallback still honors `baseUrl`. |
Expand Down
17 changes: 12 additions & 5 deletions docs-site/src/content/docs/ru/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,12 +133,19 @@ ocx logout <provider>

Объявления инструментов Google компилируются для выбранного класса конечной точки. Когда отладка
провайдера включена командой `ocx debug provider on`, переключателем Logs в дашборде или переменной
`OCX_DEBUG=1`, потеря схемы при преобразовании совместимости записывает событие
`OCX_DEBUG=1`, потеря схемы при преобразовании совместимости на пути с отсутствующей политикой или
`compatible` записывает событие
`[ocx:google:google-tool-schema-loss]` (следите за ним через `ocx debug provider logs -f`). Оно
содержит только версию отчёта, класс конечной точки, индикатор `lossy`, фиксированные категории
потерь с ограниченными счётчиками и признак усечения. Имена инструментов и свойств, пути, значения
и текст схемы не включаются. Диагностика только наблюдает существующее совместимое преобразование
и не отклоняет запрос. Нативные схемы вывода в неё не входят. См.
содержит только версию отчёта, класс конечной точки, индикатор `lossy`, ограниченный счётчик
неопределённых сравнений, фиксированные категории потерь с ограниченными счётчиками и признак усечения. Имена инструментов и свойств, пути, значения
и текст схемы не включаются. При отсутствии политики или `compatible` преобразование только
наблюдается. При `reject-lossy` начальная компиляция с потерей или неопределённым результатом
ограниченного сравнения отклоняется до отправки; отдельное событие потери для отклонённого запроса
не записывается. При `reject-lossy`
восстановление Vertex или Cloud Code Assist, снимающее ограничения, пишет столь же безопасное событие
`google-tool-schema-repair` и возвращает исходный 400 без изменённой отправки; при отсутствии политики
или при `compatible` исправленный запрос повторяется как прежде. Прямой AI Studio
такое восстановление не выполняет. Нативные схемы вывода исключены из обоих путей. См.
[справочник команд отладки](/ru/reference/cli/agents/).


Expand Down
Loading
Loading