ADK Go 快速入门

• Go 1.24.4 或更高版本
• ADK Go v0.2.0 或更高版本

创建一个智能体项目

使用以下文件和目录结构创建一个智能体项目：

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"
    "google.golang.org/adk/agent/llmagent"
    "google.golang.org/adk/cmd/launcher"
    "google.golang.org/adk/cmd/launcher/full"
    "google.golang.org/adk/model/gemini"
    "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)
    }

    timeAgent, 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 := &launcher.Config{
        AgentLoader: agent.NewSingleLoader(timeAgent),
    }

    l := full.NewLauncher()
    if err = l.Execute(ctx, config, os.Args[1:]); 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

MacOS / LinuxWindows

更新：my_agent/.env

export GOOGLE_API_KEY="你的个人 API 密钥"

更新: my_agent/env.bat

echo 'set GOOGLE_API_KEY="你的个人 API 密钥"' > env.bat

在 ADK 中使用其他 AI 模型

ADK 支持使用多种生成式 AI 模型。有关在 ADK 智能体中配置其他模型的更多信息，请参阅 模型与身份验证。

运行你的智能体

你可以使用你定义的交互式命令行界面，或 ADK Go 命令行工具提供的 ADK Web 用户界面来运行你的 ADK 智能体。这两个选项都允许你测试智能体并与之交互。

使用命令行界面运行

使用以下 Go 命令运行你的智能体：

从 my_agent/ 目录运行

# 记得加载密钥和设置: source .env 或 env.bat
go run agent.go

使用网页界面运行

使用以下 Go 命令通过 ADK Web 界面运行你的智能体：

从 my_agent/ 目录运行

# 记得加载密钥和设置: source .env 或 env.bat
go run agent.go web api webui

此命令启动一个带有聊天界面的网页服务器。你可以在 (http://localhost:8080) 访问网页界面。在左上角选择你的智能体并输入请求。

注意：ADK Web 仅限开发使用

ADK Web 不适用于生产部署。你应该仅将 ADK Web 用于开发和调试目的。

下一步：构建你的智能体

现在你已经安装了 ADK 并且你的第一个智能体正在运行，请尝试使用我们的指南来构建你自己的智能体：

• 构建你的智能体