ADK-Rust 2.0

Rust 프레임워크고성능, 생산 준비 완료AI 에이전트.

ADK-Rust는 유형이 지정된 에이전트, 도구, 내구성 상태, 실시간 미디어 및 개방형 프로토콜을 하나의 비동기 런타임으로 제공하므로 집중 에이전트에서 자신 있게 운영할 수 있는 시스템으로 이동할 수 있습니다.

작업 단위로 시작

ADK-Rust 측면에서 AI 에이전트란 무엇입니까?

에이전트는 비동기 Rust 구성 요소입니다. 호출 컨텍스트를 수신하고, 모델이나 도구를 사용하여 작업을 수행하고, 진행되면서 형식화된 이벤트를 내보냅니다. LLM 에이전트, 워크플로, 실시간 에이전트, 코딩 에이전트 및 사용자 정의 Rust 에이전트는 모두 이 공유 계약을 사용합니다.

ADK-Rust를 매력적인 이유는 에이전트가 사용자가 이해하고 제어할 수 있는 소프트웨어 시스템의 일부로 남아 있다는 것입니다. 모델 호출, 도구 입력, 상태 변경, 승인 및 스트리밍 이벤트에는 명시적인 Rust 계약이 있습니다. 동일한 런타임은 Rust 팀이 기대하는 성능, 동시성, 이동성 및 운영 원칙을 유지하면서 집중된 어시스턴트, 내구성 있는 다중 에이전트 워크플로, 실시간 음성 경험 또는 서비스 전반에 걸쳐 작동하는 에이전트를 지원할 수 있습니다.

LangGraph, Google ADK, OpenAI Agents SDK 또는 CrewAI를 알고 있다면 도구, 핸드오프, 워크플로, 메모리, 가드레일 및 추적을 인식할 것입니다. ADK-Rust는 이러한 아이디어를 Rust 기본 런타임에 가져와 실시간 미디어, 코드 실행, RAG, 아티팩트 및 MCP, A2A, ACP 및 AWP와 같은 개방형 프로토콜과 연결합니다. 버전 2는 그래프, 실시간, 코딩 및 CodeAct 에이전트로 해당 기반을 확장합니다. 공급자 인식 도구 스키마; 구성 가능한 프로젝트 템플릿 및 화물 광고 빌드; 더 강력한 상태 및 운영 제어; 첫 번째 모델 호출부터 프로덕션까지 일관된 형식의 이벤트 추적입니다.

아키텍처를 읽는 방법

왼쪽에서 오른쪽으로 다이어그램을 따르십시오. 제품 표면이 Runner에 요청을 보냅니다. Runner는 세션 상태와 호출 컨텍스트를 첨부한 다음 선택한 에이전트를 호출합니다. 모델, 도구 및 상태는 작업을 지원하고 타입 안전 이벤트는 진행 상황과 결과를 다시 전달합니다.

런타임 내부

Runner, 에이전트, 타입 안전 이벤트, 모델/도구 루프, 세션, 콜백, 전송 및 취소.

경계에서

MCP, A2A, ACP, AWP, HTTP, SSE 및 실시간 전송은 별도의 시스템과 신뢰 영역을 연결합니다.

프레임워크 외부

Studio, UI, 플레이그라운드 및 제어 평면은 ADK-Rust를 사용합니다. Runner 내부에서는 실행되지 않습니다.

프레임워크 표면

아키텍처 뒤에 숨은 기능.

ADK-Rust는 에이전트 동작을 구성하고, 도구를 제공하고, 컨텍스트를 보존하고, 다른 시스템에 연결하고, 프로덕션에서 안전하게 작동하는 등 전체 에이전트 수명주기를 하나의 프레임워크로 가져옵니다. 아래 그룹은 이러한 기능이 어떻게 조화를 이루는지 보여줍니다.

LLM, 워크플로, 그래프, 실시간 및 코딩 에이전트를 구축하세요. 타입 안전 도구, MCP, RAG, 메모리, 세션 및 아티팩트를 장비합니다. REST, A2A, ACP 및 AWP를 통해 연결합니다. 그런 다음 인증, 가드레일, 원격 측정 및 프로덕션 평가를 추가합니다.

작성

작성 capability

LlmAgent

The main model-driven agent. Give it instructions, an LLM, tools, callbacks, and optional sub-agents; the Runner streams its work as typed events.

행위

행위 capability

#[tool]

Turns a typed async Rust function into a model-callable tool and derives the argument schema from Rust types.

기억하다

기억하다 capability

sessions

Keep conversation events and application state together so a user can continue the same interaction over multiple turns.

