文件導航

Agent:MCP 與 skill

一次決策大約花 10 毫秒,而且不花錢,所以 agent 可以在每一次路由、分流、稽核或升級步驟之前做一次。Ollaya 給 agent 兩樣東西:

  • 一個 MCP 伺服器,ollaya mcp,它把本地模型暴露成工具。
  • 一個 agent skill,ollaya-decisions,它教 agent 什麼時候型別化決策勝過用文本推理、怎麼寫出好問題,以及怎麼依據機率行動。

MCP 伺服器

ollaya mcp 通過 stdio 說 Model Context Protocol。它像其他所有命令一樣與本地伺服器通訊,並在它沒執行時把它啟動起來。

Claude Code

claude mcp add ollaya -- ollaya mcp

Claude Desktop

把它加進 claude_desktop_config.json(Settings → Developer → Edit Config):

{
  "mcpServers": {
    "ollaya": { "command": "ollaya", "args": ["mcp"] }
  }
}

如果 Claude Desktop 找不到 ollaya,就用它的完整路徑,例如 /usr/local/bin/ollaya 或 ~/.local/bin/ollaya。

Cursor、VS Code 與其他客戶端

在客戶端的 MCP 設定裡用同一條命令 ollaya mcp:Cursor 用 .cursor/mcp.json,VS Code 用 .vscode/mcp.json(帶 "type": "stdio")。

走 HTTP

對於通過網路連線的客戶端,改為提供可流式傳輸的 HTTP:

ollaya mcp --http                  # http://127.0.0.1:11436/mcp
ollaya mcp --http 127.0.0.1:9000   # another address

預設情況下它只接受迴環地址。

工具

工具 作用
decide 就一個狀態回答型別化問題。參數:state(一個字串或任意 JSON)、questions 或 preset,以及 model(預設 laya)。結果與 POST /v1/systemone 返回的完全一樣。
list_models 本機上的模型,類似 ollaya list。
show_model 某個模型的詳情、能力、許可證和內建題目。
pull_model 下載一個模型,帶進度通知。decide 也會在首次使用時拉取。

資源

URI 內容
ollaya://models 已安裝的模型
ollaya://presets/<name> 一個內建預設的題目:triage、email、guard、moderation、router、agent

Agent skill

這個 skill 是一個 SKILL.md,支援 Agent Skills 的 agent(例如 Claude Code)在任務需要時會載入它。它涵蓋挑選模型、編寫 choice、score 和 noul 問題、預設、用於行動或升級的置信度閾值,以及通過 MCP、CLI 或 HTTP 呼叫 Ollaya。

把它裝進一個專案(或加 -g 裝到每個專案):

npx skills add ollaya-dev/ollaya --skill ollaya-decisions

它也隨每個發行版一起提供,位於二進位制檔案旁邊的 share/ollaya/skills/ollaya-decisions/(系統安裝則是 /usr/local/share/ollaya/skills/),所以你可以不聯網把它複製進 .claude/skills/。

這個 skill 也能單獨工作:只裝了該 skill 和 ollaya 的 agent 會呼叫 CLI。