사전 요구사항

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를 통해 한 번의 호출로 완전한 에이전트를 만드세요:

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 설정, 워크플로우, 에이전트를 생성하고 배포합니다 — 모두 한 단계로.

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로 에이전트, 워크플로우, 대화를 시각적으로 관리하세요.

설치 옵션

설치 스크립트는 자동화 및 맞춤 설정을 위한 플래그를 지원합니다:

--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>

다음은?

모든 기능EDDI가 제공하는 모든 것을 탐색 MCP 서버58개 MCP 도구 모두 보기 문서 ↗아키텍처와 API 심층 분석 왜 EDDI인가?EDDI의 엔터프라이즈 케이스

기능

솔루션

리소스

EDDI 시작하기