Документация

Агенты: MCP и skill

Решение занимает около 10 мс и ничего не стоит, поэтому агент может принять его перед каждым шагом маршрутизации, триажа, модерации или эскалации. Ollaya даёт агентам две вещи:

  • Сервер MCP, ollaya mcp, который предоставляет локальные модели как инструменты.
  • Agent skill, ollaya-decisions, который учит агента, когда типизированное решение лучше рассуждения в тексте, как писать хорошие вопросы и как действовать по вероятностям.

Сервер MCP

ollaya mcp говорит на Model Context Protocol через stdio. Он общается с локальным сервером как любая другая команда и запускает его, когда тот не работает.

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 и другие клиенты

Используйте ту же команду, ollaya mcp, в настройках MCP клиента: .cursor/mcp.json для Cursor, .vscode/mcp.json для VS Code (с "type": "stdio").

По HTTP

Для клиентов, подключающихся по сети, вместо этого отдавайте потоковый HTTP:

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

По умолчанию он принимает только loopback-хосты.

Инструменты

Инструмент Что делает
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, например Claude Code, загружают, когда задача этого требует. Он охватывает выбор модели, написание вопросов choice, score и noul, пресеты, пороги уверенности для действия или эскалации и вызов Ollaya через MCP, CLI или HTTP.

Установите его в проект (или добавьте -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, вызывает CLI.