ADK-Rust

ADK-Rust 공식 문서

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

시작하기

핵심

  • 핵심 타입 - 기본 타입: Content, Part, Agent trait, Tool trait, 컨텍스트
  • 러너 - 에이전트 실행 런타임과 설정
  • 플러그인 - 도구/모델 가로채기와 미들웨어를 위한 생명주기 훅

모델

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

에이전트

코딩 에이전트

샌드박스 워크스페이스에서 코드를 읽고/편집하고/실행하는 기본 코딩 에이전트로, 자율 목표 모드와 병렬 울트라 리뷰 워크플로를 제공합니다.

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

실시간 및 멀티모달

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

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

도구

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

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

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

세션 및 상태

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

메모리

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

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

콜백 및 이벤트

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

아티팩트

관측 가능성

배포

평가

관리형 에이전트

보안

스튜디오

  • ADK 스튜디오 - 에이전트를 구축하기 위한 시각적 개발 환경
  • 액션 노드 - 자동화 워크플로를 위한 비-LLM 프로그래밍 노드
  • 트리거 - 워크플로를 위한 웹훅, 스케줄, 이벤트 트리거

개발

검증 상태

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로 워크스페이스 예제를 컴파일합니다.