クイックスタート
わずか 5 分で最初の AI エージェントを起動しましょう。
前提条件
- サポートされている LLM プロバイダー（OpenAI, Anthropic, Google, xAI、またはローカルモデル）の API キー
- macOS, Linux, または Windows (WSL)
インストール
スクリプト (推奨):
curl -fsSL https://get.droid.plus | sh
Docker:
docker pull sinapticai/droid:latest
バイナリのダウンロード:
GitHub Releases から、お使いのプラットフォームに合ったバイナリをダウンロードしてください。
| プラットフォーム | アーキテクチャ | ダウンロード |
|---|---|---|
| Linux | amd64 | droid-linux-amd64 |
| Linux | arm64 | droid-linux-arm64 |
| macOS | Apple Silicon | droid-darwin-arm64 |
| macOS | Intel | droid-darwin-amd64 |
| Windows | amd64 | droid-windows-amd64.exe |
最初のエージェントを作成する
方法 A: AI ビルダー UI (コード不要)
Sinaptic® DROID+ を起動して、ビジュアルビルダーを開きます：
droid up
# ブラウザで http://localhost:8081/builder/ を開きます
AI ビルダー UI を使用すると、モデルの選択、システムプロンプトの作成、ツールの追加、ライブテストを視覚的に行うことができます。完了すると、YAML 設定ファイルが自動的に生成されます。
方法 B: YAML 設定
新しいプロジェクトを初期化します：
droid init my-agent
cd my-agent
これにより、以下の構造のプロジェクトディレクトリが作成されます：
my-agent/
├── droid.yaml # 実行設定（ポート、LLM キー、セキュリティ）
├── configs/agents/
│ └── my-agent.yaml # エージェントの定義
├── .env.example # API キーのテンプレート
└── data/ # 実行データ（RAG、ログ）
.env.example を .env にコピーし、API キーを追加します：
cp .env.example .env
# .env を編集し、OPENAI_API_KEY（または他のプロバイダーのキー）を追加してください
エンジンを起動します：
droid up
次のように表示されます：
____ ____ ___ ___ ____
| _ \| _ \ / _ \|_ _| _ \ _
| | | | |_) | | | || || | | |(_)_
| |_| | _ <| |_| || || |_| | _|
|____/|_| \_\\___/|___|____/ (_)
Sinaptic.AI DROID+ v0.5.0
Agent runtime engine starting...
✓ Loaded 1 agent: my-agent
✓ SinapticAI security: enabled (community mode)
✓ OpenAI-compatible API: http://localhost:8080/v1
✓ Management API: http://localhost:8081
✓ Agent Builder UI: http://localhost:8081/builder/
エージェントとの対話
Sinaptic® DROID+ は OpenAI 互換の API を公開しているため、あらゆる OpenAI SDK や curl を使用できます：
curl:
curl http://localhost:8080/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "my-agent",
"messages": [{"role": "user", "content": "こんにちは！"}]
}'
Python (OpenAI SDK):
from openai import OpenAI
client = OpenAI(base_url="http://localhost:8080/v1", api_key="any")
response = client.chat.completions.create(
model="my-agent",
messages=[{"role": "user", "content": "こんにちは！"}]
)
print(response.choices[0].message.content)
Node.js (OpenAI SDK):
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'http://localhost:8080/v1',
apiKey: 'any',
});
const response = await client.chat.completions.create({
model: 'my-agent',
messages: [{ role: 'user', content: 'こんにちは！' }],
});
console.log(response.choices[0].message.content);
model フィールドは、YAML 設定内のエージェント名に対応します。ローカル開発の場合、api_key は任意の文字列を指定できます（droid.yaml で認証を設定していない場合）。
エージェント設定の解説
以下は、最小限のエージェント設定（configs/agents/my-agent.yaml）の例です：
name: "my-agent"
description: "カスタマーサポートアシスタント"
model:
name: "gpt-4o-mini" # 設定したプロバイダーの任意のモデル
max_tokens: 1024
temperature: 0.7
personality: |
あなたは親切なカスタマーサポートアシスタントです。
簡潔かつ正確に答え、常に礼儀正しく接してください。
tools:
- name: "current_time"
type: "builtin"
sinaptic:
enabled: true # セキュリティチェックを有効化
主要なフィールド：
- name — API コールで
modelとして使用される、エージェントの一意の識別子。 - model.name — 使用する LLM モデル（例:
gpt-4o-mini,claude-sonnet-4-20250514,gemini-2.0-flash）。 - personality — エージェントの振る舞いを定義するシステムプロンプト。
- tools — エージェントが使用できる組み込みツール、REST API エンドポイント、または MCP サーバー。
- sinaptic.enabled — SinapticAI セキュリティ（プロンプトインジェクション検知、PII マスキング）の切り替え。
CLI コマンド
droid up # エンジンを起動（すべてのエージェントをロード）
droid down # 実行中のインスタンスを安全に停止
droid init NAME # 新しいエージェントプロジェクトを作成
droid agents # ロードされたエージェントとそのステータスを一覧表示
droid health # サーバーのヘルスチェック
droid version # バージョン、コミット、ビルド日を表示
次のステップ
- LLM プロバイダー — OpenAI, Anthropic, Gemini, Grok、またはローカルモデルの設定
- MCP ツール — Model Context Protocol を介した外部ツールの追加
- SinapticAI セキュリティ — 組み込みセキュリティレイヤーの理解
- Docker デプロイ — Docker を使用した本番環境での実行
- エディション — Community, Pro, Enterprise 版の機能比較