🤖 AI-агенты для бизнеса

2. Быстрый старт

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

2.1 Запустить

Нужен скомпилированный бинарник agent_web_bot и дерево config/. API-ключ опционален: без него сервер тоже стартует, а агенты отвечают симулированными ответами (в логе появится предупреждение).

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

echo DEEPSEEK_API_KEY=sk-... > .env

Работает и AGENT_OS_API_KEY. Затем запуск:

./agent_web_bot

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

AGENT_OS_BIND=0.0.0.0:8080 ./agent_web_bot

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

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

http://127.0.0.1:3000/widget?model=felix

Это страница виджета, сразу подключённая к агенту felix — можно писать в чат. Феликс запоминает собеседника между сессиями (хук memory) и ищет по прошлым разговорам (инструмент search_history).

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

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

Вкладки /demo/overlay задаются в 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

Примеры:

Несколько моделей сразу — через именованные конфиги 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":"felix","messages":[{"role":"user","content":"Привет!"}]}'

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

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

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

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

2.6 Куда дальше