Agent2Agent (A2A) 샘플

🌐 언어

Agent2Agent (A2A) 프로토콜의 공식 코드 샘플과 데모에 오신 것을 환영합니다.

여러분을 만나게 되어 매우 기쁩니다! 멀티 에이전트 아키텍처를 처음 탐험하시는 분이든, 고급 상호운용 에이전트 네트워크를 구축하시는 분이든, 이 저장소는 개발을 가속화할 수 있는 간단하고 영감을 주는 학습 자료를 제공합니다.

왜 Agent2Agent인가요?

다양한 AI 프레임워크와 생태계가 존재하는 세상에서, 에이전트는 안전하게 소통·협력하고 업무를 위임하기 위한 공통 언어가 필요합니다. A2A 프로토콜은 멀티 에이전트 상호운용성을 위한 표준화되고 오픈된 규격을 제시합니다.

저희 샘플은 다양한 언어와 호스트 애플리케이션에서 복잡한 멀티 에이전트 문제를 쉽게 해결할 수 있음을 보여줍니다.

빠른 시작

Helloworld 에이전트를 실행하고 Python CLI 호스트를 통해 바로 통신해보세요.

에이전트 서버 시작:

터미널을 열고 Helloworld 에이전트 서버를 시작하세요:

``bash cd samples/python/agents/helloworld uv run .`

호스트 클라이언트 실행:

두 번째 터미널을 열고 CLI 클라이언트를 실행하여 에이전트에 작업을 전송하세요:

`bash cd samples/python/agents/helloworld uv run test_client.py``

리포지토리 구조

리포지토리는 언어별로 여러 주요 디렉토리로 구성되어 있습니다:

| 디렉토리 | 설명 | | --- | --- | | samples | 프로그래밍 언어별로 구성된 핵심 A2A 샘플. | | samples/python | A2A Python SDK를 사용한 Python 에이전트 구현 예시. | | samples/go | A2A Go SDK를 사용한 Go 에이전트 구현 예시. | | samples/dotnet | A2A .NET SDK를 사용한 C# 에이전트 구현 예시. | | samples/java | A2A Java SDK를 사용한 Java 에이전트 구현 예시. | | samples/js | A2A JavaScript SDK를 사용한 Node.js 에이전트 구현 예시. |

기여하기

모든 수준의 기여를 환영하며 적극적으로 권장합니다! 새로운 샘플 아이디어, 버그 수정, 문서 개선이 있다면 기여 가이드를 확인해주세요.

도움 받기

저희는 환영하며 지원하는 커뮤니티를 제공하기 위해 노력하고 있습니다. 질문, 피드백, 문제 발생 시 이슈 페이지로 연락해 주세요.

면책 조항

중요: 제공된 샘플 코드는 시연 목적이며 동작 원리를 보여줍니다. 에이전트-투-에이전트(A2A) 프로토콜. 프로덕션 애플리케이션을 구축할 때, 직접 제어하지 않는 모든 에이전트를 잠재적으로 신뢰할 수 없는 엔티티로 취급하는 것이 중요합니다.

외부 에이전트로부터 받은 모든 데이터—AgentCard, 메시지, 아티팩트, 작업 상태 등을 포함하되 이에 국한되지 않음—는 신뢰할 수 없는 입력으로 처리해야 합니다. 예를 들어, 악의적인 에이전트가 각 필드(예: 설명, 이름, skills.description)에 조작된 데이터가 포함된 AgentCard를 제공할 수 있습니다. 이 데이터가 정제 없이 대형 언어 모델(LLM)을 위한 프롬프트를 구성하는 데 사용된다면, 프롬프트 인젝션 공격에 노출될 수 있습니다. 이 데이터를 사용하기 전에 적절히 검증하고 정제하지 않으면 애플리케이션에 보안 취약점이 발생할 수 있습니다.

개발자는 입력 검증, 자격 증명의 안전한 처리 등 시스템과 사용자를 보호하기 위한 적절한 보안 조치를 구현할 책임이 있습니다.

--- Tranlated By Open Ai Tx | Last indexed: 2026-05-21 ---

a2a-samples