A2A Debugger

A2A(Agent2Agent)는 Agent 간 통신을 위한 개방형 프로토콜입니다. A2A를 통해 서로 다른 Agent는 각자의 기능을 탐색하고, 메시지를 전송하며, 실행 결과를 반환할 수 있습니다.

A2A Debugger는 A2A Agent를 디버깅하기 위한 시각적 도구입니다. A2A Agent에 연결하고, 테스트 메시지를 보내며, Agent가 반환한 콘텐츠, 실행 상태 및 디버그 로그를 확인할 수 있어 개발자가 Agent 통합, 메시지 전달 및 반환 결과와 관련된 문제를 빠르게 해결하는 데 도움이 됩니다.

A2A Debugger는 다음과 같은 시나리오에 적합합니다.

A2A Agent가 정상적으로 연결될 수 있는지 확인

Agent의 이름, 설명, 기능 및 스킬 확인

Agent에 텍스트 또는 첨부 파일을 전송하여 응답 확인

인증, 헤더, 파일 형식 등 연결 또는 요청 문제 해결

요청 및 응답 세부 정보를 확인하여 비정상적인 반환 콘텐츠의 원인 파악

A2A Agent를 개발하거나 통합하는 경우, 정식 비즈니스 워크플로에 통합하기 전에 A2A Debugger를 사용하여 Agent가 정상적으로 연결되고 응답하는지 먼저 확인할 수 있습니다.

AI Agent Debugger의 전체 기능을 경험하시려면 최신 Apidog 클라이언트를 사용하시는 것을 권장합니다.

A2A Agent에 연결하기

페이지 상단에 Agent Card URL을 입력한 다음 Connect를 클릭하십시오.

연결에 성공하면 상단 상태가 Connected로 표시됩니다. 이 시점부터 Agent 정보를 확인하고 메시지 전송을 시작할 수 있습니다.

다른 Agent로 전환해야 하는 경우 Disconnect를 클릭한 뒤 Agent Card URL을 다시 입력할 수 있습니다.

테스트 메시지 작성하기

Agent로 전송할 테스트 입력을 Messages 탭에 작성하십시오.

메시지 편집 영역은 왼쪽과 오른쪽 섹션으로 나뉩니다.

왼쪽: 메시지 텍스트 입력, 첨부 파일 업로드, Metadata 구성

오른쪽: 해당 원시 요청 콘텐츠 확인

일반적으로 왼쪽에 텍스트를 입력하고 Send를 클릭하기만 하면 됩니다. 오른쪽의 원시 요청 콘텐츠는 실제로 전송되는 데이터 구조를 확인하거나 요청 콘텐츠를 수동으로 조정해야 하는 경우와 같은 고급 디버깅 시나리오에서 주로 사용됩니다.

메시지 전송하기

메시지 구성을 완료한 후 Send를 클릭하십시오.

현재 연결된 Agent가 없으면 A2A Debugger가 먼저 연결을 시도하며, 연결에 성공한 후 메시지를 전송합니다.

전송 후 메시지 영역에서 사용자 메시지와 Agent가 반환한 콘텐츠를 확인할 수 있습니다.

응답 메시지 확인하기

메시지 영역에는 현재 세션의 사용자 메시지와 Agent 응답이 표시됩니다.

Agent가 반환한 콘텐츠는 일반 텍스트일 수도 있고, 작업 상태, 실행 결과 또는 생성된 아티팩트를 포함할 수도 있습니다. 메시지 표시 영역을 통해 Agent가 요청을 올바르게 이해하고 처리했는지 빠르게 판단할 수 있습니다.

디버그 메시지를 클릭하면 오른쪽에서 세부 정보를 확인할 수 있습니다. 세부 정보 패널은 세 가지 보기를 지원합니다.

Preview: 주요 콘텐츠를 더 읽기 쉬운 방식으로 표시합니다.

Content: 메시지의 텍스트 또는 핵심 데이터를 확인합니다.

Raw Data: 전체 원시 JSON을 확인합니다.

아래 화면 캡처는 다음 질문에 대한 응답을 보여 줍니다.

What is the distance between the Earth and the Moon?

Clear를 클릭하여 현재 디버그 로그를 삭제할 수 있습니다.

Agent Card 확인하기

디버깅 패널의 Agent Card 탭은 현재 연결된 Agent의 기능 설명을 확인하는 데 사용됩니다.

이 패널에는 다음 정보가 표시됩니다.

Agent 이름 및 설명

Agent 주소, 프로토콜 버전, 버전 번호

스트리밍 응답, 푸시 알림, 상태 기록 등의 지원 여부와 같은 Agent 지원 기능

기본 입력 유형 및 출력 유형

Agent가 선언한 스킬

Agent Card 유효성 검사 오류

원시 Agent Card 콘텐츠

Agent Card에 누락된 필드나 형식 문제가 있는 경우, 이 패널에서 유효성 검사 오류를 확인하고 원시 콘텐츠와 대조하여 문제를 해결할 수 있습니다.

첨부 파일 추가하기

현재 Agent가 파일 입력을 지원하는 경우, 메시지 입력 영역 아래의 첨부 파일 버튼을 클릭하여 파일을 업로드할 수 있습니다.

