智能体快速入门

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

前提条件

一个 Fetch Hive 工作区
如果你想运行公开的 cURL 示例,需要一个工作区 API 密钥 - 请参阅 API Keys

第 1 步：创建智能体

在侧边栏打开 Agents，然后点击 Add Agent。输入 Name。如果你的工作区使用类别,你还可以选择 Category。点击 Save 打开智能体编辑器。

第 2 步：配置根智能体

在编辑器中,点击根智能体节点打开 Agent Settings。添加一个简短的 Instruction Prompt，告诉智能体要做什么。你也可以确认 Model，但这一次先保留默认设置。例如：

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。

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 流程。

下一步

工作流快速入门概述

⌘I

​智能体快速入门

​前提条件

​第 1 步：创建智能体

​第 2 步：配置根智能体

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

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

​下一步