环境变量

本文档概述了 Youtu-Agent 中关键环境变量的配置。

概述

在运行 Youtu-Agent 之前，你需要配置必要的环境变量。推荐的做法是从项目根目录复制 .env.example 文件开始：

cp .env.example .env

然后，编辑 .env 文件以填写所需的 API 密钥和其他配置。有关选项的更全面列表，请参阅 .env.full 文件，其中包含所有可用的环境变量及其详细描述。

LLM API 密钥

Youtu-Agent 的核心功能依赖于大型语言模型 (LLM)。你需要为不同的功能模块配置适当的模型。

核心 LLM

这是智能体运行所依赖的主要文本生成 LLM。

# LLM 类型 (例如, chat.completions, responses)
UTU_LLM_TYPE=chat.completions
# LLM 模型名称 (例如, deepseek-chat, gpt-4-turbo)
UTU_LLM_MODEL=deepseek-chat
# LLM 提供商的 API 基础 URL (例如, https://api.deepseek.com/v1)
UTU_LLM_BASE_URL=https://api.deepseek.com/v1
# LLM 提供商的 API 密钥
UTU_LLM_API_KEY=YOUR_API_KEY

视觉和音频 LLM

在使用 ImageToolkit 或 AudioToolkit 时，你需要配置支持多模态功能的 LLM。

Image (Vision) LLM:

# 图像 LLM 类型
UTU_IMAGE_LLM_TYPE=
# 图像 LLM 模型名称 (例如, qwen-vl-plus)
UTU_IMAGE_LLM_MODEL=
# 图像 LLM API 基础 URL
UTU_IMAGE_LLM_BASE_URL=
# 图像 LLM API 密钥
UTU_IMAGE_LLM_API_KEY=

Audio LLM:

# 音频 LLM 模型名称 (例如, whisper-1)
UTU_AUDIO_LLM_MODEL=
# 音频 LLM API 基础 URL
UTU_AUDIO_LLM_BASE_URL=
# 音频 LLM API 密钥
UTU_AUDIO_LLM_API_KEY=

评估 LLM

在运行评估框架 (/utu/eval) 时，需要一个单独的“法官”LLM 来评分和评估智能体的输出。

# 法官 LLM 类型
JUDGE_LLM_TYPE=
# 法官 LLM 模型名称
JUDGE_LLM_MODEL=
# 法官 LLM API 基础 URL
JUDGE_LLM_BASE_URL=
# 法官 LLM API 密钥
JUDGE_LLM_API_KEY=

工具

一些工具包需要它们自己的 API 密钥或特定配置。

搜索工具包 (`SearchToolkit`)

搜索工具包默认集成了以下两个服务：

网络搜索：使用由 Serper 提供的高效 Google 搜索 API。你需要注册并获取 API 密钥。
网页内容提取：使用 Jina AI Reader 将网页内容转换为 LLM 友好的 Markdown 格式。这也需要注册并获取 API 密钥。

在你的 .env 文件中配置它们如下：

# 从 https://serper.dev/ 获取
SERPER_API_KEY=YOUR_SERPER_API_KEY
# 从 https://jina.ai/reader/ 获取
JINA_API_KEY=YOUR_JINA_API_KEY

跟踪与监控

框架集成了 OpenTelemetry 和 Phoenix 来跟踪和监控智能体的执行流程。

# Phoenix/OpenTelemetry 跟踪接收端点
PHOENIX_ENDPOINT=http://127.0.0.1:6006/v1/traces
# Phoenix UI 中显示的项目名称
PHOENIX_PROJECT_NAME=Youtu-Agent

杂项

Hugging Face

用于从 Hugging Face Hub 下载数据集（例如，GAIA）。

# 从 https://huggingface.co/settings/tokens 获取
HF_TOKEN=YOUR_HUGGINGFACE_TOKEN

Web UI

用于配置前端界面的地址和端口。

# 前端服务监听的端口
UTU_WEBUI_PORT=8848
# 前端服务监听的 IP 地址
UTU_WEBUI_IP=127.0.0.1
# 是否为 tornado 服务器启用自动重载
UTU_WEBUI_AUTOLOAD=false