ADK-Rust

ADK-Rust 공식 문서

ADK-Rust(Rust용 에이전트 개발 키트) 공식 문서에 오신 것을 환영합니다. 이 문서는 ADK 프레임워크의 Rust 구현을 사용하여 AI 에이전트를 구축하기 위한 종합적인 가이드와 참조 자료를 제공합니다.

시작하기

  • 소개 - ADK-Rust의 개요, 아키텍처 및 핵심 개념
  • 빠른 시작 - 5분 이내에 내장 UI에서 첫 번째 에이전트를 스캐폴딩하고 실행 및 테스트
  • A2UI 빠른 시작 - A2UI JSONL을 생성하고 React에서 렌더링
  • 1.0 → 2.0 마이그레이션 - 변경 전/후 코드를 포함한 전체 호환성 변경 목록

핵심

  • 핵심 타입 - 기본 타입: Content, Part, Agent 트레이트, Tool 트레이트, 컨텍스트
  • Runner - 에이전트 실행 런타임 및 구성
  • 플러그인 - 도구/모델 가로채기 및 미들웨어를 위한 수명 주기 훅

모델

  • 모델 제공자 - LLM 통합: Gemini, OpenAI, Anthropic, DeepSeek, Groq, Ollama
  • Ollama - Ollama를 사용한 로컬 추론
  • mistral.rs 통합 - 고성능 로컬 추론을 위한 네이티브 mistral.rs

에이전트

코딩 에이전트

네이티브 코딩 에이전트: 샌드박스 작업 공간에서 코드를 읽고/편집하고/실행하며, 자율적 목표 모드와 병렬 울트라 리뷰 워크플로를 제공합니다.

  • 개요 - 여기서 시작하세요: 구성 요소, 설치 및 60초 빠른 시작
  • 개발 도구 - adk-devtools: 읽기/쓰기/편집/glob/grep/bash 및 샌드박스 처리된 Workspace
  • 하네스 - CodingAgent(coding 기능), 계획 루프, write_todos
  • CLI - adk-rust code / goal(내구성 있고 재개 가능) / ultracode
  • 워크플로 - adk-graph에서의 울트라 리뷰: 병렬 리뷰어 + 팬인
  • 예제 - 실행 가능한 세 가지 예제 크레이트

실시간 및 멀티모달

음성 및 멀티모달 에이전트 구축을 위한 전용 입문자 친화적 가이드 — 아키텍처, 개념 및 실행 가능한 예제를 다룹니다.

  • 개요 - 여기서 시작하세요: 멘탈 모델, 설치 및 60초 빠른 시작
  • 아키텍처 - 네 가지 계층, 이벤트 루프, 오디오 파이프라인 및 턴 수명 주기
  • 프로바이더 - OpenAI Realtime 및 Gemini Live 모델, 음성 및 선택 방법
  • 도구 - 서버 측 작업: 네이티브 핸들러, 브리지된 adk_core::Tools, 병렬 호출
  • 멀티모달 - send_video_frame 및 브라우저 카메라 캡처를 통한 비디오 입력
  • 감정 인식 대화 - Gemini 네이티브 오디오에서의 감정 인식 응답
  • 메모리 - 컨텍스트 주입, 턴 저장 및 지식 그래프 자체 큐레이션
  • 웹 앱 구축 - 서버 측 브리지, WS 프로토콜 및 Web Audio
  • 예제 - 실행 가능한 네 가지 예제와 권장 학습 경로

도구

  • 함수 도구 - 비동기 Rust 함수로 사용자 지정 도구 생성
  • 내장 도구 - GoogleSearchTool와 같은 사전 구축 도구
  • MCP 개요 및 아키텍처 - MCP가 어디에 해당하며 어떤 ADK-Rust 표면을 사용할지 설명
  • MCP 클라이언트 - 도구, 리소스, 프롬프트, 완성, 구독, 정보 요청, 작업 및 HTTP
  • 동적 MCP 서버 관리자 - 런타임 로컬 서버 레지스트리, 지속성, 모니터링 및 재시작
  • MCP 서버 작성 - 공식 Rust SDK에 맞춰 도구 및 기타 기능 게시
  • MCP 보안 - 인증, 가시성, 권한 부여, 승인 및 비밀 처리
  • MCP 테스트 - 결정론적 게이트 및 배포 검증
  • 브라우저 도구 - 웹 자동화를 위한 46개의 WebDriver 도구
  • UI 도구 - 양식, 카드, 차트를 사용한 동적 UI 생성
  • RAG - 지식 베이스 검색을 위한 검색 증강 생성
  • ACP 도구 - ACP 코딩 에이전트를 형식이 지정된 ADK-Rust 도구로 사용
  • 재시도 및 성찰 - 성찰 프롬프트를 통한 도구 실패 복구
  • 작업 노드 - 워크플로 그래프를 위한 14가지 결정론적 노드 유형
  • 벤치마킹 - cargo adk bench를 사용한 성능 측정

에이전트 클라이언트 프로토콜

ADK-Rust의 외부 코딩 에이전트를 사용하거나, 안정적인 ACP v1을 통해 ADK-Rust 에이전트를 편집기에 노출합니다.

세션 및 상태

  • 세션 - 세션 관리 및 수명 주기
  • 상태 관리 - 접두사를 사용한 대화 상태 관리

메모리

세션보다 오래 유지되는 장기 메모리 — 세션 상태에 대응하는 영속적인 저장소입니다. 의미 저장소와 이중 시간 지식 그래프를 모두 다루는, 초보자에게 친화적인 전용 가이드입니다.

  • 개요 - 여기서 시작하기: 두 가지 메모리 유형, 개념 모델, 설치 및 빠른 시작
  • 개념 - MemoryEntry, MemoryService 트레이트, 검색, 프로젝트 범위 지정, GDPR 삭제
  • 백엔드 - 여섯 가지 저장소(InMemory, SQLite, Postgres+pgvector, Redis, MongoDB, Neo4j) 및 선택 방법
  • 지식 그래프 - GraphMemoryService: 엔터티, 관찰, 관계 및 이중 시간이 중요한 이유
  • 도구 및 에이전트 - 에이전트에 메모리 연결하기; remember/relate 및 메모리 도구

콜백 및 이벤트

  • 콜백 - 에이전트 동작 가로채기 및 사용자 지정
  • 이벤트 - 이벤트 시스템 및 대화 기록 이해

아티팩트

관찰 가능성

배포

평가

관리형 에이전트

보안

규정 준수

  • Vertex 전용 배포 - HIPAA 및 데이터 레지던시 워크로드에서 Gemini Studio(generativelanguage.googleapis.com) 트래픽이 없음을 보장

Studio

  • ADK Studio - 에이전트 구축을 위한 시각적 개발 환경
  • 작업 노드 - 자동화 워크플로를 위한 비-LLM 프로그래밍 방식 노드
  • 트리거 - 워크플로를 위한 웹훅, 일정 및 이벤트 트리거

개발

  • 개발 지침 - 기여 가이드 및 모범 사례
  • 성능 0.8 - 최적화 릴리스 예시 및 도입 중심 검증

검증 상태

README 및 공식 문서의 Cargo 명령어와 종속성 스니펫은 scripts/check-doc-examples.sh에 의해 검증됩니다. CI는 또한 scripts/check-cargo-adk-templates.sh을 사용하여 cargo-adk 스캐폴드를 확인하고, scripts/check-example-name-collisions.sh을 사용하여 중복 예제 대상 이름을 거부하며, cargo check --workspace --examples를 사용하여 워크스페이스 예제를 컴파일합니다.