整合設定
MCP 設定
兩層;session 覆寫全域。以 TUI /mcp 或 /v1/mcp* 端點管理 server。完整 schema 與 ${VAR} 展開行為見 MCP 客戶端頁。
供應商設定
已無靜態供應商目錄——新增模型時由各供應商 API 取得模型清單。已註冊模型存於 config.json;憑證絕不存於此,而是存於 OS keychain 的 agenvoy 服務下。
Compat provider URL 儲存拆分
compat provider URL 採 two-storage 模型:
| 內容 | 位置 | 原因 |
|---|---|---|
URL(例如 http://host:8000/v1) |
~/.config/agenvoy/config.json 的 compats[].URL |
非機密、可由 user 編輯 |
API key(COMPAT_<NAME>_API_KEY) |
OS keychain | 機密 |
URL 慣例遵循 Zed:輸入至 /v1 為止的 URL(例如 http://localhost:11434/v1),router 自行附加 /chat/completions。URL 由 config 讀取,非 keychain。不存在 COMPAT_<NAME>_URL keychain key(刻意移除:一個歷史 bug 曾讓 TUI 寫入 config 而 runtime 讀 keychain,導致總是 fallback 到 localhost)。
KuraDB
啟用狀態為 config.json 中的 kuradb_enabled: bool。以 TUI /kuradb 切換;POST /v1/kuradb 可對已安裝的實例啟用、停用、啟動、停止與重啟,安裝與解除安裝仍僅限 TUI(install.sh + sudo 需要真實 TTY)。完整生命週期見 KuraDB 與 RAG 頁。
| Key | 位置 |
|---|---|
kuradb_enabled |
config.json |
OPENAI_API_KEY |
keychain(agenvoy service) — 與 semantic search 共用 |
| Endpoint URL(runtime) | ~/.config/kuradb/endpoint(明文,每次 spawn 隨機 port) |
| Binary | /usr/local/bin/kura(install.sh 中 hardcode) |
Telegram / Discord 啟用
| Key | 位置 |
|---|---|
telegram_enabled / discord_enabled |
config.json |
TELEGRAM_TOKEN / DISCORD_TOKEN |
keychain(agenvoy service) |
| 授權的 chat ID | ~/.config/agenvoy/.telegram 與 ~/.config/agenvoy/.discord(每行一個 ID,於 6 位數 OTP 驗證成功後寫入) |
| 驗證碼轉發 | config.json 的 admin_channel——TUI /admin-channel 可選已授權聊天或直接指定 tg@<id> / dc@<id> |
| 語音回覆 | config.json 的 enable_voice,以 /voice 切換(Gemini TTS;僅 Telegram) |
兩個 channel 也可透過 POST /v1/channel/telegram 與 POST /v1/channel/discord 啟用或停用,該端點儲存 token 並翻轉旗標;daemon 的設定 watcher 會重連 bot 並補上帳號名稱。平台格式規則內嵌於 channel system prompt——已無 format_chatbot 工具。
哪些東西刻意不存放於此
一些刻意的非儲存位置:
- Provider API key — 絕不存於
config.json;一律存 keychain - MCP 憑證 — 在
mcp.json中使用${VAR}佔位符,實際值放在 env var(或透過 shell init 存入 keychain) - 由
store_secret捕獲的機密 — 僅落於 keychain;絕不進入 LLM context、history、action.log 或 tool args - Session history — 存於 ToriiDB 與 SQLite 封存,不散落在各 session 的 JSON 檔
- Tool call 結果 — 單次執行內的記憶體去重,加上
fetch_page/search_web/search_google_news30 分鐘的 ToriiDB cache;其餘不跨重啟保留