Устранение неполадок

Начните с журналов обеих сторон соединения: docker compose logs -f pentagi для PentAGI и журналов вашего бэкенда модели или прокси.

Flow завершается ошибкой «failed to select primary docker image via llm call»

Первое, что делает flow, — запрашивает у модели выбор образа Docker через agent type simple. Эта ошибка почти всегда указывает на проблему с бэкендом модели, а не с Docker:

1. Проверьте журналы PentAGI и журналы бэкенда вашей модели.
2. Убедитесь, что базовый URL, API-ключ и имя модели указаны верно и доступны из контейнера.
3. Этот вызов не отправляет инструменты, поэтому он завершается ошибкой из-за соединения, ключа или модели, а не из-за tool calling: проверьте, что модель agent simple отвечает на обычный запрос чата. Отсутствие парсера tool call проявится позже, когда агенты начнут вызывать инструменты.

Ошибки парсера tool call при использовании самостоятельно размещаемых моделей

PentAGI управляет agents посредством tool calls, поэтому пользовательский бэкенд должен возвращать корректный JSON tool call в стиле OpenAI. Признаки отсутствующего или неподходящего парсера: Failed to parse tool call arguments as JSON, flows, останавливающиеся после нескольких шагов, и tool calls, зацикливающиеся без достижения результата.

• Включите парсер tool call и шаблон чата, рекомендованные для модели, которую вы запускаете в llama.cpp, SGLang или vLLM.
• Перед запуском полноценного flow проверьте provider с помощью утилиты ctester.
• Обновите PentAGI: последние сборки очищают некорректные аргументы, благодаря чему один неудачный ответ больше не останавливает flow.

macOS блокирует установщик

Сборки для macOS подписаны и прошли нотариальное заверение. Если macOS всё ещё предупреждает об установщике, не используйте Всё равно открыть: удалите файл и снова скачайте архив для вашего процессора по официальным ссылкам — darwin/amd64 для Intel, darwin/arm64 для Apple silicon. Никогда не используйте архивы из неофициальных источников повторно.

Небольшие модели зависают

Включите мониторинг выполнения и планирование task и предоставьте agent adviser более мощную модель или повышенный уровень рассуждения.

Проблема не решена?

Задайте вопрос в Discord или откройте issue, приложив соответствующие строки журналов.