Skip to content

Commit dcc4124

Browse files
committed
docs(devin): finish the adapters reference in every locale
1 parent d44496c commit dcc4124

6 files changed

Lines changed: 126 additions & 0 deletions

File tree

‎docs-site/src/content/docs/fr/reference/adapters.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,27 @@ Si Kiro s’arrête sans appeler l’outil d’achèvement, l’adaptateur effec
144144
- Envoie les niveaux ordinaires de `cursor/grok-4.5` avec les identifiants de protocole exacts issus de la découverte en direct de Cursor (`cursor-grok-4.5-low`, `-medium` ou `-high`). `cursor/grok-4.5-fast` reste sélectionnable, mais le modèle canonique `grok-4.5` est envoyé avec des paramètres distincts `effort` et `fast=true`.
145145
- L’exécution locale native de commandes sur le système de fichiers, le shell ou le réseau par Cursor est refusée par défaut. Les intégrations explicites `mcpServers` et `desktopExecutor` disposent d’activations distinctes ; `nativeLocalExec: "on"` active l’exécuteur intégré plus large et contourne la sémantique d’approbation et de bac à sable de Codex. L’ancien réglage `unsafeAllowNativeLocalExec: true` reste équivalent uniquement lorsque `nativeLocalExec` n’est pas défini.
146146

147+
## `devin`
148+
149+
**Cible :** `exa.api_server_pb.ApiServerService/GetChatMessage` de Cognition, en streaming Connect sur `server.codeium.com`.
150+
**Authentification :** clé d'API Devin/Cognition issue de `provider.apiKey` ou de l'en-tête authorization transmis. La connexion ouvre l'authentification Auth0 dans le navigateur, puis échange le jeton via `SeatManagementService.RegisterUser` contre une clé durable.
151+
152+
- Utilise `runTurn` plutôt que le chemin fetch/parse ordinaire. Les requêtes et les événements serveur passent par le cadrage protobuf manuel de `devin/cloud-direct/wire.ts`.
153+
- Les modèles sont découverts par compte avec `GetCascadeModelConfigs` ; ceux qui ne figurent pas dans l'offre disparaissent de la liste au lieu d'échouer au moment de la requête.
154+
- Cognition impose une limite de longueur sur les descriptions d'outils et une liste de phrases interdites. L'adaptateur réécrit les formulations connues et tronque les descriptions trop longues.
155+
- Les clés ne se renouvellent pas. Relancez `ocx login devin` lorsqu'une clé expire ou est révoquée.
156+
157+
## `devin-cli`
158+
159+
**Cible :** la CLI Devin installée localement, pilotée via l'Agent Client Protocol (`devin acp`, JSON-RPC ligne par ligne sur stdio).
160+
**Authentification :** aucune côté opencodex. La CLI conserve ses propres identifiants issus de `devin auth login`.
161+
162+
- `runTurn` uniquement : une poignée de main sur un processus enfant n'a pas de requête à confier au chemin de transport générique.
163+
- Un tour correspond à une session ACP : `initialize`, `session/new`, `session/prompt`, avec les notifications `session/update` qui arrivent entre-temps.
164+
- Les appels d'outils de la CLI restent internes. Devin les exécute dans sa session ; les transmettre comme outils client ferait échouer le tour ou exécuterait deux fois la même action.
165+
- **Les demandes d'autorisation sont refusées par défaut.** Ce fournisseur exécute un agent dans l'arborescence de l'utilisateur : l'autorisation exige `OPENCODEX_DEVIN_CLI_ALLOW_TOOLS=1`, et l'enfant reçoit un environnement restreint plutôt que celui du proxy.
166+
- L'exécutable est cherché via `OPENCODEX_DEVIN_CLI_BIN`, puis les chemins d'installation officiels, puis `PATH`.
167+
147168
## `azure-openai` (alias : `azure`)
148169

149170
**Cibles :** **Azure OpenAI**. Encapsule `openai-responses` (et utilise donc également `passthrough: true`).

‎docs-site/src/content/docs/ja/reference/adapters.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,6 +175,27 @@ model discovery の両方に適用されます。
175175
モデルを送信し、個別の `effort` および `fast=true` 値は `requested_model.parameters` に格納します。
176176
- Cursor ネイティブのローカルファイルシステム/shell/network 実行はデフォルトで拒否します。明示的な `mcpServers` と `desktopExecutor` 統合はそれぞれ別の opt-in です。`nativeLocalExec: "on"` はより広い組み込み executor を有効にし、Codex の承認/サンドボックスルールを迂回します。従来の `unsafeAllowNativeLocalExec: true` は、`nativeLocalExec` が設定されていない場合にのみ同等です。
177177

