제공되는 기능
- 옵트인한 각 에이전트의 스킬을 나열하는 Agent Card
tasks/send,tasks/get,tasks/cancel을 제공하는 JSON-RPC 2.0 엔드포인트- 기본 제공, MCP, HTTP 도구와 나란히 도구 호출 루프에 통합되는 원격 A2A 에이전트
- 원격 에이전트의 일부만 공개하는 스킬 필터
EDDI에서의 동작 방식
a2aEnabled: true, 설명, 공개할 스킬을 지정해 에이전트를 옵트인합니다.- 피어는
/a2a/agents/{agentId}/agent.json에서 카드를 가져오고POST /a2a/agents/{agentId}를 호출합니다. - 원격 에이전트를 사용하려면 LLM 태스크의
a2aAgents에 URL과 볼트로 참조하는 API 키를 지정해 나열합니다. - EDDI는 원격 카드를 읽고 각 스킬을
{agentName}_{skillId}라는 이름의 도구로 만들어tasks/send로 호출합니다.
설정
EDDI 문서를 기준으로 합니다. your-agent-id 같은 플레이스홀더는 직접 바꿔서 사용하세요.
{
"a2aEnabled": true,
"description": "Customer support agent specializing in order tracking",
"a2aSkills": ["order-tracking", "refund-processing"]
}{
"systemMessage": "You are an orchestrator agent...",
"a2aAgents": [
{
"url": "https://remote-eddi.example.com/a2a/agents/support-agent",
"name": "support-agent",
"apiKey": "${vault:remote-agent-key}",
"timeoutMs": 30000,
"skillsFilter": ["order-tracking"]
}
]
}거버넌스
- Agent Card는 설계상 익명이므로, 피어가 자격 증명을 갖기 전에도 에이전트를 발견할 수 있습니다. 인증이 켜져 있으면 에이전트 목록 조회와 JSON-RPC 엔드포인트 모두 토큰이 필요합니다.
- 원격 에이전트의 도구도 다른 도구 소스와 같은 승인 게이트와 도구 결과 가드레일을 거치며, API 키는 볼트에 보관됩니다.
tasks/send는 사용자의 LLM 예산으로 대화를 실행하므로 익명으로 사용할 수 없습니다.
알아 두면 좋은 점
- 인증이 켜져 있으면 카드가 토큰 엔드포인트를 공개합니다.
eddi.a2a.public-token-endpoint를 설정하지 않으면 EDDI가 Keycloak 형식의 경로를 도출하므로, 다른 ID 공급자를 사용한다면 이 값을 설정하세요.
관련 통합
이 페이지의 설정과 동작은 2026-10-14에 확인한 EDDI 문서를 따릅니다. 필드 이름과 기본값은 릴리스마다 달라질 수 있으므로, 사용 중인 버전의 문서에서 확인하세요.