Connery 操作工具

使用此工具，您可以将单个 Connery 操作集成到 LangChain 代理中。

注意

如果您想在您的代理中使用多个 Connery 操作，请查看 Connery 工具包 文档。

什么是 Connery？

Connery 是一个面向 AI 的开源插件基础设施。

借助 Connery，您可以轻松地使用一组操作创建自定义插件，并将其无缝集成到您的 LangChain 代理中。Connery 将处理运行时、授权、密钥管理、访问管理、审计日志和其他重要功能等关键方面。

此外，Connery 在我们社区的支持下，提供各种现成的开源插件，以提高便利性。

详细了解 Connery

• GitHub：https://github.com/connery-io/connery
• 文档：https://docs.connery.io

先决条件

要在 LangChain 代理中使用 Connery 操作，您需要进行一些准备工作。

1. 使用 快速入门 指南设置 Connery 运行器。
2. 安装您想在代理中使用的所有带有操作的插件。
3. 设置环境变量 CONNERY_RUNNER_URL 和 CONNERY_RUNNER_API_KEY，以便工具包可以与 Connery Runner 通信。

使用 Connery 操作工具的示例

设置

要使用 Connery 操作工具，您需要安装以下官方对等依赖项。

npm

npm install @langchain/community @langchain/core

Yarn

yarn add @langchain/community @langchain/core

pnpm

pnpm add @langchain/community @langchain/core

提示

查看 此部分以获取有关安装集成包的一般说明。

用法

在下面的示例中，我们通过其 ID 从 Connery 运行器中获取操作，然后使用指定的参数调用它。

在这里，我们使用 Gmail 插件中的 发送电子邮件 操作的 ID。

信息

您可以查看此示例的 LangSmith 追踪 此处。

import { ConneryService } from "@langchain/community/tools/connery";
import { ChatOpenAI } from "@langchain/openai";
import { initializeAgentExecutorWithOptions } from "langchain/agents";

// Specify your Connery Runner credentials.
process.env.CONNERY_RUNNER_URL = "";
process.env.CONNERY_RUNNER_API_KEY = "";

// Specify OpenAI API key.
process.env.OPENAI_API_KEY = "";

// Specify your email address to receive the emails from examples below.
const recepientEmail = "[email protected]";

// Get the SendEmail action from the Connery Runner by ID.
const conneryService = new ConneryService();
const sendEmailAction = await conneryService.getAction(
  "CABC80BB79C15067CA983495324AE709"
);

// Run the action manually.
const manualRunResult = await sendEmailAction.invoke({
  recipient: recepientEmail,
  subject: "Test email",
  body: "This is a test email sent by Connery.",
});
console.log(manualRunResult);

// Run the action using the OpenAI Functions agent.
const llm = new ChatOpenAI({ temperature: 0 });
const agent = await initializeAgentExecutorWithOptions([sendEmailAction], llm, {
  agentType: "openai-functions",
  verbose: true,
});
const agentRunResult = await agent.invoke({
  input: `Send an email to the ${recepientEmail} and say that I will be late for the meeting.`,
});
console.log(agentRunResult);

API 参考

• ConneryService 来自 @langchain/community/tools/connery
• ChatOpenAI 来自 @langchain/openai
• initializeAgentExecutorWithOptions 来自 langchain/agents

注意

Connery 操作是一种结构化工具，因此您只能在支持结构化工具的代理中使用它。

相关

• 工具 概念指南
• 工具 操作指南