Agent Zero: как подключить свой API — настройка

Что такое Agent Zero

Agent Zero — настраиваемый автономный агент-фреймворк с иерархией субагентов: главный агент декомпозирует задачу и делегирует части подчинённым. Работает в Docker с веб-интерфейсом. Модель подключается своя — с ключом LLMost фреймворк работает на любой модели каталога.

Требования

Docker
Аккаунт LLMost с API-ключом

Установка

docker pull agent0ai/agent-zero
docker run -p 50001:80 agent0ai/agent-zero

Откройте http://localhost:50001. Актуальную команду запуска (порты, тома для данных) сверяйте с официальной инструкцией.

Подключение LLMost

Создайте ключ на странице Ключи API (формат llmost_...).
В веб-интерфейсе откройте Settings → секция Chat Model.
Выберите OpenAI-совместимого провайдера и заполните поля:
- API Base:
```
https://llmost.ru/api/v1
```
- Model: ~anthropic/claude-sonnet-latest (или другая модель LLMost)
- API Key: ваш ключ llmost_...
Сохраните настройки.

Обратите внимание: названия полей в Settings могут отличаться между версиями Agent Zero (проект развивается быстро). Ищите поля со смыслом «API base / model name / API key» у чат-модели.

Отдельно настраиваются Utility Model (служебные запросы — суммаризация, память) и Embedding Model. Для utility-модели подойдёт дешёвая модель LLMost (например ~google/gemini-flash-latest), embedding по умолчанию работает локально.

Выбор модели

Иерархия субагентов активно использует инструменты — модель должна поддерживать tool calling:

~anthropic/claude-sonnet-latest — лучший выбор для главного агента;
~openai/gpt-latest — универсальная флагманская альтернатива;
~google/gemini-flash-latest — для utility-модели и простых субагентов.

Полный список с ценами — в каталоге моделей LLMost.

Проверка

Отправьте агенту простую задачу в веб-интерфейсе — например, «Сколько будет 2+2?». Ответ пришёл — подключение работает.

Чтобы проверить endpoint в обход Agent Zero:

curl https://llmost.ru/api/v1/chat/completions \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~google/gemini-flash-latest",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Частые проблемы

Агент не отвечает после смены настроек. Проверьте, что API Base — ровно https://llmost.ru/api/v1, и перезапустите чат.

Ошибка 401. Ключ скопирован не полностью или удалён. Создайте новый на странице Ключи API.

Ошибка 402 «Недостаточно средств». Иерархия субагентов расходует много токенов — проверьте баланс и пополните его.

Субагенты работают медленно или дорого. Назначьте utility-модели дешёвую модель — основная часть служебных запросов пойдёт через неё.

Ссылки

Официальный сайт: agent-zero.ai
GitHub: agent0ai/agent-zero
Другие приложения — в каталоге ИИ-агентов

Agent Zero + LLMost: установка и настройка