Skip to content
新着

EDDI v6 デベロッパープレビューが利用可能になりました! 始める

始める

EDDIを始める

EDDIをインストールし、最初のエージェントを作成して、5分で会話を開始。

EDDIを始める

前提条件

  • Docker(推奨)またはJava 25+
  • LLMプロバイダーAPIキー(OpenAI、Anthropic、Google Gemini、またはローカルOllamaインスタンス)

1. EDDIをインストールして起動する

EDDIを実行する最速の方法はワンコマンドインストーラーです。Docker Composeを使用してEDDI + お好みのデータベースをセットアップし、スターターエージェントをデプロイし、設定をガイドします:

Linux / macOS / WSL2:

curl -fsSL https://raw.githubusercontent.com/labsai/EDDI/main/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/labsai/EDDI/main/install.ps1 | iex

手動で制御したい場合は、リポジトリをクローンしてDocker Composeを直接使用してください:

docker compose up

EDDIはhttp://localhost:7070で利用可能になります。

2. MCPで接続

Claude DesktopまたはMCP互換クライアントを使用している場合、EDDIをMCPサーバーとして追加:

{
  "mcpServers": {
    "eddi": {
      "url": "http://localhost:7070/mcp"
    }
  }
}

AIアシスタントからEDDIの58のMCPツールと直接対話できるようになりました。

3. APIキーを安全に保存

エージェントを作成する前に、LLMプロバイダーのAPIキーをEDDIのSecrets Vault(AES-256-GCM暗号化)に安全に保存してください:

curl -X PUT http://localhost:7070/secretstore/secrets/default/my-anthropic-key \
  -H "Content-Type: application/json" \
  -d '{"value": "sk-ant-your-actual-key", "description": "Anthropic API key"}'

Manager UIをhttp://localhost:7070で開き、Secrets Vaultに移動して、キー名my-anthropic-keyで新しいシークレットを追加します。

💡 ヒント:${eddivault:my-anthropic-key}構文はEDDI内蔵のSecrets Vaultを参照します。Vaultマスターキーはインストーラーによって自動生成されます。簡単なテストの場合、APIキーを直接渡すこともできます:apiKey: "sk-ant-..."

4. 最初のエージェントを作成

setup_agentを使用して、MCPまたはREST API経由で1回の呼び出しで完全なエージェントを作成します:

setup_agent(
  agentName: "My first agent",
  systemPrompt: "You are a helpful assistant that answers questions clearly.",
  provider: "anthropic",
  model: "claude-sonnet-4-6",
  apiKey: "${eddivault:my-anthropic-key}"
)
curl -X POST http://localhost:7070/administration/agents/setup \
  -H "Content-Type: application/json" \
  -d '{
    "agentName": "My first agent",
    "systemPrompt": "You are a helpful assistant that answers questions clearly.",
    "provider": "anthropic",
    "model": "claude-sonnet-4-6",
    "apiKey": "${eddivault:my-anthropic-key}"
  }'

ルール、LLM設定、ワークフロー、エージェントを作成してデプロイします — すべて1ステップで。

5. エージェントとチャット

chat_with_agent(agentId: "<your-agent-id>", message: "Hello! What can you do?")
# Start a conversation and send a message
curl -X POST http://localhost:7070/agents/<your-agent-id>/start \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello! What can you do?"}'

6. Manager UIを開く

http://localhost:7070にアクセスして、EDDI Managerでエージェント、ワークフロー、会話を視覚的に管理します。

EDDIマネージャーUIダッシュボードプレビュー

インストーラーオプション

インストールスクリプトは自動化およびカスタマイズされたセットアップ用のフラグをサポートしています:

  • --defaults — すべてデフォルト、プロンプトなし
  • --db=postgres — MongoDBの代わりにPostgreSQLを使用
  • --with-auth — Keycloak認証を有効にする
  • --full — すべて有効(データベース + 認証 + モニタリング)
  • --local — ローカルソースからDockerイメージをビルド(コントリビューター向け)

EDDIの更新

インストーラーはeddi CLIラッパーを作成します。最新イメージをプルして再起動するには:

eddi update

CLIが利用できない場合は、インストールディレクトリ(~/.eddi)から実行してください:

cd ~/.eddi
docker compose --env-file .env -f docker-compose.yml pull
docker compose --env-file .env -f docker-compose.yml up -d

Kubernetes デプロイ

単一コマンドでKubernetesにデプロイ:

kubectl apply -f https://raw.githubusercontent.com/labsai/EDDI/main/k8s/quickstart.yaml

MongoDB、PostgreSQL、認証、モニタリング、プロダクション強化(HPA、PDB、NetworkPolicy)用のKustomizeオーバーレイとHelmチャートも利用できます。Kubernetesガイドをご覧ください。

Quarkus SDK

Quarkusアプリを構築中?quarkus-eddiエクステンションをご利用ください — Dev Services、Fluent API、SSEストリーミング、MCPブリッジ:

<dependency>
    <groupId>io.quarkiverse.eddi</groupId>
    <artifactId>quarkus-eddi</artifactId>
    <version>6.0.0</version>
</dependency>

次は?