# Codex Agent

## 概覽

將 Codex CLI 作為 LangBot 運行器執行。

## 套件資訊

- **運行器 ID**: `plugin:langbot-team/CodexAgent/default`
- **版本**: `0.1.9`
- **程式碼儲存庫**: [https://github.com/langbot-app/LangBot/tree/master/plugins/Runner/codex-agent](https://github.com/langbot-app/LangBot/tree/master/plugins/Runner/codex-agent)

## 主要能力

- **已啟用**: `streaming`, `tool calling`, `knowledge retrieval`, `steering`
- **未宣告**: `multimodal input`, `interrupt`

## 設定

| 欄位 | 類型 | 必填 | 預設值 |
| --- | --- | --- | --- |
| `daemon-enabled` | `boolean` | 否 | false |
| `daemon-host` | `string` | 否 | `127.0.0.1` |
| `daemon-port` | `integer` | 否 | `8768` |
| `daemon-token` | `secret` | 否 | 空 |
| `location` | `select` | 是 | `local` |
| `workspace` | `string` | 否 | 空 |
| `advanced-settings` | `boolean` | 否 | false |
| `command` | `string` | 否 | `codex` |
| `args-json` | `string` | 否 | `[]` |
| `env-json` | `string` | 否 | `{}` |
| `ssh-target` | `string` | 否 | 空 |
| `ssh-port` | `integer` | 否 | `22` |
| `daemon-id` | `string` | 否 | 空 |
| `timeout` | `integer` | 否 | `300` |
| `streaming` | `boolean` | 否 | true |
| `reuse-session` | `boolean` | 否 | true |
| `approval-policy` | `select` | 否 | `never` |
| `sandbox-mode` | `select` | 否 | `danger-full-access` |
| `knowledge-bases` | `knowledge-base-multi-selector` | 否 | `[]` |
| `langbot-assets-enabled` | `boolean` | 否 | true |
| `mcp-bridge-transport` | `select` | 否 | `auto` |
| `mcp-servers-json` | `string` | 否 | `[]` |

## Host 權限

- **`tools`**: `detail`, `call`
- **`knowledge_bases`**: `retrieve`
- **`history`**: `page`

## 安裝與使用

1. 從 LangBot 外掛市場安裝此外掛。
2. 在 Pipeline 的運行器選擇器中選取下方運行器 ID。
3. 依照設定表填入連線資訊；密鑰欄位請使用管理介面保存。

## 安全與限制

- 預設設定以 `approvalPolicy=never` 及 `sandbox=danger-full-access` 啟動 Codex，且不會等待互動式核准；請只在受信任的工作區與權限受限的作業系統帳號下使用此預設設定。
- 運行器只能使用本次執行授權的 LangBot 資源。
- 外部服務的可用性、模型能力與速率限制由對應平台決定。
- 完整行為、進階設定與產品特定限制請參閱根目錄中文 README 或英文 README_en_US.md。


> Shared runtime / daemon upgrade: [required setup and safety contract](../README.md#shared-worker-candidate--daemon-upgrade). Shared 模式必须配置独立强 token 和端口；默认本地工作目录为 `/data/workspace`。请同时升级 daemon.py 与完整 pkg 目录；旧客户端不兼容。