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

FAQ

全般​

Sinaptic® DROID+ とは何ですか？​

Sinaptic® DROID+ は、ヘッドレス AI エージェントのランタイムエンジンです。nginx がウェブサイトを配信するように、Sinaptic® DROID+ は AI エージェントを配信します。YAML 設定でエージェントを定義すると、Sinaptic® DROID+ がそれらを OpenAI 互換の API として公開します。単一のバイナリ、任意の LLM プロバイダー、組み込みのセキュリティが特徴です。

Sinaptic® DROID+ はオープンソースですか？​

Sinaptic® DROID+ Community Edition は、Business Source License 1.1 (BSL 1.1) の下でソースが公開されています。最大2つのエージェントを使用した内部目的であれば無料で利用できます。ライセンスは変更日以降に Apache 2.0 に転換されます。Pro および Enterprise エディションは商用ライセンスです。

Community、Pro、Enterprise の違いは何ですか？​

機能マトリクスの全容については エディションの比較 をご覧ください。簡単に言うと、Community は最大2つのエージェントと RegExp ベースのセキュリティを備えた無料版です。Pro はエージェントの制限を解除し、SinapticAI のフルセキュリティカスケードを追加します。Enterprise はマルチテナンシー、コンプライアンス機能、および SLA サポートを追加します。

Community Edition の料金を支払う必要がありますか？​

いいえ。Community Edition は、最大2つのエージェントを使用した内部利用であれば永久に無料です。登録不要、テレメトリなし、API 呼び出しの使用制限もありません。

インストールとセットアップ​

システム要件は何ですか？​

Sinaptic® DROID+ は、外部依存関係のない単一の Go バイナリです。Linux (amd64/arm64)、macOS (Intel/Apple Silicon)、および Windows で動作します。メモリ使用量はワークロードに依存しますが、基本的なセットアップであれば 128MB で十分です。

Docker なしで Sinaptic® DROID+ を実行できますか？​

はい。Sinaptic® DROID+ はスタンドアロンのバイナリです。GitHub Releases からダウンロードし、実行権限を与えて droid up を実行してください。Docker はオプションです。

Sinaptic® DROID+ をどのようにアップデートしますか？​

バイナリインストールの場合は、新しいバージョンをダウンロードしてバイナリを置き換えてください。Docker の場合は、docker pull sinapticai/droid:latest && docker compose up -d を実行してください。設定ファイルとデータはバイナリから分離されているため、アップデートによってデータが失われることはありません。

LLM プロバイダー​

どの LLM プロバイダーがサポートされていますか？​

すべてのエディションで、OpenAI、Anthropic (Claude)、Google Gemini、xAI Grok、Ollama、LM Studio、および llama.cpp の 7 つすべてのプロバイダーを利用できます。クラウドプロバイダーには API キーが必要です。ローカルプロバイダー (Ollama, LM Studio, llama.cpp) にはキーは不要です。

エージェントごとに異なるモデルを使用できますか？​

はい。各エージェントは独自の model.provider と model.name を指定します。同じ Sinaptic® DROID+ インスタンスから、あるエージェントを GPT-4o で、別のエージェントを Claude Sonnet で、3 つ目のエージェントをローカルの Ollama モデルで実行することができます。

独自のファインチューニング済みモデルで Sinaptic® DROID+ を使用できますか？​

はい。ファインチューニング済みモデルが OpenAI 互換の API (ほとんどのプロバイダーがサポートしています) を介して提供されている場合、Sinaptic® DROID+ で使用できます。正しい base_url とモデル名を設定するだけです。

Sinaptic® DROID+ は私のデータをどこかに送信しますか？​

Sinaptic® DROID+ は、設定した LLM プロバイダーにのみプロンプトを送信します。Sinaptic® DROID+ 自体によるテレメトリ、分析、およびデータ収集はありません。ローカルモデル (Ollama, LM Studio, llama.cpp) を使用する場合、すべてはユーザーのマシン内に留まります。

セキュリティ​

SinapticAI とは何ですか？​

SinapticAI は、Sinaptic® DROID+ に組み込まれた AI 意図ファイアウォールです。プロンプトとレスポンスをリアルタイムで検査し、プロンプトインジェクション攻撃、ジェイルブレイクの試み、および PII (個人情報) の漏洩を検出してブロックします。詳細は SinapticAI の概要 をご覧ください。