연결하다

연결하다 capability

REST

Exposes familiar HTTP endpoints for clients that send a request and receive a structured response.

운영하다

운영하다 capability

auth

Establishes who is calling the system through API keys, OAuth, OIDC, SSO, and application identity.

빌드

빌드 capability

12 templates

Generate working starting shapes for focused agents, tools, retrieval, APIs, workflows, realtime sessions, and custom logic.

작동 방식 보기

작업이 진행되는 동안 작품을 보여주세요.

Runner는 세션을 해결하고, 호출 컨텍스트를 구축하고, 에이전트를 실행하고, 모델 및 도구 작업을 스트리밍하고, 상태 변경을 적용하고, 지속성 이벤트를 유지하고, 발생하는 진행 상황을 호출자에게 반환합니다.

동일한 추적을 통해 터미널, 웹 UI, API 클라이언트, 평가 또는 실시간 대화를 제공할 수 있습니다.

실제 요청을 따르십시오

고객이 "왜 결제가 실패했나요?"라고 묻습니다. Runner는 올바른 세션을 열고, 모델 출력 및 도구 활동을 스트리밍하고, 상태 변경을 기록하고, 유용한 각 이벤트를 인터페이스에 반환합니다. 운영자가 완전한 실행 기록을 얻는 동안 사용자는 진행 상황을 볼 수 있습니다.

행동을 구성하라

작업이 커지면 스레드를 잃지 않고 작업을 분할합니다.

다중 에이전트 패턴 연구

라우터는 수행해야 할 작업을 식별합니다. 전문가는 자신이 가장 잘 이해하는 부분을 처리합니다. 순차 및 병렬 워크플로는 실행 순서를 제어하는 반면, 그래프 체크포인트는 동일한 작업에 연결된 증거, 승인 및 진행 상황을 유지합니다.

그래프는 한 에이전트에게 모든 것을 즉석에서 처리하도록 요구하지 않습니다. 라우팅을 통해 문제가 좁아지고, 전문가가 동시에 조사하고, 공유 상태가 증거의 일관성을 유지하고, 결과적인 조치가 명시적인 승인 경계 뒤에 남아 있습니다.

LlmAgent

집중된 추론

모델, 지침, 도구, 콜백 및 스트리밍 출력은 대부분의 시스템에서 작고 유용한 중심입니다.

Sequential · Parallel · Loop

결정론적 작업

Rust 프로그램에서 순서, 동시성, 반복 및 종료 조건을 직접 표현합니다.

GraphAgent

내구성 있는 오케스트레이션

사람에 대한 분기, 체크포인트, 인터럽트 및 프로세스나 대화가 진행된 후 재개됩니다.

CodingAgent · CodeActAgent

행동으로서의 소프트웨어

귀하가 제어하는 작업 영역 및 샌드박스 경계 내에서 에이전트가 코드를 검사, 편집 및 실행할 수 있습니다.

RealtimeAgent

실시간 대화

하나의 라이브 세션을 통해 오디오, 스크립트, 비디오 프레임, 중단 및 서버 측 도구를 전달합니다.

CustomAgent

자신만의 런타임 로직

Rust에 직접 작성된 제품별 동작에 대한 에이전트 계약을 구현합니다.

에이전트 주변 시스템

모델은 제품의 일부입니다.

유용한 에이전트에는 도구, 상태, 인터페이스, 경계 및 증거가 필요합니다. ADK-Rust는 귀하가 소유한 구성 가능한 Rust 인터페이스를 통해 각 부분을 노출합니다.

하나의 제품, 여러 가지 책임

고객 지원 제품에서 모델은 응답 초안을 작성하고 도구는 주문을 검사하며 세션은 고객 컨텍스트를 전달하고 승인은 환불을 제어하며 아티팩트는 영수증을 저장하고 원격 측정은 결과를 기록합니다. 각 책임은 런타임 중에 계속 표시됩니다.

이 모델은 사람들이 사용할 수 있는 인터페이스, 작동할 수 있는 도구, 생존 상태, 위험을 제한하는 제어, 발생한 일을 설명하는 증거 등 완전한 제품 내부에 인텔리전스를 제공합니다.

모델

에이전트를 재설계하지 않고도 모델을 변경할 수 있습니다.

호스팅된 프론티어 모델, 빠른 라우팅 모델, 로컬 Ollama 및 기본 mistral.rs 추론은 공통 Llm 계약 뒤에 있습니다.

Gemini · OpenAI · Anthropic · OpenRouter · DeepSeek · Groq · Ollama · Bedrock · Azure AI · 호환 엔드포인트

