ADK-Rust 공식 문서

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

시작하기

• 소개 - ADK-Rust, 아키텍처 및 주요 개념 개요
• 빠른 시작 - 10분 안에 첫 Agent 구축하기

Core

• Core Types - 기본 Type: Content, Part, Agent trait, Tool trait, contexts
• Runner - Agent 실행 런타임 및 구성

Models

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

Agents

• LlmAgent - Large Language Models를 사용하는 핵심 Agent Type
• 워크플로 Agents - 결정론적 Agent: Sequential, Parallel, Loop
• 다중 Agent 시스템 - 하위 Agent로 Agent 계층 구축
• Graph Agents - LangGraph 스타일 워크플로 오케스트레이션
• 실시간 Agents - OpenAI/Gemini를 지원하는 음성 활성화 Agent

Tools

• Function Tools - async Rust 함수로 사용자 정의 Tool 생성
• 내장 Tools - GoogleSearchTool과 같은 사전 구축된 Tool
• MCP Tools - Model Context Protocol 통합
• 브라우저 Tools - 웹 자동화를 위한 46가지 WebDriver Tool
• UI Tools - 양식, 카드, 차트를 사용한 동적 UI 생성

Sessions & State

• Sessions - Session 관리 및 수명 주기
• 상태 관리 - prefix를 이용한 대화 상태 관리

Callbacks & Events

• Callbacks - Agent 동작 가로채기 및 사용자 정의
• Events - Event 시스템 및 대화 기록 이해

Artifacts

• Artifacts - 이진 데이터 저장 및 검색

Observability

• 원격 측정 - 로깅, 트레이싱 및 모니터링

Deployment

• 런처 - 콘솔 또는 서버 모드에서 Agent 실행
• 서버 - REST API 및 웹 UI 통합
• A2A Protocol - Agent-to-Agent 통신

Evaluation

• Agent 평가 - Agent 동작 테스트 및 검증

Security

• 접근 제어 - 역할 기반 권한 및 감사 로깅
• 가드레일 - PII 수정, 콘텐츠 필터링, 스키마 유효성 검사
• Memory - Agent를 위한 장기 Semantic Memory

Studio

• ADK Studio - Agent 구축을 위한 시각적 개발 환경

Development

• 개발 가이드라인 - 기여 가이드 및 모범 사례

---

유효성 검사 상태

이 문서의 모든 코드 샘플은 official_docs_examples/ 패키지에 있는 작동하는 예제를 통해 유효성이 검사되었습니다. 각 문서 페이지에는 성공적으로 컴파일되고 실행되는 해당 예제가 있습니다.