> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 智能体快速入门

> 创建智能体、在聊天中测试,并通过公开 API 调用它

# 智能体快速入门

在本指南结束时,你将拥有一个在控制台中配置好、在聊天中测试通过、并可通过公开 API 调用的智能体。

## 前提条件

* 一个 Fetch Hive 工作区
* 如果你想运行公开的 cURL 示例,需要一个工作区 API 密钥 - 请参阅 [API Keys](../workspace/api-keys)

## 第 1 步：创建智能体

在侧边栏打开 **Agents**，然后点击 **Add Agent**。

输入 **Name**。如果你的工作区使用类别,你还可以选择 **Category**。点击 **Save** 打开智能体编辑器。

## 第 2 步：配置根智能体

在编辑器中,点击根智能体节点打开 **Agent Settings**。

添加一个简短的 **Instruction Prompt**，告诉智能体要做什么。你也可以确认 **Model**，但这一次先保留默认设置。

例如：

```text theme={null}
You are a research assistant. Answer clearly and keep responses brief unless the user asks for more detail.
```

## 第 3 步：在聊天中测试智能体

点击编辑器顶部的 **Chat**。

在聊天面板发送一条简短的测试消息,确认智能体按你预期的方式响应。

此聊天面板用于控制台测试。UI 中明确说明这些消息不会被保存,因此可以将其视为在把智能体接入你的应用之前安全地迭代行为的地方。

## 第 4 步：复制公开 invoke 代码片段

在编辑器顶部打开 **Code Snippet**，或在侧边栏使用 **More** 并点击 **Get Code**。

选择你的 **Agent** 和 **API Key**。对话框会显示 `POST /v1/agent/invoke` 的公开 cURL 示例。

对话框在此处提供 cURL 代码片段。**Python** 和 **TypeScript** 标签仍标注为 **Coming Soon**。

```bash theme={null}
curl 'https://api.fetchhive.com/v1/agent/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "agent": "YOUR_AGENT_ID",
    "message": "Summarize the latest AI infrastructure trends",
    "streaming": true
  }' \
  --compressed
```

将 `YOUR_API_KEY` 和 `YOUR_AGENT_ID` 替换为你的真实值。

应用内的 **Chat** 面板使用的是私有的控制台测试流程。上面的代码片段是你在控制台之外使用的公开 API 流程。

## 下一步

* [智能体](../agents/overview)
* [创建与配置](../agents/creating-and-configuring)
* [使用聊天进行测试](../agents/testing-with-chat)