Google ADK 가이드: 멀티 에이전트 워크플로우와 결정적 노드

InYourLeague 리서치 · 2026-08-27

Answer in brief

Google ADK는 AI 기반 에이전트와 결정적 실행 노드를 조합해 그래프, 동적, 협업, 템플릿 워크플로우를 구성합니다. 또한 실험적 런타임 라우팅을 제공하며, 작업 책임을 분리하고 각 작업에 주어지는 데이터 컨텍스트를 제한할 수 있게 합니다.

Key facts at a glance

Failure modes and verification

FAQ

Google ADK는 무엇을 워크플로우로 간주합니까?

Google ADK는 둘 이상의 에이전트 또는 실행 가능한 노드가 포함된 모든 에이전트 애플리케이션을 워크플로우로 간주합니다. 프로젝트 요구가 생기기 전부터 단일 에이전트 애플리케이션을 해당 구조로 전환해야 하는 것은 아닙니다. Agents를 참고하십시오.

그래프 기반 워크플로우와 동적 워크플로우는 어떻게 다릅니까?

그래프 기반 워크플로우는 에이전트, 결정적 노드, 가능한 의사결정 분기를 유연한 실행 그래프로 표현합니다. 동적 워크플로우는 같은 유형의 요소들을 완전한 프로그래밍 코드 로직으로 조합합니다. Workflows를 참고하십시오.

협업 워크플로우와 템플릿 워크플로우의 차이는 무엇입니까?

협업 워크플로우에서는 하나의 에이전트가 지정된 하위 에이전트들을 이끄는 동적 조정자 역할을 맡습니다. 템플릿 워크플로우는 BaseAgent를 확장하고 고정된 순차, 반복, 병렬 실행 로직을 따릅니다. Workflows를 참고하십시오.

Agent Routing은 Google ADK의 정식 워크플로우 기능입니까?

공식 문서는 Agent Routing을 실험적 기능으로 표시합니다. Agent Routing은 라우터 함수로 런타임 에이전트를 선택해 폴백, A/B 테스트, 자동 라우팅에 사용됩니다. Workflows를 참고하십시오.

google-adk에 공식적으로 선택 가능한 모델 ID가 있습니까?

공식 출처는 이 제품에 대해 선택 가능한 모델 ID를 공개하지 않습니다. 문서는 모델 통합을 설명하지만 google-adk의 선택 가능한 모델 ID는 제공하지 않습니다. Agents를 참고하십시오.

Sources and freshness

• Official source
• Official source
• Last verified: 2026-08-27

Extended guide

Google ADK는 AI 기반 에이전트와 결정적 실행 노드를 함께 구성하는 멀티 에이전트 애플리케이션을 직접 지원합니다. 이 google-adk 문서 항목은 2026-08-27을 기준으로 공식 문서와 대조해 확인했습니다.

핵심 구성 모델

ADK의 Agent는 LlmAgent라고도 설명되며, 특정 목표를 자율적으로 달성하도록 설계된 독립 실행 단위입니다. 기본 구성 요소는 AI 모델, 작업 지침, 그리고 선택적으로 제공되는 도구 집합입니다. 에이전트는 작업을 수행하고, 사용자와 상호 작용하고, 외부 도구를 사용하고, 다른 에이전트와 조정할 수 있습니다. 하나의 애플리케이션에 둘 이상의 에이전트 또는 실행 가능한 노드가 포함되면 ADK는 그 애플리케이션을 워크플로우로 간주합니다.

Google ADK는 모든 애플리케이션에 멀티 에이전트 구조나 그래프 구조를 강제하지 않습니다. 공식 가이드는 긴 다단계 지침을 안정적으로 따르기 어려운 경우, 필요한 데이터가 모델의 컨텍스트 창 한도를 초과하는 경우, 코드 모듈성과 재사용성을 높여야 하는 경우, 비결정적인 모델 기능과 결정적 코드를 함께 실행해야 하는 경우에 워크플로우를 고려할 수 있다고 설명합니다. 따라서 워크플로우는 모든 실행 결정을 하나의 모델 기반 에이전트에 맡기지 않고 작업 책임을 여러 요소로 나누는 구성 방식입니다.

