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

YAML 設定リファレンス

Sinaptic® DROID+ は、2種類の YAML 設定ファイルを使用します。

  1. メイン設定 (droid.yaml) — サーバー、LLM、セキュリティ、ロギングに関するグローバル設定
  2. エージェント設定 (configs/agents/*.yaml) — エージェントごとのモデル、パーソナリティ、ツール、動作の設定

すべての設定値は ${ENV_VAR} による置換をサポートしています。Sinaptic® DROID+ は起動時に環境変数を解決します。

メイン設定 (droid.yaml)​

edition (エディション)​

値説明
community無料版。最大エージェント数2、RegExp ベースのセキュリティのみ（デフォルト）
proエージェント数無制限、フル機能の SinapticAI セキュリティスタック
enterpriseマルチテナンシー、コンプライアンス対応、高可用性 (HA)

server (サーバー)​

フィールド型デフォルト説明
openai_portint8080OpenAI 互換 API 用のポート
management_portint8081管理 API 用のポート
cors_origins[]string["*"]許可される CORS オリジン
api_keystring—認証用の API キー（${ENV_VAR} をサポート）
demo_modeboolfalseデモモードを有効にする

llm​

主要な LLM プロバイダーの設定。

フィールド型デフォルト説明
providerstringopenaiLLM プロバイダー名 (openai, anthropic, gemini, grok, ollama, lm_studio, llama_cpp)
base_urlstringhttps://api.openai.com/v1API ベース URL
api_keystring${OPENAI_API_KEY}API キー（${ENV_VAR} をサポート）
default_modelstringgpt-4o-miniデフォルトのモデル名

anthropic​

フィールド型デフォルト説明
base_urlstringhttps://api.anthropic.comAnthropic API ベース URL
api_keystring${ANTHROPIC_API_KEY}API キー

gemini​

フィールド型デフォルト説明
base_urlstringhttps://generativelanguage.googleapis.com/v1betaGemini API ベース URL
api_keystring${GEMINI_API_KEY}API キー

grok​

フィールド型デフォルト説明
base_urlstringhttps://api.x.ai/v1Grok (xAI) API ベース URL
api_keystring${GROK_API_KEY}API キー

ollama​

フィールド型デフォルト説明
base_urlstringhttp://localhost:11434/v1Ollama API ベース URL

lm_studio​

フィールド型デフォルト説明
base_urlstringhttp://localhost:1234/v1LM Studio API ベース URL

llama_cpp​

フィールド型デフォルト説明
base_urlstringhttp://localhost:8080/v1llama.cpp サーバーベース URL

embedding (エンベディング)​

フィールド型デフォルト説明
modelstringtext-embedding-3-smallエンベディングモデル名
base_urlstring(llm.base_url を使用)エンベディング API ベース URL
api_keystring(llm.api_key を使用)エンベディング API キー

sinaptic​

SinapticAI セキュリティレイヤーの設定。

フィールド型デフォルト説明
enabledbooltrueSinapticAI セキュリティスキャンを有効にする
modestringblock脅威検知時のアクション: block (ブロック) または log (ログのみ)
log_blockedbooltrueブロックされたリクエストをログに記録する

sinaptic.pii​

フィールド型デフォルト説明
enabledbooltruePII (個人情報) 検知を有効にする
strategystringmaskPII 取り扱い戦略: mask (マスク) または block (ブロック)

mcp​

Model Context Protocol (MCP) ツールサーバーの設定。

mcp:
  servers:
    my-server:
      command: "npx"
      args: ["-y", "@my-org/mcp-server"]
      env:
        API_KEY: "${MY_API_KEY}"
フィールド型説明
serversmap名前付き MCP サーバーの定義

サーバーごとの設定:

フィールド型説明
commandstringMCP サーバーを起動するコマンド
args[]stringコマンド引数
envmap[string]stringサーバープロセス用の環境変数

logging (ロギング)​

フィールド型デフォルト説明
levelstringinfoログレベル (debug, info, warn, error)
formatstringjsonログ形式 (json または text)

audit (監査)​

フィールド型デフォルト説明
enabledboolfalse監査ログを有効にする
log_pathstring./logs/audit監査ログファイルの保存先パス
retention_daysint30監査ログの保持日数

branding (ブランディング)​

フィールド型デフォルト説明
show_badgebool(自動)"Powered by Sinaptic® DROID+" バッジを表示する。自動設定: community は true、pro/enterprise は false

トップレベルパス​

フィールド型デフォルト説明
data_dirstring./dataランタイムデータの保存ディレクトリ（エンベディング、状態など）
agents_dirstring./configs/agentsエージェントの YAML 設定ファイルを含むディレクトリ

エージェント設定 (configs/agents/*.yaml)​

トップレベルフィールド​

フィールド型必須デフォルト説明
namestringはい(ファイル名)エージェントの一意の識別子
descriptionstringいいえ—人間が読める説明
modelobjectはい—LLM モデルの設定
personalitystringはい—エージェント用のシステムプロンプト
agent_typestringいいえplain処理ループの種類: plain または react
execution_modestringいいえsequentialツールの実行方式: sequential または parallel
chain_of_thoughtboolいいえfalseChain-of-thought (思考の連鎖) 推論を有効にする
max_iterationsintいいえ10ReAct ループの最大反復回数
tool_timeoutstringいいえ30sツール呼び出しのデフォルトタイムアウト

model​

フィールド型デフォルト説明
namestring—モデル名 (例: gpt-4o, claude-sonnet-4-20250514)
base_urlstring(メイン設定から継承)LLM API ベース URL を上書きする
api_keystring(メイン設定から継承)API キーを上書きする
max_tokensint1024応答の最大トークン数
temperaturefloat0.7サンプリング温度 (0-2)

memory.short_term (短期メモリ)​

フィールド型デフォルト説明
max_messagesint50スライディングウィンドウ方式の会話履歴サイズ

rag​

フィールド型デフォルト説明
enabledboolfalseRAG (検索拡張生成) を有効にする
top_kint3取得するチャンク数
min_scorefloat0.7最小類似度スコアのしきい値

tools (ツール)​

ツール設定の配列。

フィールド型必須説明
namestringはいツールの識別子
descriptionstringいいえツールの説明 (LLM に提示されます)
typestringはいツールの種類: mcp, rest_api
urlstringrest_apiエンドポイントの URL
methodstringrest_apiHTTP メソッド (GET, POST, PUT, DELETE)
headersmaprest_apiHTTP ヘッダー
timeoutstringrest_apiリクエストタイムアウト (例: 10s)

pipeline (パイプライン)​

マルチ LLM パイプラインのステップ（オプション）。定義されている場合、リクエストは各ステップを順番に通過します。

フィールド型必須説明
namestringはいステップの識別子
modelobjectはいこのステップで使用するモデル設定
personalitystringはいこのステップ用のシステムプロンプト

spawns (スポーン)​

エージェント間 (A2A) 呼び出しの設定。

フィールド型デフォルト説明
max_spawnsint5リクエストあたりの最大サブエージェント呼び出し数 (0 = 無制限)
max_tokens_per_spawnint4096スポーンされた呼び出しあたりのトークン予算
max_depthint3最大再帰深度
allowed_agents[]string[] (すべて)スポーンを許可するエージェントのホワイトリスト
spawn_timeout_secsint60スポーンされた呼び出しあたりのタイムアウト（秒）

rate_limit (レート制限)​

フィールド型デフォルト説明
requests_per_minuteint0 (無制限)1分あたりの最大リクエスト数

sinaptic​

エージェントごとの SinapticAI 設定の上書き。

フィールド型デフォルト説明
enabledbool(グローバルから継承)グローバルの SinapticAI 有効化フラグを上書きする

完全な例​

droid.yaml​

edition: community

server:
  openai_port: 8080
  management_port: 8081
  cors_origins: ["*"]

llm:
  provider: openai
  base_url: https://api.openai.com/v1
  api_key: ${OPENAI_API_KEY}
  default_model: gpt-4o-mini

anthropic:
  api_key: ${ANTHROPIC_API_KEY}

embedding:
  model: text-embedding-3-small

sinaptic:
  enabled: true
  mode: block
  pii:
    enabled: true
    strategy: mask
  log_blocked: true

logging:
  level: info
  format: json

audit:
  enabled: false
  log_path: ./logs/audit
  retention_days: 30

data_dir: ./data
agents_dir: ./configs/agents

configs/agents/support-bot.yaml​

name: support-bot
description: RAG とツールを備えたカスタマーサポートエージェント

model:
  name: gpt-4o
  max_tokens: 2048
  temperature: 0.5

personality: |
  あなたは親切なカスタマーサポートエージェントです。
  常に丁寧、簡潔、かつ正確に対応してください。

agent_type: react
execution_mode: parallel
chain_of_thought: true
max_iterations: 5
tool_timeout: 15s

memory:
  short_term:
    max_messages: 100

rag:
  enabled: true
  top_k: 5
  min_score: 0.6

tools:
  - name: lookup-order
    type: rest_api
    description: 注文 ID で注文ステータスを確認します
    url: https://api.example.com/orders/${order_id}
    method: GET
    headers:
      Authorization: "Bearer ${INTERNAL_API_KEY}"
    timeout: 10s

rate_limit:
  requests_per_minute: 60

spawns:
  max_spawns: 3
  max_depth: 2
  allowed_agents: ["billing-agent", "shipping-agent"]