도구

도구는 명시적이고 검사 가능한 계약을 사용합니다.

입력된 Rust 함수, MCP 서버, 기술, 브라우저 세션, 코딩 에이전트 또는 샌드박스 프로세스를 런타임이 검사하고 호출할 수 있는 기능으로 전환합니다.

#[tool] · FunctionTool · MCP · ACP · 스킬 · 브라우저 · 코드

상태

대화와 그 결과로 얻은 작업을 유지하세요.

세션은 이벤트 기록을 보유합니다. 기억은 유용한 지식을 검색합니다. 아티팩트는 파일을 보존합니다. 그래프 체크포인트를 사용하면 긴 작업을 재개할 수 있습니다.

SQLite · PostgreSQL · Redis · MongoDB · Firestore · Neo4j · 암호화된 세션

실시간

라이브 에이전트는 음성 엔드포인트 그 이상입니다.

ADK-Rust는 Rust 소유 세션 내에서 오디오, 스크립트, 비디오 프레임, 도구 호출, 중단 및 변경 컨텍스트를 유지합니다.

OpenAI Realtime · Gemini Live · Vertex Live · LiveKit · 선택적 WebRTC

지식

검색을 동일한 실행 추적으로 가져옵니다.

모델이 응답하기 전에 문서를 청크하고, 삽입하고, 벡터 저장소를 검색하고, 결과 순위를 다시 매기고, 프로젝트별로 메모리를 분리합니다.

RAG 파이프라인 · 의미 기억 · 지식 그래프 · 5개의 벡터 저장소 구현

제어

행동이 일어나는 곳에 승인을 가하세요.

승인, 콜백, 가드레일, 샌드박스 프로필, 취소, 원격 측정 및 평가는 프로덕션 실행 경계를 형성합니다.

RBAC · OAuth/OIDC · 도구 확인 · PII 가드레일 · OpenTelemetry · 평가

경계를 선택하세요

거리에 맞는 프로토콜을 사용하세요.

기능이 실행되는 곳부터 시작하세요.

배포, 상태 및 신뢰를 공유하는 경우 하위 에이전트를 하나의 ADK-Rust 런타임 내에 유지하세요. 기능, 에이전트, 코딩 작업 영역 또는 웹 사이트에 자체 배포, 프로세스, 소유권 또는 신뢰 경계가 있는 경우 프로토콜을 도입하세요.

동일한 Rust 프로세스

에이전트, 하위 에이전트 또는 도구

외부 도구 또는 리소스

MCP

독립적으로 배포된 에이전트

A2A

코딩 프로세스 또는 IDE

ACP

에이전트가 읽을 수 있는 웹사이트

AWP

MCP

모델 컨텍스트 프로토콜

다른 곳에 거주하는 에이전트 기능을 제공합니다.

What is MCP?

에이전트가 호출할 수 있는 도구와 읽을 수 있는 리소스를 외부 서버에서 게시하는 표준 방법입니다.

Why use this protocol?: 모든 데이터베이스, SaaS 제품, 파일 시스템 또는 지식 소스에 대해 맞춤형 어댑터를 작성하지 않아도 되며 동일한 서버가 둘 이상의 에이전트를 서비스할 수 있습니다.
How does ADK-Rust use MCP?: McpToolset은 서버를 ADK-Rust의 도구 계약에 연결합니다. 런타임은 해당 스키마를 검색하고, 선택한 모델 공급자에 대해 정규화하며, MCP 리소스를 읽거나 로컬 MCP 서버 프로세스를 관리할 수 있습니다.
When should I choose MCP?: 기능이 별도의 프로세스에 속하거나 이미 MCP 서버가 있거나 여러 에이전트 및 애플리케이션에서 공유되어야 하는 경우 MCP를 사용하십시오.
What connects through MCP?: The other side is an MCP server: for example a database gateway, business API, document store, developer tool, or internal service.

Explore MCP in ADK-Rust

A2A

에이전트 간 프로토콜

독립적으로 배포된 에이전트가 함께 작동하도록 하세요.

What is A2A?

원격 에이전트를 검색하고, 작업을 전송하고, 진행 상황을 추적하고, HTTP 경계를 넘어 결과를 수신하기 위한 네트워크 프로토콜입니다.