워크플로우 선택지

공식 워크플로우 개요는 다음 구조를 설명합니다.

그래프 워크플로우는 실행 경로와 의사결정 분기를 명시적으로 표현합니다. 동적 워크플로우는 일반 프로그래밍 로직이 실행 경로를 결정하게 합니다. 협업 워크플로우에서는 지정된 에이전트가 조정을 담당하지만, 템플릿 워크플로우에서는 미리 정해진 실행 패턴이 적용됩니다. 따라서 유연한 분기, 코드가 통제하는 실행, 에이전트 중심 협업, 고정되고 반복 가능한 패턴 중 무엇이 필요한지에 따라 구조를 구분할 수 있습니다.

구성 절차

1. 각 에이전트를 모델, 지침, 선택적 도구로 정의하고 명확한 작업 책임을 부여합니다. 에이전트가 담당할 목표와 다른 에이전트가 담당할 목표를 구분합니다.
2. 모델의 비결정적 판단이 아니라 결정적 코드로 실행해야 하는 작업을 식별합니다. 그런 작업은 실행 가능한 노드로 배치할 수 있습니다.
3. 분기를 구조에 명시해야 한다면 그래프 워크플로우를 선택합니다. 완전한 프로그래밍 로직이 실행 흐름을 제어해야 한다면 동적 워크플로우를 선택합니다.
4. 하나의 조정자 에이전트가 지정된 하위 에이전트들과 함께 작업해야 한다면 협업 워크플로우를 사용합니다. 순차, 반복, 병렬 실행처럼 고정된 패턴이 필요하다면 템플릿 워크플로우를 사용합니다.
5. 런타임 폴백, A/B 테스트, 자동 에이전트 선택을 검토할 때는 Agent Routing이 실험적 기능이라는 상태를 유지합니다. 공식 문서가 안정 기능이라고 명시하지 않으므로 그 이상으로 해석해서는 안 됩니다.

데이터 컨텍스트 경계

공식 워크플로우 문서는 특정 작업의 데이터 컨텍스트를 제한하는 것을 구조적 이점으로 제시합니다. 단일한 대형 에이전트를 여러 에이전트와 실행 노드로 분리하면 작업 책임을 분리하고 각 작업이 더 좁고 관련성 높은 컨텍스트를 사용하도록 구성할 수 있습니다. 이는 모델 컨텍스트 한도와 코드 관리 문제를 다루는 워크플로우의 목적과도 연결됩니다. 다만 공식 개요는 하나의 의무적인 컨텍스트 분할 방식이나 구체적인 전달 규약을 지정하지 않습니다. 어떤 데이터를 어느 에이전트나 노드에 제공할지는 애플리케이션 설계에서 정해야 합니다.

검증 체크리스트

• 각 에이전트에 명확하고 구분되는 작업 책임이 있습니다.
• 적절한 경우 결정적 작업이 실행 가능한 코드 노드에 배치되어 있습니다.
• 그래프, 동적, 협업, 템플릿 실행 방식이 필요한 제어 패턴과 일치합니다.
• 각 작업에는 의도한 범위의 데이터 컨텍스트만 제공됩니다.
• Agent Routing을 사용할 때 실험적 기능임을 명시합니다.
• 공식 출처가 제공하지 않은 모델 식별자를 임의로 만들지 않습니다.

모델 ID 상태

The official source does not publish a selectable model ID for this product. 즉, 공식 출처는 이 제품에 대해 선택 가능한 모델 ID를 공개하지 않습니다. 공식 문서는 에이전트가 AI 모델을 사용하고 Google 및 다른 제공자의 모델을 통합할 수 있다고 설명하지만, google-adk 자체에 속하는 선택 가능한 모델 ID는 제시하지 않습니다.

모델 제공 범위 안내: 공식 출처는 선택 가능한 모델 ID를 지정하지 않습니다.