メインコンテンツまでスキップ

CLIリファレンス

DROID+は、AIエージェントのランタイムを管理するためのサブコマンドセットを含む単一のバイナリとして提供されます。

droid​

DROID+ — ヘッドレスAIエージェントランタイムエンジン。 nginxがWebサイトを配信するように、DROID+はAIエージェントを配信します。 1つのバイナリ、1つの設定で、数分でプロダクション対応のエージェントを構築できます。

使用法:

droid [command]

利用可能なコマンド:

コマンド説明
init新しいDROID+プロジェクトの初期化
upDROID+ランタイムの開始
down実行中のDROID+インスタンスの停止
agents実行中のエージェントの一覧表示
agents reloadエージェント設定のホットリロード
healthDROID+サーバーのヘルスチェック
versionバージョン情報の表示

グローバルフラグ:

フラグ説明
-h, --helpdroidのヘルプを表示

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​

OpenAI互換APIおよび管理APIを使用して、DROID+ AIエージェントランタイムを開始します。

使用法:

droid up [flags]

フラグ:

フラグ型デフォルト説明
--config, -cstring自動検出設定ファイルへのパス
--daemon, -dboolfalseバックグラウンドで実行（本番環境ではsystemd/dockerを使用してください）

例:

# 自動検出された設定で開始
droid up

# 特定の設定ファイルで開始
droid up --config /etc/droid/droid.yaml

# バックグラウンドで開始
droid up -d

droid down​

PIDファイルを使用して、実行中のDROID+プロセスにSIGTERMを送信します。

使用法:

droid down

例:

droid down

droid agents​

管理APIに問い合わせて、ロードされているすべてのエージェントとそのステータスを一覧表示します。

使用法:

droid agents [flags]

フラグ:

フラグ型デフォルト説明
--portint8081管理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​

OpenAI互換APIおよび管理APIのヘルスチェックエンドポイントを確認します。

使用法:

droid health [flags]

フラグ:

フラグ型デフォルト説明
--openai-portint8080OpenAI APIのポート
--management-portint8081管理APIのポート

例:

# デフォルトポートでヘルスチェックを実行
droid health

# カスタムポートでヘルスチェックを実行
droid health --openai-port 9080 --management-port 9081

droid version​

DROID+のバージョン情報を表示します。

使用法:

droid version [flags]

フラグ:

フラグ説明
--jsonJSON形式で出力

例:

droid version
# DROID+ v0.5.0 (community) built ...

droid version --json
# {"version":"0.5.0","edition":"community","commit":"...","build_time":"..."}