제공되는 기능
- Open WebUI 모델 드롭다운에 표시되는 배포된 EDDI 에이전트
- 스트리밍과 토큰 사용량 보고를 지원하는 Chat Completions
- 채팅 하나당 EDDI 대화 하나를 사용하므로 메모리와 behavior rules가 턴을 넘어 유지됨
- 제목 생성 같은 단일 턴 호출을 위한 무상태 변형(
:stateless모델 ID)
EDDI에서의 동작 방식
EDDI_OPENAI_COMPAT_ENABLED=true로 어댑터를 활성화하고 API 키를 설정합니다. 기본적으로 비활성화되어 있습니다.- EDDI에서 에이전트를 배포합니다. 에이전트는
GET /v1/models에 나타납니다. - Open WebUI(또는 SDK)가 같은 API 키로
http://<eddi>:7070/v1을 가리키도록 설정합니다. - Open WebUI에서
ENABLE_FORWARD_USER_INFO_HEADERS를 켭니다. 켜지 않으면 모든 채팅 창이 하나의 EDDI 대화를 공유합니다. - 모델 목록에서 에이전트를 선택하고 대화합니다.
설정
EDDI 문서를 기준으로 합니다. your-agent-id 같은 플레이스홀더는 직접 바꿔서 사용하세요.
services:
eddi:
image: labsai/eddi:latest
ports: ["7070:7070"]
environment:
EDDI_OPENAI_COMPAT_ENABLED: "true"
EDDI_OPENAI_COMPAT_API_KEY: "sk-eddi-change-me"
open-webui:
image: ghcr.io/open-webui/open-webui:main
ports: ["3000:8080"]
environment:
OPENAI_API_BASE_URL: http://eddi:7070/v1
OPENAI_API_KEY: "sk-eddi-change-me"
ENABLE_OLLAMA_API: "false"
ENABLE_FORWARD_USER_INFO_HEADERS: "true"curl -H "Authorization: Bearer $EDDI_API_KEY" http://localhost:7070/v1/models
curl -X POST http://localhost:7070/v1/chat/completions \
-H "Authorization: Bearer $EDDI_API_KEY" \
-H "Content-Type: application/json" \
-H "X-OpenWebUI-Chat-Id: chat-1" \
-H "X-OpenWebUI-User-Id: alice" \
-d '{"model":"my-agent-a3f9c1","messages":[{"role":"user","content":"Hello"}]}'거버넌스
- 이 API는 자체 API 키 인증을 사용하며 활성화하기 전까지는 꺼져 있습니다. 포트에 접근할 수 있는 누구에게나 대화 생성이 열리게 되는 조합에서는 EDDI가 시작을 거부합니다.
- 에이전트는 자체 승인 게이트와 감사 추적을 그대로 유지합니다. /v1을 통한 요청도 일반적인 EDDI 대화입니다.
- 공유 API 키와 사용자 헤더를 함께 쓰면 신뢰할 수 있는 프록시인 Open WebUI에 신원 확인을 위임하게 됩니다. 키를 다른 공유 시크릿과 똑같이 취급하고 주기적으로 교체하세요.
알아 두면 좋은 점
- 개별 에이전트만 모델로 표시되며, 멀티 에이전트 그룹은 표시되지 않습니다.
- 빠른 답장과 버튼은 대화형 컨트롤이 아니라 Markdown 텍스트로 렌더링됩니다.
- 도구 호출은 클라이언트로 반환되지 않습니다. EDDI는 도구를 자체 파이프라인 안에서 실행하며, 도구 활동은 감사 원장에서 확인할 수 있습니다.
관련 통합
이 페이지의 설정과 동작은 2026-10-14에 확인한 EDDI 문서를 따릅니다. 필드 이름과 기본값은 릴리스마다 달라질 수 있으므로, 사용 중인 버전의 문서에서 확인하세요.