Vibeos Api Automation

Вызов API-сервера VibeOS из скриптов через vibeos api.

Метаданные навыка

Источник	Встроенный (установлен по умолчанию)
Путь	skills/devops/vibeos-api-automation
Версия	1.0.0
Автор	VibeOS
Лицензия	MIT
Платформы	linux, macos, windows
Теги	api, sdk, automation, ci, runs, openai
Связанные навыки	cursor-capabilities-bridge, vibeos-local-verify-deploy

Справочник: полный SKILL.md

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

VibeOS API Automation

Используйте существующий API-сервер, совместимый с OpenAI, через тонкий CLI vibeos api — вызовы в стиле Cursor-SDK без добавления новых инструментов ядра.

Когда использовать

• Скриптам / CI требуется запустить агента и опрашивать/стримить результаты
• Пользователь запрашивает «программный агент», «SDK», «HTTP API», «автоматизация vibeos»
• Подключение Open WebUI / curl / кастомных ботов к работающему шлюзу

Предварительные требования

В ~/.vibeos/.env (или в .env профиля кодинга):

API_SERVER_ENABLED=true
API_SERVER_KEY=change-me-local-dev
# опционально: API_SERVER_PORT=8642

Шлюз должен быть запущен: vibeos gateway (API слушает порт :8642 по умолчанию).

Как запустить

vibeos api health
vibeos api chat "Summarize AGENTS.md in 3 bullets"
vibeos api run "Run targeted tests for vibeos_cli/api_cmd.py" --wait
RUN=$(vibeos api run "…" | jq -r .run_id)
vibeos api stream "$RUN"
vibeos api stop "$RUN"
SID=$(vibeos api session-create --title demo | jq -r .id // .session_id)
vibeos api prompt --session "$SID" "continue the previous task"

Переопределения: --base-url, --api-key или переменные окружения VIBEOS_API_BASE / API_SERVER_KEY.

Краткая справка

Цель	Команда
Проверка здоровья	vibeos api health[--detailed]
Синхронный чат	vibeos api chat "…"
Асинхронный запуск	vibeos api run "…" [--wait|--follow]
Опрос запуска	vibeos api get <run_id>
SSE	vibeos api stream <run_id>
Остановка	vibeos api stop <run_id>
Сессии	vibeos api sessions / session-create
Продолжение	vibeos api prompt --session <id> "…"

Порядок действий

1. Убедитесь, что API-сервер включён и шлюз работает (vibeos api health).
2. Для длительной работы агента используйте run + stream/get; для коротких вопросов-ответов — chat.
3. Для многошаговых ботов создайте сессию и передавайте --session / prompt.
4. Никогда не коммитьте API_SERVER_KEY; храните его только в .env.
5. Не добавляйте новые инструменты ядра для HTTP-вызовов — этот CLI является безопасным с точки зрения занимаемого места.

Подводные камни

• API-сервер отказывается запускаться без API_SERVER_KEY
• Фоновые delegate_task / уведомления терминала могут не доставляться обратно через HTTP (supports_async_delivery=False на api_server) — используйте runs/SSE
• Отправка в GitHub остаётся заблокированной vibeos-policy, даже при вызове через API

Проверка

• vibeos api health возвращает HTTP 200 JSON
• vibeos api chat "ping" возвращает текст ассистента
• vibeos api run "ping" --wait достигает статуса completed (или явно завершается ошибкой с JSON-ответом)