제공되는 기능
- 명세에서 생성되는 API 호출 에이전트: 태그별로 묶인 HTTP 호출 설정, 파이프라인, 배포
- 엔드포인트 필터링, 기본 URL 재정의, 인증 헤더 전달
- 생성된 도구와 함께 MCP 서버의 도구를 추가하는 옵션
- 설정이므로 검토, 비교, 버전 관리가 가능한 도구
EDDI에서의 동작 방식
create_api_agentMCP 도구 또는POST /administration/agents/setup-api로 EDDI에 OpenAPI 명세를 전달합니다.- 에이전트가 사용할 오퍼레이션을 허용 목록에 등록합니다. 선언되지 않은 엔드포인트는 호출할 수 없습니다.
- EDDI가 HTTP 호출 설정을 생성하고, 전체 파이프라인을 구성한 뒤 에이전트를 배포합니다.
- 자격 증명은
${vault:...}참조로 유지합니다. - 쓰기는
http.post:*,http.put:*,http.patch:*,http.delete:*로 게이트를 적용하고, 읽기는http.get:*로 제외합니다.
설정
EDDI 문서를 기준으로 합니다. your-agent-id 같은 플레이스홀더는 직접 바꿔서 사용하세요.
{
"targetServerUrl": "https://api.example.com/v1",
"httpCalls": [
{
"name": "list-open-orders",
"saveResponse": true,
"responseObjectName": "order",
"request": {
"method": "GET",
"path": "/orders",
"queryParams": { "status": "open" },
"headers": { "Authorization": "Bearer ${vault:orders-api-token}" }
}
}
]
}{
"hitlConfig": {
"toolApprovals": {
"requireApproval": [
"http.post:*",
"http.put:*",
"http.patch:*",
"http.delete:*"
],
"exempt": [
"http.get:*"
],
"approvalTimeout": "PT30M",
"timeoutPolicy": "AUTO_REJECT"
}
}
}거버넌스
- 승인 패턴은 도구가 호출하는 대상(
http.post:*)을 지정할 수 있어, operationId가 바뀌어도 정확하게 유지됩니다. - 아웃바운드 호출은 플랫폼이 SSRF와 경로 순회로부터 보호합니다.
- REST에서는
setup-api가hitlConfig를 받으므로, 첫 버전부터 쓰기 도구에 게이트가 적용된 에이전트를 프로비저닝할 수 있습니다. MCP 도구에서는 이 값을 설정할 수 없습니다. - 결정은 감사 원장에 기록됩니다.
알아 두면 좋은 점
- 생성된 쓰기 도구는 요청 본문 전체를 하나의
requestBody매개변수로 받습니다.
구축과 운영을 맡기고 싶으신가요?
EDDI Solutions는 커넥터를 구축하고 유지 관리하며, EDDI를 관리형 또는 공동 운영 인스턴스로 운영하고, 고객사의 클라우드나 온프레미스 환경도 지원합니다.
EDDI Solutions에 문의하기 ↗관련 통합
이 페이지의 설정과 동작은 2026-10-14에 확인한 EDDI 문서를 따릅니다. 필드 이름과 기본값은 릴리스마다 달라질 수 있으므로, 사용 중인 버전의 문서에서 확인하세요.