Agent Card 스키마

Agent Card란?

A2A (Agent-to-Agent) 프로토콜에서 에이전트를 설명하는 표준화된 메타데이터입니다. /.well-known/agent-card.json 엔드포인트를 통해 제공됩니다.

Agent Card 구조

{
  "name": "Connectivity_Troubleshooting_Agent",
  "description": "Routes requests to a Bedrock AgentCore runtime...",
  "version": "1.0.0",
  "capabilities": {
    "push_notifications": true,
    "streaming": true
  },
  "supported_content_types": ["text/plain"],
  "skills": [
    {
      "id": "dns_connectivity_troubleshooting",
      "name": "DNS Resolution and Connectivity Troubleshooting",
      "description": "Resolves DNS hostnames to EC2 instance IDs...",
      "tags": ["dns-resolution", "connectivity-analysis", "security-groups"],
      "examples": [
        "Check connectivity between app-frontend and app-backend on port 80",
        "Resolve DNS hostname database.internal.com to instance ID"
      ]
    }
  ]
}

워크샵에서 사용되는 Agent Card

Connectivity Agent

필드	값
name	Connectivity_Troubleshooting_Agent
port	10003
tags	connectivity, troubleshooting, dns, network-analysis
스킬	DNS Resolution and Connectivity Troubleshooting
타임아웃	900초 (15분)

Performance Agent

필드	값
name	Performance_Agent
port	10006
tags	performance, network-monitoring, vpc-flow-logs
스킬	Network Performance Analysis
타임아웃	900초 (15분)

Agent Card 검색 흐름

# Collaborator Agent가 원격 에이전트를 검색하는 과정
async with httpx.AsyncClient() as client:
    for address in remote_agent_addresses:
        # 1. /.well-known/agent-card.json 조회
        card_resolver = A2ACardResolver(client, address)
        card = await card_resolver.get_agent_card()

        # 2. 연결 등록
        self.remote_agent_connections[card.name] = RemoteAgentConnections(
            agent_card=card, agent_url=address
        )

        # 3. 시스템 프롬프트에 에이전트 정보 주입
        agent_info = json.dumps({
            "name": card.name,
            "description": card.description
        })

config.yaml 에서 Agent Card 생성

# config.yaml → A2A 서버가 Agent Card JSON으로 변환
agent_card_info:
  agent_arn: arn:aws:bedrock-agentcore:...
  agent_tags: [connectivity, troubleshooting]
  client_id: 77oddlg6kat5bhkmspdpl9hm7v
  discovery_url: https://cognito-idp.../openid-configuration

agent_metadata:
  name: Connectivity_Troubleshooting_Agent
  description: "..."
  capabilities:
    push_notifications: true
    streaming: true

agent_skills:
  - id: dns_connectivity_troubleshooting
    name: "DNS Resolution and Connectivity Troubleshooting"
    tags: [dns-resolution, connectivity-analysis]