Gmail 工具

Gmail 工具允许您的代理从链接的电子邮件帐户创建和查看邮件。

设置

您需要从 此处获取 Google 的 API 密钥 并 启用新的 Gmail API。然后，设置 GMAIL_CLIENT_EMAIL 的环境变量，以及 GMAIL_PRIVATE_KEY 或 GMAIL_KEYFILE。

要使用 Gmail 工具，您需要安装以下官方对等依赖项

提示

查看 此部分以获取有关安装集成软件包的常规说明。

npm

npm install @langchain/openai googleapis @langchain/community

Yarn

yarn add @langchain/openai googleapis @langchain/community

pnpm

pnpm add @langchain/openai googleapis @langchain/community

用法

import { initializeAgentExecutorWithOptions } from "langchain/agents";
import { OpenAI } from "@langchain/openai";
import {
  GmailCreateDraft,
  GmailGetMessage,
  GmailGetThread,
  GmailSearch,
  GmailSendMessage,
} from "@langchain/community/tools/gmail";
import { StructuredTool } from "@langchain/core/tools";

export async function run() {
  const model = new OpenAI({
    temperature: 0,
    apiKey: process.env.OPENAI_API_KEY,
  });

  // These are the default parameters for the Gmail tools
  //   const gmailParams = {
  //     credentials: {
  //       clientEmail: process.env.GMAIL_CLIENT_EMAIL,
  //       privateKey: process.env.GMAIL_PRIVATE_KEY,
  //     },
  //     scopes: ["https://mail.google.com/"],
  //   };

  // For custom parameters, uncomment the code above, replace the values with your own, and pass it to the tools below
  const tools: StructuredTool[] = [
    new GmailCreateDraft(),
    new GmailGetMessage(),
    new GmailGetThread(),
    new GmailSearch(),
    new GmailSendMessage(),
  ];

  const gmailAgent = await initializeAgentExecutorWithOptions(tools, model, {
    agentType: "structured-chat-zero-shot-react-description",
    verbose: true,
  });

  const createInput = `Create a gmail draft for me to edit of a letter from the perspective of a sentient parrot who is looking to collaborate on some research with her estranged friend, a cat. Under no circumstances may you send the message, however.`;

  const createResult = await gmailAgent.invoke({ input: createInput });
  //   Create Result {
  //     output: 'I have created a draft email for you to edit. The draft Id is r5681294731961864018.'
  //   }
  console.log("Create Result", createResult);

  const viewInput = `Could you search in my drafts for the latest email?`;

  const viewResult = await gmailAgent.invoke({ input: viewInput });
  //   View Result {
  //     output: "The latest email in your drafts is from [email protected] with the subject 'Collaboration Opportunity'. The body of the email reads: 'Dear [Friend], I hope this letter finds you well. I am writing to you in the hopes of rekindling our friendship and to discuss the possibility of collaborating on some research together. I know that we have had our differences in the past, but I believe that we can put them aside and work together for the greater good. I look forward to hearing from you. Sincerely, [Parrot]'"
  //   }
  console.log("View Result", viewResult);
}

API 参考

• initializeAgentExecutorWithOptions 来自 langchain/agents
• OpenAI 来自 @langchain/openai
• GmailCreateDraft 来自 @langchain/community/tools/gmail
• GmailGetMessage 来自 @langchain/community/tools/gmail
• GmailGetThread 来自 @langchain/community/tools/gmail
• GmailSearch 来自 @langchain/community/tools/gmail
• GmailSendMessage 来自 @langchain/community/tools/gmail
• StructuredTool 来自 @langchain/core/tools

相关

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