以编程方式使用文档

工具允许语言模型与外部系统交互并执行超越生成文本的操作。在 Playground 中，你可以使用两种类型的工具：

  1. **内置工具**：由模型提供商（如 OpenAI 和 Anthropic）提供的预配置工具，可直接使用。当需要网络搜索或代码解释等常见功能时，请使用内置工具。
  2. **自定义工具**：你定义的用于执行特定任务的函数。当需要与自己的系统集成或创建专门功能时，这些工具非常有用。当你在 Playground 中定义自定义工具时，你可以验证模型是否正确识别并使用正确的参数调用这些工具。

LangSmith 会自动将你创建的工具保存到工作区范围的 工具注册表，这使得它们可以在所有提示词和会话中重复使用。

内置工具

Playground 原生支持来自 OpenAI 和 Anthropic 的多种工具。如果你想要使用的工具未在 Playground 中明确列出，你仍可以通过手动指定其 type 及任何必需的参数来添加它。

OpenAI 工具

Anthropic 工具

添加和使用工具

Playground 让你可以快速 添加工具 到任何提示词，只需单击一次即可。你可以选择模型提供商（如 OpenAI 和 Anthropic）提供的内置工具，也可以定义自己的 自定义工具 来满足你的特定需求。创建自定义工具后，它会自动添加到工作区范围的 工具注册表 中，你可以在不同的提示词中启用、禁用或编辑它，而无需重新创建。

添加工具

要向提示词添加工具，请点击提示词编辑器底部的 **+ 工具** 按钮。

带有 + 工具按钮的提示词界面，位于编辑框之后。 带有 + 工具按钮的提示词界面，位于编辑框之后。

使用内置工具

  1. 在工具部分，选择你要使用的内置工具。你只会看到与你选择的提供商和模型兼容的工具。
  2. 当模型调用工具时，Playground 会显示响应。

!网络搜索工具

创建自定义工具

要创建自定义工具，您需要提供：

  • 名称：工具的描述性名称。
  • 描述：对工具功能的清晰说明。
  • 参数：工具所需的输入。

!自定义工具

在 Playground 中运行自定义工具时，模型将返回一个包含工具名称和工具调用的 JSON 对象。

!工具调用

使用注册表管理工具

Playground 包含一个 工作区-scoped **工具注册表** 它可以跨提示和会话持久保存自定义工具和内置工具。当您创建自定义工具或添加内置工具时，它会自动保存到您的工作区注册表中，并可在任何提示中重复使用。您可以为每个提示启用或禁用工具，以控制每个特定提示的活动工具，编辑共享工具时，您可以选择更新注册表版本或另存为新工具。

点击 **+ 工具** Playground 中的按钮以打开 **管理工具**。您可以执行以下操作：

  • - 选择并查看 **可用工具** tab.
  • - Toggle individual tools on/off using the **已启用** switch.
  • - 点击列表中的工具即可编辑现有工具。
  • - 使用 **删除** 底部的 **管理工具**.
管理工具，包含可用工具列表、启用开关和编辑功能。 管理工具，包含可用工具列表、启用开关和编辑功能。

工具以其完整配置存储，包括名称、描述、参数和元数据。注册表支持自定义函数工具和内置工具配置。

工具选择设置

某些模型提供对调用哪些工具的控制。配置方法如下：

  1. 选择 **+ 工具** 在提示词编辑器下方。
  2. 导航到 **工具选择设置** tab.
  3. 选择您的工具选择方式。

要了解可用的工具选择选项，请查阅您的特定提供商的文档。例如， OpenAI 关于工具选择的文档.

从工具选择设置标签页选择工具。 从工具选择设置选项卡中选择工具。