Why use this protocol?: 전문가는 자신의 모델, 도구, 상태, 릴리스 주기, 배포 및 보안 경계를 유지할 수 있습니다.
How does ADK-Rust use A2A?: ADK-Rust는 A2A v1 서버 및 작업 작업을 통해 에이전트를 노출할 수 있습니다. 그런 다음 코디네이터는 스트리밍 이벤트가 작업 진행 상황을 보존하는 동안 해당 원격 서비스를 전문가로 취급할 수 있습니다.
When should I choose A2A?: 에이전트를 별도로 배포, 확장, 소유하거나 보호하는 경우 A2A를 사용하세요. 이러한 경계가 존재하지 않는 경우에는 일반 하위 에이전트를 계속 진행 상태로 유지합니다.
What connects through A2A?: The other side is another agent service—perhaps a research specialist, finance agent, partner agent, or a system owned by another team.

Explore A2A in ADK-Rust

ACP

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

소프트웨어 작업을 실제 코딩 에이전트에게 위임하세요.

What is ACP?

편집자, CLI 및 오케스트레이션 시스템을 포함하여 코딩 에이전트와 이를 호스팅하는 클라이언트 간의 세션을 표준화하는 프로토콜입니다.

Why use this protocol?: 코딩 작업에는 세션 전반에 걸쳐 작업 공간 컨텍스트, 스트리밍 진행, 취소 및 권한 결정이 필요합니다.
How does ADK-Rust use ACP?: AcpAgentTool 및 AcpToolset을 사용하면 ADK-Rust 에이전트가 ACP 프로세스를 시작하거나 연결하고, 세션을 설정하고, 해당 작업을 스트리밍하고, 결과를 도구 호출로 반환할 수 있습니다. 선택적 서버 측은 ADK-Rust 에이전트를 ACP 클라이언트에 노출할 수 있습니다.
When should I choose ACP?: 저장소 탐색, 구현, 리팩토링, 테스트 또는 통제된 개발 작업 공간 내에서 발생해야 하는 위임 작업에 ACP를 사용하세요.
What connects through ACP?: The other side is an ACP-compatible coding agent or client, such as Codex, Claude Code, an IDE, or your own ACP implementation.

Explore ACP in ADK-Rust

AWP

에이전트 웹 프로토콜

상담원이 웹사이트를 스크랩하기 전에 웹사이트를 이해할 수 있도록 만드세요.

What is AWP?

사이트가 누구인지, 에이전트가 무엇을 할 수 있는지, 어떤 정책이 적용되는지, 에이전트 대면 서비스가 정상인지 여부를 게시하는 웹 프로토콜입니다.

Why use this protocol?: HTML은 브라우저에 페이지를 설명하지만 자율 에이전트에 비즈니스 기능, 동의, 신뢰, 제한 또는 이벤트를 설명하는 경우는 거의 없습니다.
How does ADK-Rust use AWP?: adk-awp는 비즈니스 컨텍스트를 로드하고, 검색 및 기능 매니페스트를 생성하고, 신뢰 인식 비율 제한, 동의, 이벤트 구독 및 상태 모니터링을 위해 버전이 지정된 Axum 경로를 추가합니다.
When should I choose AWP?: 취약한 페이지 해석에만 의존하지 않고 에이전트가 웹사이트나 서비스를 의도적으로 검색하고 사용할 수 있어야 하는 경우 AWP를 사용하세요.
What connects through AWP?: The other side is a visiting personal agent, enterprise agent, partner system, or agent-aware client that discovers and respects the site's published contract.

Explore AWP in ADK-Rust

개발자 빠른 시작

터미널에서 작업 에이전트까지, 한 번에 하나의 결정을 내리세요.

작고 작동하는 Rust 프로젝트부터 시작하세요. 아래 안내 단계에서는 생성기가 추가하는 내용, 프로젝트를 로컬로 컴파일하는 방법, 제품 성장에 따라 확장할 위치를 설명합니다.

결국 당신은 무엇을 갖게 될 것인가

타입 안전 도구, 대화형 Launcher 세션, 원격 측정 설정, 세션 및 가드레일 통합 지점, 터미널의 실제 모델 응답을 포함하는 컴파일된 Rust 에이전트입니다. 생성된 프로젝트는 읽고, 변경하고, 확장할 수 있는 일반 Rust 소스입니다.

시작하기 전에

컴퓨터에는 두 가지가 필요합니다.

Rust 1.95 이상.
Rustup으로 설치하거나 안정적인 툴체인을 업데이트하세요.

모델 API 키.
이 경로는 다음을 사용합니다. GOOGLE_API_KEY; 나중에 다른 제공자를 선택할 수 있습니다.

ADK 프로젝트 생성기 설치

Cargo-adk는 에이전트 프로젝트를 생성, 검사, 빌드 및 배포하는 데 사용되는 화물 adk 명령을 추가합니다.

