Google ADK로 에이전트 빌드

Google ADK 고려 사항

Atlas 에이전트 엔진에서 ADK 에이전트를 빌드할 때는 다음 주요 점을 고려하세요.

• Google ADK SDK는 Python에서만 사용할 수 있습니다. TypeScript로 에이전트를 빌드하려면 TypeScript SDK 가이드를 참조하세요.

• 에이전트는 agent.yaml 파일에서 features.durable_workflow 값을 true로 설정해야 합니다. 이 필드를 생략하거나 false으로 설정하면 첫 번째 호출이 실패합니다. agent.yaml 파일에서 사용 가능한 필드에 대해 자세히 알아보려면 에이전트.yaml 스키마를 참조하세요.

• agent-engine-sdk-adk 패키지는 ADK BaseAgent 또는 ADK 2 Workflow을(를) 에이전트의 루트로 허용합니다.

전제 조건

시작하기 전에 다음 필수 구성 요소가 있는지 확인하세요.

• Python 3.11 이상.

• uv 패키지 관리자.

• agentengine CLI를 설치하고 인증했습니다. 방법을 학습하려면 프로젝트 생성을 참조하세요.

• Google ADK 버전 2.9.0 이상. ADK 설치 방법을 학습하려면 ADK 설치 설명서를 참조하세요.

• LLM 제공자의 API 키입니다. agentengine create 명령은 키를 입력하라는 메시지를 표시하고 LLM_API_KEY로 .env 파일에 저장합니다.

단계

agentengine create --template hello-world-agent-adk

agentengine dev up

agentengine deploy --auto

도구에 사람의 검토 추가

사람이 도구 호출을 승인할 때까지 실행을 일시 중지하려면 호출 가능한 도구 함수를 ADK FunctionTool 클래스로 래핑하고 생성자에 require_confirmation=True 옵션을 전달하세요. 승인 외의 입력을 수집하기 위해 실행을 일시 중지하려면 ADK LongRunningFunctionTool 클래스를 사용하세요. @app.tool()로 데코레이팅한 원시 함수가 아니라 app.tools()이 반환하는 호출 가능한 도구 함수를 래핑하세요.

다음 예시는 app.tools()이 반환하는 각 호출 가능한 도구를 FunctionTool 클래스로 래핑하여 모든 도구 호출이 실행되기 전에 사람의 승인을 기다리도록 합니다.

import os
from google.adk.agents import LlmAgentfrom google.adk.models.lite_llm import LiteLlmfrom google.adk.tools.function_tool import FunctionTool
@app.entrypointdef build_agent():    return LlmAgent(        name="daily",        instruction="You are a helpful assistant.",        model=app.llm(            LiteLlm(                model="<model-name>",                api_key=os.environ["LLM_API_KEY"],            )        ),        tools=[            FunctionTool(tool, require_confirmation=True)            for tool in app.tools()        ],    )

{  "resume_map": {    "<activity-id-1>": { "confirmed": true },    "<activity-id-2>": "us-east-1"  }}

지원되는 에이전트 구조

agent-engine-sdk-adk 패키지는 에이전트가 시작될 때 전체 Workflow 및 에이전트 구조가 필요합니다. 플랫폼은 해당 구조의 경로별로 각 단계를 기록합니다. 다음 표에는 agent-engine-sdk-adk 패키지에서 지원하는 ADK 기능이 나열되어 있습니다.

기타 플랫폼 기능 추가

다음 플랫폼 기능은 ADK 에이전트와 함께 작동합니다.

• agent.yaml 파일의 mcp 필드에 선언하는 원격 MCP 서버입니다. 플랫폼은 스타트업 시 도구를 검색하고 app.tools()에서 반환합니다. 자세한 내용은 원격 MCP 서버 사용을 참조하세요.

• 가드레일 출력 검토. require_review 조치가 포함된 llm_output 가드레일은 검토자가 출력을 승인하거나 거부할 때까지 모델 호출을 일시 중지합니다. resume_map 요청을 통해 출력을 검토합니다.

자세히 알아보기

• Google ADK SDK 패키지 참조

• 에이전트 계약 참조

• MongoDB Atlas 에이전트 엔진 제한 사항