ADK용 Go 빠른 시작¶

이 가이드에서는 Go용 에이전트 개발 키트를 시작하고 실행하는 방법을 보여줍니다. 시작하기 전에 다음이 설치되어 있는지 확인하십시오.

Go 1.24.4 이상

에이전트 프로젝트 만들기¶

다음 파일 및 디렉터리 구조로 에이전트 프로젝트를 만듭니다.

my_agent/
    agent.go    # 기본 에이전트 코드
    .env        # API 키 또는 프로젝트 ID

명령줄을 사용하여 이 프로젝트 구조 만들기

WindowsMacOS / Linux

mkdir my_agent\
type nul > my_agent\agent.go
type nul > my_agent\env.bat

mkdir -p my_agent/ && \
    touch my_agent/agent.go && \
    touch my_agent/.env

에이전트 코드 정의¶

내장된 Google 검색 도구를 사용하는 기본 에이전트의 코드를 만듭니다. 프로젝트 디렉터리의 my_agent/agent.go 파일에 다음 코드를 추가합니다.

my_agent/agent.go

package main

import (
  "context"
  "log"
  "os"

  "google.golang.org/adk/agent/llmagent"
  "google.golang.org/adk/cmd/launcher/adk"
  "google.golang.org/adk/cmd/launcher/full"
  "google.golang.org/adk/model/gemini"
  "google.golang.org/adk/server/restapi/services"
  "google.golang.org/adk/tool"
  "google.golang.org/adk/tool/geminitool"
  "google.golang.org/genai"
)

func main() {
  ctx := context.Background()

  model, err := gemini.NewModel(ctx, "gemini-2.5-flash", &genai.ClientConfig{
    APIKey: os.Getenv("GOOGLE_API_KEY"),
  })
  if err != nil {
    log.Fatalf("Failed to create model: %v", err)
  }

  agent, err := llmagent.New(llmagent.Config{
    Name:        "hello_time_agent",
    Model:       model,
    Description: "지정된 도시의 현재 시간을 알려줍니다.",
    Instruction: "당신은 도시의 현재 시간을 알려주는 유용한 도우미입니다.",
    Tools: []tool.Tool{
      geminitool.GoogleSearch{},
    },
  })
  if err != nil {
    log.Fatalf("Failed to create agent: %v", err)
  }

  config := &adk.Config{
    AgentLoader: services.NewSingleAgentLoader(agent),
  }

  l := full.NewLauncher()
  err = l.Execute(ctx, config, os.Args[1:])
  if err != nil {
    log.Fatalf("run failed: %v\n\n%s", err, l.CommandLineSyntax())
  }
}

프로젝트 및 종속성 구성¶

go mod 명령을 사용하여 프로젝트 모듈을 초기화하고 에이전트 코드 파일의 import 문을 기반으로 필요한 패키지를 설치합니다.

go mod init my-agent/main
go mod tidy

API 키 설정¶

이 프로젝트는 API 키가 필요한 Gemini API를 사용합니다. 아직 Gemini API 키가 없는 경우 Google AI Studio의 API 키 페이지에서 키를 만듭니다.

터미널 창에서 API 키를 프로젝트의 .env 또는 env.bat 파일에 작성하여 환경 변수를 설정합니다.

MacOS / LinuxWindows

Update: my_agent/.env

echo 'export GOOGLE_API_KEY="YOUR_API_KEY"' > .env

Update: my_agent/env.bat

echo 'set GOOGLE_API_KEY="YOUR_API_KEY"' > env.bat

ADK에서 다른 AI 모델 사용

ADK는 많은 생성 AI 모델의 사용을 지원합니다. ADK 에이전트에서 다른 모델을 구성하는 방법에 대한 자세한 내용은 모델 및 인증을 참조하십시오.

에이전트 실행¶

정의한 대화형 명령줄 인터페이스 또는 ADK Go 명령줄 도구에서 제공하는 ADK 웹 사용자 인터페이스를 사용하여 ADK 에이전트를 실행할 수 있습니다. 이 두 가지 옵션 모두 에이전트를 테스트하고 상호 작용할 수 있습니다.

명령줄 인터페이스로 실행¶

다음 Go 명령을 사용하여 에이전트를 실행합니다.

Run from: my_agent/ directory

# 키 및 설정 로드: source .env 또는 env.bat
go run agent.go

웹 인터페이스로 실행¶

다음 Go 명령을 사용하여 ADK 웹 인터페이스로 에이전트를 실행합니다.

Run from: my_agent/ directory

# 키 및 설정 로드: source .env 또는 env.bat
go run agent.go web api webui

이 명령은 에이전트용 채팅 인터페이스가 있는 웹 서버를 시작합니다. (http://localhost:8080)에서 웹 인터페이스에 액세스할 수 있습니다. 왼쪽 상단에서 에이전트를 선택하고 요청을 입력합니다.

다음: 에이전트 빌드¶

이제 ADK를 설치하고 첫 번째 에이전트를 실행했으므로 빌드 가이드를 사용하여 자신만의 에이전트를 빌드해 보세요.

에이전트 빌드

```