Community Edition はどのような攻撃を検出しますか？​

Community Edition には RegExp セキュリティレイヤーが含まれており、既知の攻撃ベクトルの約 70% を捕捉します。これには、一般的なプロンプトインジェクションパターン、既知のジェイルブレイクテンプレート、システムプロンプトの抽出の試み、および PII パターン (メール、電話番号、クレジットカード) が含まれます。

特定のエージェントに対して SinapticAI を無効にできますか？​

はい。エージェントの YAML 設定で sinaptic.enabled: false を設定してください。droid.yaml のグローバル設定がデフォルトを制御します。

セキュリティチェックのためにデータはローカルで処理されますか？​

はい。すべての SinapticAI チェックは Sinaptic® DROID+ インスタンス内でローカルに実行されます。セキュリティ分析のためにデータが外部サービスに送信されることはありません。

API と統合​

API は本当に OpenAI 互換ですか？​

はい。Sinaptic® DROID+ は、OpenAI の API と同じリクエスト/レスポンス形式で /v1/chat/completions エンドポイントを実装しています。任意の言語で公式の OpenAI SDK を使用でき、base_url を Sinaptic® DROID+ インスタンスに変更するだけです。

API リクエストをどのように認証しますか？​

デフォルトでは認証は不要です (ローカル開発モード)。本番環境では、droid.yaml で API キーを構成してください。

server:
  api_key: "your-secret-key"

その後、OpenAI と同様に Authorization: Bearer your-secret-key ヘッダーを介してリクエストで渡します。

Sinaptic® DROID+ を OpenAI のドロップイン代替として使用できますか？​

はい。base_url を Sinaptic® DROID+ インスタンスに設定し、エージェント名を model パラメータとして使用してください。レスポンス形式は OpenAI と同一です。

エージェント​

Community Edition のエージェント制限は何ですか？​

Community Edition は最大2つのエージェントをサポートします。それ以上必要な場合は Pro (無制限のエージェント) にアップグレードしてください。制限は、合計設定数ではなく、同時にロードされるエージェント数に対して適用されます。

再起動なしでエージェントをホットリロードできますか？​

はい。Sinaptic® DROID+ はエージェントディレクトリの変更を監視しています。エージェントの YAML 設定を変更すると、サーバーを再起動したりアクティブな接続を切断したりすることなく、自動的にリロードされます。

エージェントはどのようなツールを使用できますか？​

エージェントは、組み込みツール (current_time など)、REST API ツール (任意の HTTP エンドポイントの呼び出し)、および MCP ツール (ウェブ検索、ファイルアクセス、データベースなどの拡張可能な統合のための Model Context Protocol) を使用できます。MCP ガイド を参照してください。

デプロイ​

Sinaptic® DROID+ はどのポートを使用しますか？​

OpenAI 互換 API にはポート 8080 を、管理 API およびエージェントビルダー UI にはポート 8081 を使用します。どちらも droid.yaml で構成可能です。

管理 API をパブリックに公開すべきですか？​

いいえ。ポート 8081 は管理者機能とエージェントビルダー UI を提供します。本番環境では内部ネットワーク内、または認証の背後に置いてください。

複数の Sinaptic® DROID+ インスタンスを実行できますか？​

はい。各インスタンスは (設定ファイルとデータディレクトリを除いて) ステートレスです。ロードバランサーの背後で複数のインスタンスを実行できます。調整されたマルチインスタンスデプロイメントのために、Enterprise エディションはクラスタリングと HA (高可用性) 機能を提供します。

トラブルシューティング​

Sinaptic® DROID+ は起動しますがエージェントがロードされません​

エージェントの YAML ファイルが droid.yaml の agents_dir で指定されたディレクトリ (デフォルト: ./configs/agents/) にあることを確認してください。droid agents を実行してロードされたエージェントを確認してください。

API 呼び出し時に "Connection refused" となります​

Sinaptic® DROID+ が実行されていることを確認し (droid health)、正しいポート (デフォルト 8080) を使用しているか確認してください。Docker で実行している場合は、ポートが正しくマッピングされていることを確認してください。

LLM 呼び出しが認証エラーで失敗します​

API キーが正しく設定されていることを確認してください。echo $OPENAI_API_KEY (または関連する変数) で確認してください。設定は ${VAR} 構文をサポートしているため、環境変数が Sinaptic® DROID+ プロセスから利用可能であることを確認してください。