에이전트 워크포스: 자율적인 에이전트 간 협업 활성화
Source: Dev.to
소개
지금까지 대부분의 AI 상호작용은 인간‑대‑AI 패턴을 따랐습니다: 프롬프트를 입력하면 AI가 도구를 호출합니다. 에이전시 시대의 다음 단계로 나아가면서 새로운 패턴이 등장하고 있습니다: Agent‑to‑Agent (A2A) 협업.
예를 들어 “CEO 에이전트”가 법적 보고서를 제출해야 한다고 가정해 보세요. 모든 작업을 스스로 수행하는 대신, 법률 전문가 에이전트를 찾아내고, 그 에이전트의 역량을 인식한 뒤 작업을 위임합니다.
문제는 에이전트들이 같은 언어를 사용하도록 보장하고, 한 에이전트가 다른 에이전트의 능력과 안전 경계를 “인식”할 수 있게 하는 것입니다.
이 시리즈의 다섯 번째 글에서는 apcore‑a2a 어댑터를 통해 자율적인 에이전시 워크포스에 사회 계약을 제공하는 apcore가 어떻게 작동하는지 살펴봅니다.
도구에서 스킬로
전통적인 세계에서는 코드를 도구(함수)로 생각합니다. Agent‑to‑Agent 세계에서는 코드를 스킬로 생각합니다.
apcore‑a2a는 apcore 모듈 메타데이터에서 표준을 준수하는 Agent Card(/.well-known/agent.json)를 자동으로 생성합니다. 이 카드는 네트워크상의 다른 에이전트에게 다음을 알려줍니다:
- 정체성 – 예: “나는
legal.document_analyzer에이전트입니다.” - 인식 – “PDF와 Word 문서를 처리합니다. 내 설명은 X이고, 문서는 Y입니다.”
- 거버넌스 – “읽기 전용이며 발견에 대한 승인은 필요 없지만, 파괴적인 편집에는 승인이 필요합니다.”
작업 수명주기 관리
에이전시 작업은 종종 장시간 실행됩니다. apcore‑a2a는 전체 수명주기를 관리합니다:
| 상태 | 설명 |
|---|---|
| Submitted | 작업이 수신되고 input_schema에 따라 검증됩니다. |
| Working | 작업이 백그라운드에서 실행 중입니다. |
| Completed / Failed | 최종 결과 또는 오류가 캡처됩니다. |
| Input‑Required | 호출자로부터 추가 정보가 필요하면 작업이 일시 중지됩니다. |
apcore‑a2a 클라이언트를 사용하면:
- 메시지를 제출하고 실시간으로 상태를 추적할 수 있습니다.
- SSE 스트리밍(
message/stream)을 이용해 진행 중인 상태와 아티팩트 업데이트를 실시간으로 받을 수 있습니다.
Agent‑to‑Agent 네트워크 보안
보안은 필수입니다: “환각”하는 에이전트가 허가 없이 bank.transfer 모듈을 호출해서는 안 됩니다.
apcore‑a2a는 들어오는 A2A 토큰을 apcore의 정체성 컨텍스트로 직접 연결하는 정교한 JWTAuthenticator를 제공합니다. ClaimMapping을 설정하면 JWT 클레임(예: sub, roles, org)을 apcore의 역할 기반 ACL에 매핑할 수 있습니다.
auth = JWTAuthenticator(
key="your-secret-key",
claim_mapping=ClaimMapping(id_claim="sub", roles_claim="roles"),
)
serve(registry, auth=auth)
이제 모든 교차 에이전트 호출은 인증되며, 내부 모듈을 보호하는 패턴 기반 보안과 동일한 방식으로 관리됩니다.
A2A Explorer UI
apcore‑a2a를 explorer=True 플래그와 함께 실행하면 A2A Explorer라는 브라우저 기반 UI가 시작됩니다. 이를 통해 다음을 할 수 있습니다:
- 스킬 탐색 – Agent Card를 살펴보고 사용 가능한 스킬을 확인합니다.
- 메시지 전송 – 스킬을 수동으로 호출해 응답 형식을 테스트합니다.
- 상태 스트리밍 – 에이전트가 “Submitted”에서 “Completed”로 이동하는 동안 작업 수명주기를 실시간으로 관찰합니다.
결론
Agent‑to‑Agent 협업은 생산성의 다음 경계입니다. 이를 실현하려면 단순한 통신 파이프만으로는 부족하고, 인식 표준이 필요합니다. apcore가 그 표준을 제공하고, apcore‑a2a가 여러분의 코드를 전문적인 에이전시 워크포스로 전환하는 다리 역할을 합니다.
다음 주제: Beyond the Brain: Exposing AI Modules to REST, gRPC, and GraphQL.
이 글은 apcore: Building the AI‑Perceivable World 시리즈의 5번째 기사입니다.
GitHub: