创建提示

在 LangSmith UI 中，导航到左侧边栏或应用主页中的 Playground。

编写提示

Playground 的左侧面板是提示的可编辑视图。

提示由消息组成，每条消息都有一个角色，包括：

• System：“指令手册”。用于定义 AI 的人设、语气和基本规则（例如，“你是一个乐于助人的助手，可以用天气来类比解释事物”）。
• Human：“用户”。代表向 AI 提问或提供指示的人。
• AI：“助手”。这是模型的响应。在 Playground 中，你可以用它提供 “few-shot” 示例——向 AI 精确展示你希望它如何响应。
• Tool / Function：这些角色代表来自外部工具（如计算器或搜索引擎）的输出。它们帮助你测试 AI 在收到特定数据后应如何表现。
• Chat：通用角色，通常用于导入日志或尚未分配特定标签的对话历史。
• Messages List：动态占位符。允许你添加一个包含完整历史消息列表的变量，从而轻松管理长对话历史。

模板格式

默认的模板格式是 f-string，但你可以点击提示框下方的下拉框，将提示模板格式更改为 mustache。

添加模板变量

当你在提示中添加变量时，提示会变得特别有用。你可以使用变量为提示添加动态内容。可以通过以下两种方式之一添加模板变量：

• 在提示中添加 {variable_name}（f-string 每侧一个花括号，mustache 每侧两个）。

  

• 高亮要模板化的文本，然后点击显示的 Convert to variable 提示按钮。输入变量名称并转换。

  

添加变量后，Playground 的右侧面板将出现一个 Input 框，用于输入提示变量的示例输入。在这些框中填入值以测试提示。

INFO

有关提示模板格式的更多详情以及两种语法的示例，请参阅提示模板格式指南。

结构化输出

为提示添加输出模式将以结构化格式获取输出。详细了解结构化输出。

工具

你还可以点击提示编辑器底部的 + Tool 按钮来添加工具。有关如何使用工具的更多信息，请参阅使用工具。

INFO

使用 Playground 中的 Chat 来生成工具、创建输出模式，并在 AI 协助下优化你的提示。

运行提示

要运行提示，请使用

•

Playground 右侧面板顶部的 Start。

设置模型回退

要在提示的主模型失败时使用备用模型，请通过 LLM Gateway 配置每个提示的回退。选择 LangSmith Gateway 作为提供商，并引用以 custom/<my_config_name> 形式保存的模型配置。

保存提示

要保存提示，请点击 Save 按钮并为提示命名。

你在 Playground 设置中选择的模型和配置将随提示一起保存。当你重新打开提示时，模型和配置将自动从已保存的版本加载。

TIP

首次创建公开提示时，系统会要求你设置 LangChain Hub 句柄。你的所有公开提示都将链接到此句柄。在共享工作区中，此句柄将针对整个工作区设置。

查看提示

创建提示后，你可以在左侧边栏的 Prompts 下查看提示表格。

添加元数据

要为提示添加元数据，请点击

•

页面右上角的 More 图标，然后点击下拉菜单中的

•

Update metadata。这会带你进入一个页面，你可以在其中添加关于提示的附加信息，包括描述和 README。

后续步骤

现在你已经创建了提示，可以在应用程序代码中使用它。请参阅如何以编程方式拉取提示。

---