A2A Debugger는 Agent가 선언한 입력 유형을 기준으로 첨부 파일 업로드 허용 여부를 판단합니다.

Agent가 텍스트 입력만 지원하는 경우, 첨부 파일 버튼을 사용할 수 없습니다.

Agent가 특정 파일 형식만 지원하는 경우, 일치하는 형식의 파일만 업로드할 수 있습니다.

Agent가 모든 파일 형식을 지원하는 경우, 모든 파일을 업로드할 수 있습니다.

업로드에 성공하면 첨부 파일이 메시지와 함께 Agent로 전송됩니다.

인증 구성하기

A2A Agent에 인증이 필요한 경우, Authentication 탭에서 인증 방식을 구성할 수 있습니다.

다음 인증 유형이 지원됩니다.

인증 방식	설명
None	인증 정보를 추가하지 않습니다.
Bearer Token	토큰을 사용하여 인증합니다.
Basic Auth	사용자 이름과 비밀번호를 사용하여 인증합니다.
API Key	지정된 헤더를 통해 API Key를 전달합니다.

메시지 전송 시 권한 없음 오류가 반환되는 경우, 인증 방식, 토큰, 사용자 이름/비밀번호 또는 API Key가 올바른지 확인하십시오.

헤더 구성하기

Header 탭에서 사용자 지정 요청 헤더를 추가할 수 있습니다.

사용자 지정 헤더는 일반적으로 다음과 같은 시나리오에서 사용됩니다.

테넌트 ID, 환경 식별자 등의 비즈니스 매개변수 전달

게이트웨이, 프록시 또는 내부 서비스를 통한 인증

특수 요청 헤더가 필요한 Agent 서비스 디버깅

Header 탭의 숫자는 현재 구성된 유효한 헤더 수를 나타냅니다.

Metadata 추가하기

메시지 편집 영역 아래의 Metadata를 펼쳐 이 메시지에 사용자 지정 키-값 쌍을 추가하십시오.

Metadata는 컨텍스트 식별자, 비즈니스 매개변수 또는 디버그 마커를 전달하는 데 적합합니다. 예를 들어 환경 이름, 사용자 ID 또는 요청 출처와 같은 정보를 추가할 수 있습니다.

FAQ

연결에 실패하면 어떻게 해야 합니까?

다음을 확인하십시오.

Agent Card URL이 올바르며 현재 환경에서 접근 가능한지 확인하십시오.

Agent 서비스가 실행 중인지 확인하십시오.

인증이 필요한 경우, Authentication 탭에 올바른 인증 정보가 구성되어 있는지 확인하십시오.

테넌트 ID, 환경 식별자 또는 게이트웨이 인증 정보와 같은 추가 헤더가 필요한지 확인하십시오.

Agent Card가 반환한 콘텐츠가 유효한 JSON인지 확인하십시오.

연결에 성공한 후 첨부 파일을 업로드할 수 없습니까?

이는 일반적으로 현재 Agent가 파일 입력 지원을 선언하지 않았거나 특정 파일 형식의 업로드만 허용하기 때문입니다.

Agent Card 탭에서 Agent가 지원하는 입력 유형을 확인하고, 업로드한 파일 형식이 일치하는지 확인하십시오.

전체 요청과 응답을 어떻게 확인합니까?

디버깅 패널의 Messages 탭에서 해당 요청 또는 응답 로그를 클릭한 다음 Raw Data 보기로 전환하여 전체 JSON을 확인하십시오.

Agent가 반환한 콘텐츠가 비정상적으로 표시되면 어떻게 해야 합니까?

다음 순서로 문제를 해결할 수 있습니다.

디버그 메시지의 미리보기 콘텐츠를 확인하여 Agent가 결과를 반환했는지 확인하십시오.

Raw Data 보기로 전환하여 전체 응답을 확인하십시오.

Agent Card에 선언된 입력 유형, 출력 유형 및 스킬이 기대에 부합하는지 확인하십시오.

메시지 또는 디버그 세부 정보에 유효성 검사 오류 프롬프트가 있는지 확인하십시오.

A2A Agent에 연결하기#

테스트 메시지 작성하기#

메시지 전송하기#

응답 메시지 확인하기#

Agent Card 확인하기#

첨부 파일 추가하기#

인증 구성하기#

헤더 구성하기#

Metadata 추가하기#

FAQ#

연결에 실패하면 어떻게 해야 합니까?#

연결에 성공한 후 첨부 파일을 업로드할 수 없습니까?#

전체 요청과 응답을 어떻게 확인합니까?#

Agent가 반환한 콘텐츠가 비정상적으로 표시되면 어떻게 해야 합니까?#

A2A Agent에 연결하기

테스트 메시지 작성하기

메시지 전송하기

응답 메시지 확인하기

Agent Card 확인하기

첨부 파일 추가하기

인증 구성하기

헤더 구성하기

Metadata 추가하기

FAQ

연결에 실패하면 어떻게 해야 합니까?

연결에 성공한 후 첨부 파일을 업로드할 수 없습니까?

전체 요청과 응답을 어떻게 확인합니까?

Agent가 반환한 콘텐츠가 비정상적으로 표시되면 어떻게 해야 합니까?