前置条件

Docker（推荐）或Java 25+
LLM提供商API密钥（OpenAI、Anthropic、Google Gemini或本地Ollama实例）

1. 安装并启动 EDDI

运行 EDDI 最快的方式是一键安装脚本。它会通过 Docker Compose 设置 EDDI + 您选择的数据库，部署一个入门 Agent，并引导您完成配置：

Linux / macOS / WSL2:

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

Windows (PowerShell):

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/labsai/EDDI/main/install.ps1" -OutFile "install.ps1"
Unblock-File .\install.ps1
.\install.ps1

如果您更喜欢手动控制，请克隆仓库并直接使用 Docker Compose：

docker compose up

EDDI将在http://localhost:7070上可用。

2. 通过MCP连接

将您的AI助手连接到EDDI的65个MCP工具。配置取决于您客户端的传输支持：

原生支持 Streamable HTTP 的客户端（Cursor、VS Code、Windsurf、Antigravity 及其他 IDE 插件）可直接连接，无需桥接：

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

Claude Desktop 仅支持 stdio 传输。使用 mcp-remote 桥接 stdio↔HTTP。需要 Node.js 18+。

{
  "mcpServers": {
    "eddi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:7070/mcp"]
    }
  }
}

💡 Windows：如果 npx 不在 PATH 中，请使用 "command": "cmd", "args": ["/c", "npx", "-y", "mcp-remote", "http://localhost:7070/mcp"]。

现在您可以直接在AI助手中使用EDDI的65个MCP工具。

📖 查看 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界面 http://localhost:7070，导航到Secrets Vault并添加一个密钥名为my-anthropic-key的新密钥。

💡 提示：${vault:my-anthropic-key}语法引用EDDI内置的Secrets Vault。保险库主密钥由安装程序自动生成。如需快速测试，您也可以直接传递API密钥：apiKey: "sk-ant-..."。

4. 创建您的第一个代理

使用setup_agent一次调用创建一个完整的代理，通过MCP或REST API：

setup_agent(
  agentName: "My first agent",
  systemPrompt: "You are a helpful assistant that answers questions clearly.",
  provider: "anthropic",
  model: "claude-sonnet-4-6",
  apiKey: "${vault: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": "${vault:my-anthropic-key}"
  }'

这一步会创建规则、LLM配置、工作流和代理，并完成部署，全部一步完成。

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. 打开管理界面

导航至http://localhost:7070，使用EDDI Manager可视化管理您的代理、工作流和对话。

安装选项

安装脚本支持用于自动化和自定义设置的标志：

--defaults，所有默认值，无提示
--db=postgres，使用 PostgreSQL 代替 MongoDB
--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

还提供 Kustomize overlay 和 Helm chart，支持 MongoDB、PostgreSQL、认证、监控和生产加固（HPA、PDB、NetworkPolicy）。请参阅 Kubernetes 指南。

接下来做什么？

全部功能探索EDDI提供的一切 MCP服务器浏览全部65个MCP工具 文档 ↗深入了解架构和API 为什么选择EDDI？EDDI的企业价值

功能特性

企业版

资源

开始使用EDDI