Довідка CLI
DROID+ поставляється як єдиний бінарний файл із набором підкоманд для керування середовищами виконання ШІ-агентів.
droid
DROID+ — безголовий (headless) двигун середовища виконання ШІ-агентів. Подібно до того, як nginx обслуговує веб-сайти, DROID+ обслуговує ШІ-агентів. Один бінарний файл, одна конфігурація, агенти, готові до продакшну, за лічені хвилини.
Використання:
droid [command]
Доступні команди:
| Команда | Опис |
|---|---|
init | Ініціалізувати новий проект DROID+ |
up | Запустити середовище виконання DROID+ |
down | Зупинити запущений екземпляр DROID+ |
agents | Список запущених агентів |
agents reload | Гаряче перезавантаження конфігурацій агентів |
health | Перевірити стан сервера DROID+ |
version | Вивести інформацію про версію |
Глобальні прапорці:
| Прапорець | Опис |
|---|---|
-h, --help | Довідка для droid |
droid init
Створити нову директорію з мінімальною конфігурацією DROID+, прикладом агента та шаблоном .env.
Використання:
droid init [project-name]
Аргументи:
project-name— Назва директорії для створення (за замовчуванням:my-agent)
Приклад:
droid init skincare-bot
cd skincare-bot
Створені файли:
droid.yaml— Основна конфігураціяconfigs/agents/example.yaml— Конфігурація прикладу агента.env.example— Шаблон змінних оточення
droid up
Запустити середовище виконання ШІ-агентів DROID+ з OpenAI-сумісним API та Management API.
Використання:
droid up [flags]
Прапорці:
| Прапорець | Тип | За замовчуванням | Опис |
|---|---|---|---|
--config, -c | string | автовизначення | Шлях до файлу конфігурації |
--daemon, -d | bool | false | Запустити у фоновому режимі (використовуйте systemd/docker для продакшну) |
Приклади:
# Запуск з автовизначенням конфігурації
droid up
# Запуск із конкретним файлом конфігурації
droid up --config /etc/droid/droid.yaml
# Запуск у фоновому режимі
droid up -d
droid down
Надіслати SIGTERM запущеному процесу DROID+, використовуючи PID-файл.
Використання:
droid down
Приклад:
droid down
droid agents
Запитати Management API для отримання списку всіх завантажених агентів та їхнього статусу.
Використання:
droid agents [flags]
Прапорці:
| Прапорець | Тип | За замовчуванням | Опис |
|---|---|---|---|
--port | int | 8081 | Порт Management API |
Приклад:
# Список агентів на порту за замовчуванням
droid agents
# Список агентів на кастомному порту керування
droid agents --port 9091
droid agents reload
Гаряче перезавантаження конфігурацій агентів без перезапуску середовища виконання. Читає директорію агентів і застосовує будь-які зміни.
Використання:
droid agents reload
Приклад:
# Додати новий YAML агента, потім перезавантажити
cp new-agent.yaml configs/agents/
droid agents reload
droid health
Перевірити кінцеві точки стану (health endpoints) OpenAI-сумісного API та Management API.
Використання:
droid health [flags]
Прапорці:
| Прапорець | Тип | За замовчуванням | Опис |
|---|---|---|---|
--openai-port | int | 8080 | Порт OpenAI API |
--management-port | int | 8081 | Порт Management API |
Приклад:
# Перевірка стану на портах за замовчуванням
droid health
# Перевірка стану на кастомних портах
droid health --openai-port 9080 --management-port 9081
droid version
Вивести інформацію про версію DROID+.
Використання:
droid version [flags]
Прапорці:
| Прапорець | Опис |
|---|---|
--json | Вивід у форматі JSON |
Приклад:
droid version
# DROID+ v0.5.0 (community) built ...
droid version --json
# {"version":"0.5.0","edition":"community","commit":"...","build_time":"..."}