> ## 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 运行

# 提示词快速入门

在本指南结束时,你将拥有一个在控制台中运行的提示词,以及一个可以从你的应用调用它的公开 cURL 代码片段。

## 前提条件

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

## 第 1 步:创建提示词

在侧边栏打开 **Prompts**，然后点击 **Add Prompt**。

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

## 第 2 步：添加你的第一条消息

在编辑器中,找到 **Prompt** 区块,点击 **Add Message**。

对于最简提示词,添加一条简短指令。例如：

```text theme={null}
You are a helpful assistant. Summarize the user's text in one sentence.
```

如果你希望提示词接受动态输入,请包含像 `{{text}}` 这样的变量。当你的提示词包含变量时,可以点击 **Variables** 打开 **Input Values** 面板,在运行前提供测试值。

## 第 3 步：在编辑器中测试提示词

点击 **Run**。

响应会出现在编辑器右侧的 **Model Response** 区域。使用这一步确认你的提示词在创建提示词部署之前是否按预期工作。

这种编辑器内运行用于控制台测试。它与公开 API 的 invoke 流程不同。

## 第 4 步：保存一个命名版本

点击编辑器顶部的 **Save Version**。

输入对所做更改的简短描述,然后保存版本。这会给你一个可以日后参考的命名检查点。

## 第 5 步：创建部署

点击 **Deploy**，然后选择 **Create a Deployment**。

输入一个 **Deployment key** 并保存。这会创建你可以在控制台之外调用的实时提示词部署。

此处使用 **Deploy** 和 **deployment** 这套说法。在 Fetch Hive 中,这一步使你的提示词作为提示词部署可通过公开 API 调用。

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

在侧边栏打开 **More**，然后点击 **Get Code**。

选择你的 **Deployment** 和 **Variant**。对话框会显示 `POST /v1/prompt/invoke` 的 cURL 代码片段。

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

```bash theme={null}
curl 'https://api.fetchhive.com/v1/prompt/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "deployment": "YOUR_DEPLOYMENT_NAME",
    "variant": "YOUR_VARIANT_NAME",
    "inputs": {
      "text": "Fetch Hive helps teams ship AI products faster."
    },
    "streaming": true
  }' \
  --compressed
```

将 `YOUR_API_KEY`、`YOUR_DEPLOYMENT_NAME`、`YOUR_VARIANT_NAME` 和 `inputs` 对象替换为你的真实值。

## 下一步

* [提示词](../prompts/overview)
* [发布与版本管理](../prompts/publishing-and-versioning)
* [通过 API 运行](../prompts/run-with-api)