cargo install cargo-adk

유용한 스타터 에이전트 만들기

입력된 Rust 도구를 호출할 수 있는 에이전트로 시작하세요. 프로젝트가 생성되는 동안 관찰 가능성, 세션 상태 및 가드레일 후크를 추가합니다.

cargo adk new support-agent --template tools \
  --addon telemetry --addon sessions --addon guardrails

모델 자격 증명 추가

생성된 예제에서는 기본적으로 Gemini를 사용합니다. 안전한 예제 파일을 복사한 다음 추적되지 않는 .env 파일에 키를 저장하세요.

cd support-agent
cp .env.example .env
# set GOOGLE_API_KEY in .env

실행하기 전에 컴파일하기

화물 adk 빌드는 아무것도 배포하지 않고 생성된 종속성, 기능 조합, Rust 유형 및 릴리스 바이너리를 확인합니다.

cargo adk build

달려가서 상담원과 대화하세요

생성된 콘솔을 실행하고, 메시지를 입력하고, 나중에 API, 워크플로 또는 실시간 제품을 구동할 수 있는 동일한 유형의 런타임을 시청하세요.

cargo run

지원 에이전트 — zsh

한 번 설치

$ cargo install cargo-adk

프로젝트 생성

$ cargo adk new support-agent \
+  --template tools \
+  --addon telemetry \
+  --addon sessions \
+  --addon guardrails

생성됨 support-agent/
├── Cargo.toml 종속성 + 기능 플래그
├── src/main.rs 에이전트 + 입력 도구
├── .env.예제 필수 구성
└── 읽어보기.md 프로젝트별 지침

모델 구성

$ cd support-agent
  cp .env.example .env
  # Add GOOGLE_API_KEY to .env

확인한 후 실행하세요.

$ cargo adk build
  cargo run

실제 v2 실행 · 타입 안전 도구 호출

  ADK-Rust — support-agent
    Type a message to chat. Type 'exit' to quit.

  You > Greet Ada casually.

  [tool] greet({"name":"Ada","style":"casual"})
  Hey Ada! What's up?

  You > exit

  Goodbye.

이럴 때 선택하세요

결정론적 오케스트레이션, 기존 상태 머신, 도메인 런타임 또는 전체 Rust 제어가 필요한 동작을 위해 선택하세요.

생성된 시작점

에이전트 특성 골격 · InvocationContext · EventStream 진입점

cargo adk new my-agent --template custom

CLI 레지스트리에는 공급자별 항목도 포함되어 있습니다. openai 템플릿, 5가지 엔터프라이즈 패턴, basic 그리고 a2a 별칭 및 구성 가능한 기능 추가 기능.

cargo adk templatescargo adk addons

필요한 것을 컴파일하세요

작게 시작하십시오. 제품에서 요청할 때 시스템을 추가하세요.

먼저 프로젝트 실행 형태에 맞는 템플릿을 선택하세요. 그런 다음 바이너리로 컴파일된 기능에 대한 기능 계층을 선택합니다.

기능 계층은 종속성, 컴파일 시간, 바이너리 표면 및 사용 가능한 프레임워크 API를 제어합니다. 영구 데이터베이스, MCP, 클라우드 비밀 관리자 및 특정 실시간 전송은 여전히 명시적인 선택입니다.

01 · 여기서 시작하세요

최소한의

에이전트 · Gemini · Runner · 세션

기본 표면이 가장 작은 집중형 에이전트입니다.

02 · 제품 만들기

표준

도구 · 메모리 · 그래프 · 서버 · 인증 · 평가 · 원격 측정

대부분의 API, 워크플로 시스템 및 내부 에이전트 제품.

03 · 시스템 확대

기업

실시간 기반 · 브라우저 · RAG · 결제 · AWP

더욱 풍부한 상호 작용과 상호 운용성이 필요한 제품.

04 · 전문가용 표면

가득 찬

오디오 · 코드 실행 · 샌드박스

가장 강력한 로컬 및 실행 기능을 선택하세요.

adk-rust = { version = "2.0.0", features = ["standard"] }

ADK-Rust로 빌드

작동하는 에이전트를 만들고, 런타임을 이해하고, 자신감을 갖고 확장하세요.

첫 번째 유용한 이정표는 요청 1개, 눈에 보이는 도구 호출 1개, 이해하는 세션 1개입니다. 안내된 빠른 시작은 해당 경로를 구축합니다. 여기에서 제품에 필요한 워크플로, 상태, 프로토콜 및 운영 제어를 추가하세요.

안내된 빠른 시작 시작 소스 탐색