Вектор Решений Agent OS
Живые демо

Быстрый старт

🔵 Цель — за пару минут запустить Agent OS и увидеть работающего агента: открыть виджет и поговорить с hello-agent — демо-агентом из стартового конфига.

2.1 Запустить

Нужен скомпилированный бинарник agent-os (единый CLI, подкоманда serve) и дерево config/. В дистрибутиве (скачать) есть и то и другое: бинарники лежат в bin/, стартовый конфиг — в config/.

Сервер запускается из корня распакованного архива — config/ и .env ищутся относительно текущей папки, а не рядом с бинарником:

agent-os-distrib/        ← запускать отсюда
├── bin/agent-os
├── config/
├── .env.example
└── .env                 ← создаёте вы

API-ключ кладётся в .env — секреты только туда, не в YAML:

cp .env.example .env        # Windows: copy .env.example .env

Откройте .env и впишите свой ключ в DEEPSEEK_API_KEY (работает и AGENT_OS_API_KEY). Остальные строки шаблона закомментированы — их трогать не нужно. Ключ опционален: без него сервер тоже стартует, а агенты отвечают симулированными ответами (в логе появится предупреждение).

Затем запуск:

./bin/agent-os serve        # Windows: bin\agent-os.exe serve

Сервер поднимается на 127.0.0.1:3000. Другой адрес — через переменную (в .env или в окружении):

AGENT_OS_BIND=0.0.0.0:8080 ./bin/agent-os serve

Проверить, что сервер жив и какие агенты загружены:

curl http://127.0.0.1:3000/health

В поле templates должны быть hello-agent и mcp-demo-agent.

2.2 Сразу увидеть агента

Открой в браузере:

http://127.0.0.1:3000/widget?model=hello-agent

Это страница виджета, сразу подключённая к агенту hello-agent — можно писать в чат. Попроси его посчитать слова или символы в тексте: он вызовет свой инструмент text_stats (скрипт на JavaScript из config/agents/hello/tools/).

В ?model= указывается имя шаблона — поле name: из agent.yaml (hello-agent), а не имя папки (hello).

Второй демо-агент, mcp-demo-agent, читает файлы через внешний MCP-сервер и требует установленного Node.js (npx в PATH); без Node он загрузится, но вызов инструмента вернёт ошибку.

Другие готовые страницы:

URL Что это
/widget?model=hello-agent виджет с конкретным агентом
/demo демо виджета
/demo/overlay виджет поверх живых сайтов (вкладки из config/demo.yaml)
/site/ markdown-сайт из config/web/
/sessions, /dashboard админ-панели (сессии, состояние системы)
/v1/templates список доступных шаблонов агентов

В стартовом конфиге нет ни config/web/, ни config/demo.yaml, поэтому /site/ отвечает 404, а у /demo/overlay нет вкладок — до тех пор, пока ты их не добавишь. Сайт описан в 13-web-content; вкладки оверлея задаются в config/demo.yaml (tabs: [{label, url, model}], hot-reload'ится на лету).

2.3 Провайдер — не только DeepSeek

Модель задаётся в config/server.yaml в блоке provider. По умолчанию это DeepSeek, но подходит любой OpenAI-совместимый API и локальные модели:

provider:
  base_url: "https://api.deepseek.com"
  model: "deepseek-chat"
  api_key: ""            # пусто → ключ берётся из .env

Примеры:

Адрес и модель провайдера задаются только здесь; ключ любого провайдера кладётся в .env как AGENT_OS_API_KEY (или DEEPSEEK_API_KEY). Переменные вроде OPENAI_API_KEY, OPENAI_BASE_URL и AGENT_OS_MODEL сервер не читает.

Несколько моделей сразу — через именованные конфиги models:; шаблон агента выбирает нужную полем model: в своём agent.yaml.

2.4 Поговорить через API

Для интеграции тот же разговор доступен через эндпоинт чата (SSE-стрим):

curl http://127.0.0.1:3000/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{"model":"hello-agent","messages":[{"role":"user","content":"Привет!"}]}'

Здесь model — имя шаблона агента. Полный формат запроса и событий — в 08-http-api.

2.5 Встроить виджет

На любой странице сайта:

<script src="http://127.0.0.1:3000/widget.js"></script>

2.6 Куда дальше