快速开始

本教程介绍如何配置模型并运行一个最小可用的智能体，最终在终端获得模型的回答。

开始前请先完成安装，并准备好火山方舟 API Key。本章仅覆盖首次运行的最小路径；工具、记忆、知识库与前端能力请参见对应组件文档。

配置模型

配置调用模型所需的凭证，以下两种方式二选一。最简单的方式是设置环境变量，仅需提供 API Key。

环境变量
配置文件

设置 API Key 后，VeADK 默认使用火山方舟上的豆包模型：

export MODEL_AGENT_API_KEY="填入火山方舟 API Key"

如需指定其它模型，可另外设置 MODEL_AGENT_NAME、MODEL_AGENT_PROVIDER、MODEL_AGENT_API_BASE。

在项目根目录创建 config.yaml，VeADK 会自动读取：

config.yaml

model:
  agent:
    provider: openai
    name: doubao-seed-2-1-pro-260628
    api_base: https://ark.cn-beijing.volces.com/api/v3/
    api_key: # 填入火山方舟 API Key

provider: openai 表示采用 OpenAI 兼容协议，api_base 指向火山方舟的兼容接口，因此可直接使用豆包等方舟模型。

编写第一个智能体

创建 main.py：

main.py

from veadk import Agent
import asyncio

agent = Agent()

res = asyncio.run(agent.run("用一句话介绍火山引擎。"))
print(res)

Agent 持有模型与指令，不传参数时使用 config.yaml 中的默认模型；agent.run(...) 为异步方法，返回最终的文本回答。

运行

python main.py

终端将打印模型返回的回答。至此，一个最小 VeADK 智能体已完成运行。

概览

核心组件

可观测

扩展

前端

安全

部署

快速开始

配置模型

编写第一个智能体

运行

​配置模型

​编写第一个智能体

​运行

配置模型

编写第一个智能体

运行