178+
## `devin`
179+
180+
**対象:** Cognition の `exa.api_server_pb.ApiServerService/GetChatMessage`(`server.codeium.com`、Connect ストリーミング)。
181+
**認証:** `provider.apiKey` または転送された authorization ヘッダーの Devin/Cognition API キー。ログインは Auth0 のブラウザサインインを開き、`SeatManagementService.RegisterUser` で長期キーに交換します。
182+
183+
- 通常の fetch/parse ではなく `runTurn` を使います。リクエストとサーバーイベントは `devin/cloud-direct/wire.ts` の手動 protobuf フレーミングで扱います。
184+
- `GetCascadeModelConfigs` でアカウントごとにモデルを取得し、プランに含まれないモデルはリクエスト時ではなく一覧の段階で外れます。
185+
- Cognition はツール説明の長さ制限と完全一致のブロックリストを課します。アダプターが既知の語句を書き換え、長すぎる説明を切り詰めます。
186+
- キーは更新されません。失効したら `ocx login devin` をやり直してください。
187+
188+
## `devin-cli`
189+
190+
**対象:** ローカルにインストールされた Devin CLI。Agent Client Protocol(`devin acp`、stdio 上の行区切り JSON-RPC)で駆動します。
191+
**認証:** opencodex は何も保持しません。CLI が `devin auth login` の資格情報を自分で持ちます。
192+
193+
- `runTurn` 専用です。子プロセスのハンドシェイクには汎用ワイヤ経路に渡せるリクエストがありません。
194+
- 1 ターンが 1 つの ACP セッションです。`initialize`、`session/new`、`session/prompt` の順に進み、その間に `session/update` が流れます。
195+
- CLI 自身のツール呼び出しは外に出しません。Devin がセッション内で実行するため、クライアントツールとして転送するとターンが失敗するか同じ作業が二重に実行されます。
196+
- **権限要求は既定で拒否します。** このプロバイダーは利用者自身のツリーでエージェントを動かすため、`OPENCODEX_DEVIN_CLI_ALLOW_TOOLS=1` を設定した場合にのみ許可し、子プロセスにはプロキシの環境ではなく限定した環境を渡します。
197+
- 実行ファイルは `OPENCODEX_DEVIN_CLI_BIN`、公式インストール先、`PATH` の順に探します。
198+
178199
## `azure-openai`(別名: `azure`)
179200

180201
**対象:** **Azure OpenAI**。`openai-responses` を包むため、同じく `passthrough: true` です。

‎docs-site/src/content/docs/ru/reference/adapters.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -235,6 +235,27 @@ authorization.
235235
одобрений/песочницы Codex; устаревший `unsafeAllowNativeLocalExec: true` эквивалентен только
236236
если `nativeLocalExec` не задан.
237237

238+
## `devin`
239+
240+
**Назначение:** `exa.api_server_pb.ApiServerService/GetChatMessage` в Cognition, потоковая передача Connect на `server.codeium.com`.
241+
**Аутентификация:** ключ API Devin/Cognition из `provider.apiKey` или переданного заголовка authorization. Вход открывает страницу Auth0 в браузере, после чего токен обменивается через `SeatManagementService.RegisterUser` на долгоживущий ключ.
242+
243+
- Используется `runTurn`, а не обычный путь fetch/parse. Запросы и серверные события кодируются вручную в `devin/cloud-direct/wire.ts`.
244+
- Модели запрашиваются для каждой учётной записи через `GetCascadeModelConfigs`; отсутствующие в тарифе отсеиваются в списке, а не падают в момент запроса.
245+
- Cognition ограничивает длину описаний инструментов и блокирует точные фразы. Адаптер переписывает известные формулировки и обрезает слишком длинные описания.
246+
- Ключи не обновляются. После истечения или отзыва выполните `ocx login devin` заново.
247+
248+
## `devin-cli`
249+
250+
**Назначение:** локально установленный Devin CLI, управляемый по Agent Client Protocol (`devin acp`, построчный JSON-RPC поверх stdio).
251+
**Аутентификация:** opencodex ничего не хранит. Учётные данные после `devin auth login` держит сам CLI.
252+
253+
- Только `runTurn`: у рукопожатия через дочерний процесс нет запроса для общего транспортного пути.
254+
- Один ход — одна сессия ACP: `initialize`, `session/new`, `session/prompt`, между ними приходят уведомления `session/update`.
255+
- Собственные вызовы инструментов CLI наружу не уходят. Devin выполняет их внутри сессии, и передача их как клиентских инструментов либо срывает ход, либо приводит к двойному выполнению.
256+
- **Запросы разрешений по умолчанию отклоняются.** Этот провайдер запускает агента в рабочем дереве пользователя, поэтому разрешение требует `OPENCODEX_DEVIN_CLI_ALLOW_TOOLS=1`, а дочерний процесс получает урезанное окружение, а не окружение прокси.
257+
- Исполняемый файл ищется в `OPENCODEX_DEVIN_CLI_BIN`, затем по официальным путям установки, затем в `PATH`.
258+
238259
## `azure-openai` (алиас: `azure`)
239260

