---
title: 首次设置
summary: 添加一个 LLM 提供商并创建你的第一个智能体：从安装好 HeartBeatAgents 到真正运行起来之间的两个步骤。
date: 2026-09-03
---

# 首次设置

添加一个 LLM 提供商并创建你的第一个智能体：从安装好 HeartBeatAgents 到真正运行起来之间的两个步骤。

安装好 HeartBeatAgents 后（参见[安装](/zh/docs/getting-started/installation)），在拥有一个可用的智能体之前还需要完成两件事：连接一个语言模型提供商，并创建智能体本身。

## 1. 添加一个 LLM 提供商

智能体需要一个语言模型来进行思考。前往**设置 → 提供商**，至少添加一个。HeartBeatAgents 支持 Anthropic、OpenAI、Google、DeepSeek、Mistral、Groq、xAI、OpenRouter、Qwen、Moonshot AI、Ollama（本地）以及自定义端点。

添加提供商需要该平台的 API 密钥。例如，添加 OpenAI 的步骤如下：

```
1. 前往 platform.openai.com/api-keys
2. 创建一个新的 API 密钥
3. 复制该密钥
4. 在 HeartBeatAgents 中点击“添加提供商”
5. 选择“OpenAI”并粘贴你的密钥
6. 点击“验证并保存”
```

系统会通过一次测试调用验证你的密钥。验证通过后，该提供商即可供任意智能体使用。你可以添加多个提供商，管理多个提供商的方法请参见[配置](/zh/docs/getting-started/configuration)。

## 2. 创建你的第一个智能体

前往**智能体 → 创建智能体**，需要填写以下信息：

- **名称：** 一个展示名称（例如“客服智能体”或“Aria”）。
- **描述：** 简要说明该智能体的用途。
- **主要提供商：** 该智能体默认使用的 LLM 提供商。
- **模型：** 来自该提供商的具体模型（例如“claude-sonnet-5”或“gpt-4o”）。
- **常驻指令：** 定义该智能体角色、性格与边界的系统提示词。

一个可用于起步的最小化常驻指令示例：

```
你是 [你的公司] 的智能助手。
你友好、简洁、专业。
如果不知道某个问题的答案，请诚实地说明。
绝不编造信息。
```

点击**“创建智能体”**，它就会立即上线。

## 下一步

前往[快速开始](/zh/docs/getting-started/quick-start)，真正与它对话。
