A2A 프로토콜 — AI와 AI의 대화 | Easy Understand Hermes Agent

서로 다른 회사의 동료 두 명이 프로젝트를 끝내려고 이메일을 주고받는 상황을 상상해 보세요. 단, 두 동료 모두 AI 에이전트이고, “이메일”은 A2A라는 표준 프로토콜이라고 말이죠.

A2A(Agent-to-Agent)는 독립적인 AI 에이전트들이 서로 대화할 수 있게 해주는 개방형 표준(v1.0, Linux 재단이 관리)입니다. AI를 위한 보편적인 언어라고 생각하면 됩니다. 여러분의 에이전트가 Hermes든, LangChain 봇이든, CrewAI 크루든, Google ADK 에이전트든, 모두 서로를 이해할 수 있습니다.

A2A는 언제 사용해야 할까요?

A2A가 필요할 수 있는 상황은 다음과 같습니다.

노트북의 Hermes가 서버에 있는 Hermes의 도움을 필요로 할 때 — 각자 자신만의 메모리, 도구, 자격 증명을 가지고 있는 경우.
전문 에이전트에게 작업을 위임하고 싶을 때 — 예를 들어 웹 검색이나 코딩에 특히 능숙한 에이전트에게요.
Hermes를 서비스로 공개하고 싶을 때 — 다른 프레임워크의 에이전트가 작업을 보낼 수 있도록요.

팁: 동일한 머신에서 여러 에이전트를 실행하는 경우 A2A는 건너뛰세요. 대신 프로세스 내 하위 에이전트나 칸반 보드를 사용하세요. A2A는 머신, 프로세스 또는 프레임워크를 넘나들 때 사용합니다.

A2A 활성화하기

시작은 간단합니다. 다음을 실행하세요.

hermes gateway setup

그런 다음 A2A를 선택하세요. 또는 ~/.hermes/config.yaml을 편집해도 됩니다.

gateway:
  platforms:
    a2a:
      enabled: true
      extra:
        port: 9900

아웃바운드 도구(다른 에이전트 호출)는 기본적으로 비활성화되어 있습니다. 다음 명령으로 활성화하세요.

hermes tools

다른 에이전트 호출하기 (아웃바운드)

활성화되면 Hermes는 다음과 같은 도구 세트를 갖게 됩니다.

a2a_discover(url) — 상대방의 “에이전트 카드”(AI를 위한 명함)를 가져와서 요약합니다.
a2a_call(agent, message, context_id?) — 작업을 보내고 답변을 받습니다.
a2a_list() — 구성된 피어와 저장된 대화를 확인합니다.
a2a_history(context_id) — 과거 A2A 대화를 불러옵니다.
a2a_orchestrate(capability, message, mode?) — 특정 기술을 가진 모든 피어에게 작업을 분산합니다.

config.yaml에서 알려진 피어를 구성할 수 있습니다.

a2a_agents:
  researcher:
    url: "http://research-box.local:9900"
    auth: { type: bearer, token: "..." }
    timeout: 120
    capabilities: [web_search, research]

그런 다음 Hermes에게 이렇게 요청하기만 하면 됩니다. “리서치 에이전트에게 오늘의 arXiv 게시물을 요약해 달라고 해줘.” 나머지는 Hermes가 처리합니다.

호출 가능하게 만들기 (인바운드)

플랫폼이 활성화되면 Hermes는 다음을 제공합니다.

에이전트 카드 — GET /.well-known/agent-card.json에서 제공되며 에이전트의 이름, 기술, 인증 요구 사항을 광고합니다.
JSON-RPC 2.0 — POST /에서 제공되며 SendMessage, GetTask, ListTasks 등의 표준 메서드를 지원합니다.
SSE 스트리밍 — 실시간 응답을 위한 기능입니다.
푸시 알림 (웹훅) — 장기 실행 작업용이며 HMAC-SHA256으로 서명됩니다.

인바운드 작업은 라이브 게이트웨이 세션에 주입되므로 에이전트는 평소처럼 작동합니다.

요약

A2A는 AI 에이전트를 위한 만국 공통어입니다. 깔끔하고 개방적인 표준을 사용하여 머신과 프레임워크를 넘나들며 Hermes가 다른 에이전트를 호출하고 호출받을 수 있게 해줍니다.

실용적인 팁: 작게 시작하세요. A2A를 활성화하고, 피어 하나(예: 리서치 에이전트)를 구성한 다음, 단일 a2a_call을 시도해 보세요. 작동하는 것을 확인하면 더 많은 피어와 기능으로 확장하세요. 곧 AI 팀을 구축하고 있을 것입니다.