Docker 快速开始

本指南将引导你使用 Docker 容器部署 Youtu-agent。它涵盖了运行带有交互式前端界面的第一个智能体的基本步骤。

先决条件

• 系统中已安装 Docker
  • 如果需要，请访问 https://www.docker.com/ 下载并安装 Docker
  • 通过运行 docker --version 验证安装

部署步骤

步骤 1. 构建 Docker 镜像

构建 Youtu-agent Docker 镜像：

docker build -t youtu-agent .

步骤 2. 配置环境

1. 通过复制模板创建配置文件：

cp .env.docker.example .env

1. 在 .env 中配置以下必需变量：

# LLM 配置
UTU_LLM_TYPE=chat.completions
UTU_LLM_MODEL=deepseek-chat
UTU_LLM_BASE_URL=https://api.deepseek.com/v1
UTU_LLM_API_KEY=<your-api-key>

# Serper API 配置
# 从 https://serper.dev/playground 获取你的密钥
SERPER_API_KEY=<your-serper-key>

# 前端配置
# 注意：对于 Docker 容器端口转发，IP 必须是 0.0.0.0
UTU_WEBUI_PORT=8848
UTU_WEBUI_IP=0.0.0.0

步骤 3. 启动服务

选项 1：运行默认的 Web 搜索智能体演示

请替换 /path/to/your/.env 并运行：

docker run -it \
    -p 8848:8848 \
    -v "/path/to/your/.env:/youtu-agent/.env" \
    youtu-agent

服务可通过 http://127.0.0.1:8848 访问

选项 2：交互式 Shell 访问

要通过替换 /path/to/your/.env 运行其他示例或自定义配置：

docker run -it \
    -p 8848:8848 \
    -v "/path/to/your/.env:/youtu-agent/.env" \
    youtu-agent \
    bash

---

下一步

• 探索示例：查看 /examples 目录以获取更多详细用例和高级脚本。