240261
**Назначение:** **Azure OpenAI**. Обёртка над `openai-responses` (поэтому тоже

‎docs-site/src/content/docs/tr/reference/adapters.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -308,6 +308,27 @@ başlığından Cursor OAuth/erişim belirteci.
308308
`unsafeAllowNativeLocalExec: true` yalnızca `nativeLocalExec` ayarlanmadığında
309309
eşdeğer kalır.
310310

311+
## `devin`
312+
313+
**Hedef:** Cognition'ın `exa.api_server_pb.ApiServerService/GetChatMessage` uç noktası; `server.codeium.com` üzerinde Connect akışı.
314+
**Kimlik doğrulama:** `provider.apiKey` veya iletilen authorization başlığındaki Devin/Cognition API anahtarı. Giriş tarayıcıda Auth0 oturumunu açar, ardından belirteci `SeatManagementService.RegisterUser` ile uzun ömürlü bir anahtara dönüştürür.
315+
316+
- Olağan fetch/parse yolu yerine `runTurn` kullanır. İstekler ve sunucu olayları `devin/cloud-direct/wire.ts` içindeki elle yazılmış protobuf çerçevelemesiyle işlenir.
317+
- Modeller hesaba göre `GetCascadeModelConfigs` ile keşfedilir; pakette olmayanlar istek anında hata vermek yerine listeden düşer.
318+
- Cognition araç açıklamaları için uzunluk sınırı ve birebir ifade engeli uygular. Bağdaştırıcı bilinen ifadeleri yeniden yazar, uzun açıklamaları kırpar.
319+
- Anahtarlar yenilenmez. Süresi dolduğunda veya iptal edildiğinde `ocx login devin` komutunu yeniden çalıştırın.
320+
321+
## `devin-cli`
322+
323+
**Hedef:** yerelde kurulu Devin CLI; Agent Client Protocol ile (`devin acp`, stdio üzerinde satır ayrımlı JSON-RPC) sürülür.
324+
**Kimlik doğrulama:** opencodex tarafında hiçbir şey saklanmaz. Kimlik bilgilerini `devin auth login` sonrası CLI'nin kendisi taşır.
325+
326+
- Yalnızca `runTurn`: alt süreç üzerinden yapılan el sıkışmanın genel taşıma yoluna verilecek bir isteği yoktur.
327+
- Bir tur bir ACP oturumudur: `initialize`, `session/new`, `session/prompt`; aralarında `session/update` bildirimleri akar.
328+
- CLI'nin kendi araç çağrıları dışarı verilmez. Devin bunları kendi oturumunda çalıştırır; istemci aracı olarak iletmek ya turu başarısız kılar ya da aynı işi iki kez çalıştırır.
329+
- **İzin istekleri varsayılan olarak reddedilir.** Bu sağlayıcı kullanıcının kendi ağacında bir ajan çalıştırır; izin için `OPENCODEX_DEVIN_CLI_ALLOW_TOOLS=1` gerekir ve alt sürece vekilin ortamı değil kısıtlı bir ortam verilir.
330+
- Çalıştırılabilir dosya sırasıyla `OPENCODEX_DEVIN_CLI_BIN`, resmi kurulum yolları ve `PATH` içinde aranır.
331+
311332
## `azure-openai` (takma ad: `azure`)
312333

313334
**Hedefler:** **Azure OpenAI**. `openai-responses`'ı sarar (bu nedenle

‎docs-site/src/content/docs/zh-cn/reference/adapters.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,27 @@ Cursor 的 HTTP/1.1 兼容传输:通过 `agent.v1.AgentService/RunSSE` 接收
194194
executor,并绕过 Codex 审批和 sandbox 语义;旧的 `unsafeAllowNativeLocalExec: true` 仅在
195195
`nativeLocalExec` 未设置时等同。
196196

197+
## `devin`
198+
199+
**目标:** Cognition 的 `exa.api_server_pb.ApiServerService/GetChatMessage`(`server.codeium.com`,Connect 流式)。
200+
**认证:** 来自 `provider.apiKey` 或转发的 authorization 头的 Devin/Cognition API 密钥。登录会打开 Auth0 浏览器页面,再通过 `SeatManagementService.RegisterUser` 换取长期密钥。
201+
202+
- 使用 `runTurn` 而非常规的 fetch/parse 路径。请求与服务端事件由 `devin/cloud-direct/wire.ts` 手写的 protobuf 分帧处理。
203+
- 通过 `GetCascadeModelConfigs` 按账号获取模型;不在套餐内的模型在列表阶段就被过滤,而不是到请求时才失败。
204+
- Cognition 对工具说明有长度上限和精确短语黑名单。适配器会改写已知短语并截断过长的说明。
205+
- 密钥不会刷新。失效后请重新执行 `ocx login devin`。
206+
207+
## `devin-cli`
208+
209+
**目标:** 本地安装的 Devin CLI,通过 Agent Client Protocol(`devin acp`,stdio 上按行分隔的 JSON-RPC)驱动。
210+
**认证:** opencodex 不保存任何凭据。CLI 自己持有 `devin auth login` 的凭据。
211+
212+
- 仅走 `runTurn`。子进程握手没有可交给通用传输路径的请求。
213+
- 一次对话就是一个 ACP 会话:`initialize`、`session/new`、`session/prompt`,其间由 `session/update` 推送增量。
214+
- CLI 自身的工具调用不会外发。Devin 在会话内自行执行,若作为客户端工具转发,要么让这一轮失败,要么同一操作被执行两次。
215+
- **权限请求默认拒绝。** 该提供方在使用者自己的工作树中运行代理,只有设置 `OPENCODEX_DEVIN_CLI_ALLOW_TOOLS=1` 才放行,子进程拿到的是受限环境而非代理自身的环境。
216+
- 可执行文件按 `OPENCODEX_DEVIN_CLI_BIN`、官方安装路径、`PATH` 的顺序查找。
217+
197218
## `azure-openai`(别名:`azure`)
198219

199220
**目标:** **Azure OpenAI**。封装 `openai-responses`,因此同样是 `passthrough: true`。

‎docs-site/src/content/docs/zh-tw/reference/adapters.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,27 @@ Kiro 的 assistant 文字本身沒有可靠的回合結束標記,但終止的
166166
executor,並繞過 Codex 審批和 sandbox 語義;舊的 `unsafeAllowNativeLocalExec: true` 僅在
167167
`nativeLocalExec` 未設定時等效。
168168

169+
## `devin`
170+
171+
**目標:** Cognition 的 `exa.api_server_pb.ApiServerService/GetChatMessage`(`server.codeium.com`,Connect 串流)。
172+
**認證:** 來自 `provider.apiKey` 或轉送 authorization 標頭的 Devin/Cognition API 金鑰。登入會開啟 Auth0 瀏覽器頁面,再透過 `SeatManagementService.RegisterUser` 換取長期金鑰。
173+
174+
- 使用 `runTurn` 而非一般的 fetch/parse 路徑。請求與伺服器事件由 `devin/cloud-direct/wire.ts` 手寫的 protobuf 分幀處理。
175+
- 以 `GetCascadeModelConfigs` 依帳號取得模型;方案未涵蓋的模型在清單階段就被濾除。
176+
- Cognition 對工具說明設有長度上限與完全比對的封鎖清單。轉接器會改寫已知語句並截斷過長說明。
177+
- 金鑰不會更新。失效後請重新執行 `ocx login devin`。
178+
179+
## `devin-cli`
180+
181+
**目標:** 本機安裝的 Devin CLI,透過 Agent Client Protocol(`devin acp`,stdio 上以換行分隔的 JSON-RPC)驅動。
182+
**認證:** opencodex 不保存任何憑證。CLI 自行持有 `devin auth login` 的憑證。
183+
184+
- 僅走 `runTurn`。子行程握手沒有可交給通用傳輸路徑的請求。
185+
- 一次對話就是一個 ACP 工作階段:`initialize`、`session/new`、`session/prompt`,其間由 `session/update` 推送增量。
186+
- CLI 自身的工具呼叫不會外送。Devin 在工作階段內自行執行,若當成用戶端工具轉送,不是讓這一輪失敗就是同一操作被執行兩次。
187+
- **權限請求預設拒絕。** 此提供者在使用者自己的工作樹中執行代理,只有設定 `OPENCODEX_DEVIN_CLI_ALLOW_TOOLS=1` 才放行,子行程取得的是受限環境。
188+
- 執行檔依 `OPENCODEX_DEVIN_CLI_BIN`、官方安裝路徑、`PATH` 的順序尋找。
189+
169190
## `azure-openai`(別名:`azure`)
170191

171192
**目標:** **Azure OpenAI**。封裝 `openai-responses`,因此同樣是 `passthrough: true`。

0 commit comments

Comments
 (0)