Skip to content
Merged
Show file tree
Hide file tree
Changes from 7 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
14 changes: 9 additions & 5 deletions docs-site/src/content/docs/fr/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,11 +137,15 @@ Les déclarations d’outils Google sont compilées selon la classe du point de
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
`[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. `reject-lossy` refuse
la perte initiale ou une comparaison bornée indéterminée avant l’envoi. 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
12 changes: 8 additions & 4 deletions docs-site/src/content/docs/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -214,10 +214,14 @@ 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
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. `reject-lossy` rejects initial loss or an indeterminate bounded comparison before dispatch. 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
Comment thread
lidge-jun marked this conversation as resolved.
Resolved
Studio never performs this repair. Native output schemas are outside both policy paths. See the
[debug command reference](/reference/cli/agents/).


Expand Down
10 changes: 7 additions & 3 deletions docs-site/src/content/docs/ja/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,9 +127,13 @@ Google のツール宣言は、選択されたエンドポイントクラスに
デバッグを有効にすると、互換性変換でのスキーマ損失は
`[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
10 changes: 7 additions & 3 deletions docs-site/src/content/docs/ko/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,9 +124,13 @@ Google 도구 선언은 선택된 엔드포인트 클래스에 맞춰 컴파일
대시보드 Logs 토글 또는 `OCX_DEBUG=1`로 프로바이더 디버그를 켜면 호환성 변환 중 스키마 손실이
발생하면 `[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을 반환합니다. 정책을 생략하거나
Comment thread
lidge-jun marked this conversation as resolved.
Resolved
`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
12 changes: 8 additions & 4 deletions docs-site/src/content/docs/ru/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,10 +135,14 @@ ocx logout <provider>
провайдера включена командой `ocx debug provider on`, переключателем Logs в дашборде или переменной
`OCX_DEBUG=1`, потеря схемы при преобразовании совместимости записывает событие
`[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
Original file line number Diff line number Diff line change
Expand Up @@ -153,6 +153,7 @@ cross-route credential fallback не существует. Строки API GPT-
| `escapeBuiltinToolNames?` | `boolean` | Экранировать built-in tool name'ы для Anthropic-compatible gateway'ев и восстанавливать их в возвращаемых call'ах. |
| `anthropicEofTolerance?` | `boolean` | Позволяет Anthropic-совместимому шлюзу завершить поток до `message_stop`, только если получен видимый текст или полный JSON-объект аргументов инструмента. По умолчанию выключено. |
| `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. |
| `location?` | `string` | Локация Vertex; fallback через окружение — `GOOGLE_CLOUD_LOCATION`. |
| `mcpServers?` | `Record<string, CursorMcpServerConfig>` | Только Cursor: MCP-серверы в режимах stdio или Streamable HTTP. |
Expand Down
10 changes: 7 additions & 3 deletions docs-site/src/content/docs/tr/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,9 +150,13 @@ Google araç bildirimleri seçilen uç nokta sınıfına göre derlenir. Sağlay
`ocx debug provider on`, kontrol panelindeki Logs anahtarı veya `OCX_DEBUG=1` ile açıldığında,
uyumluluk dönüşümü sırasında şema kaybı bir `[ocx:google:google-tool-schema-loss]` kaydı yayınlar
(`ocx debug provider logs -f` ile takip edin). Kayıt yalnızca rapor sürümünü, uç nokta sınıfını,
bir `lossy` göstergesini, sınırlı sayımlara sahip sabit kayıp kategorilerini ve kesilme işaretini
taşır. Araç ve özellik adları, yollar, değerler ve şema metni hiçbir zaman dahil edilmez. Bu
tanılama mevcut uyumlu dönüşümü gözlemler ve isteği reddetmez. Yerel çıktı şemaları bu tanılamanın
bir `lossy` göstergesini, sınırlı bir belirsiz karşılaştırma sayısını, sınırlı sayımlara sahip sabit kayıp kategorilerini ve kesilme işaretini
taşır. Araç ve özellik adları, yollar, değerler ve şema metni hiçbir zaman dahil edilmez. Politika
yoksa veya `compatible` ise dönüşüm reddedilmeden gözlemlenir. `reject-lossy` ilk kaybı veya sonucu belirsiz sınırlı bir karşılaştırmayı gönderimden
önce reddeder. `reject-lossy` altında, kısıtları kaldıracak bir Vertex veya Cloud Code Assist onarımı
aynı şekilde içeriksiz bir `google-tool-schema-repair` kaydı üretir ve değiştirilmiş gönderim yapmadan
özgün 400 yanıtını döndürür; politika yoksa veya `compatible` ise onarılan istek daha önce olduğu gibi
yeniden gönderilir. Doğrudan AI Studio bu onarımı yapmaz. Yerel çıktı şemaları iki politika yolunun da
dışındadır. [Hata ayıklama komutu başvurusuna](/tr/reference/cli/agents/) bakın.


Expand Down
Loading
Loading