Gmail 工具
Gmail 工具允许您的 Agent 创建和查看来自链接电子邮件帐户的消息。
设置
您可以通过两种方法进行身份验证
- 提供通过 OAuth2 令牌交换获得的访问令牌给凭据对象。这可以是字符串或函数,以便可以处理令牌过期和验证。这可以使用支持从联合连接获取访问令牌的身份提供商来完成。这是最安全的方法,因为访问和范围将仅限于特定的最终用户。当在旨在供最终用户使用其自己的 Gmail 帐户的应用程序中使用该工具时,此方法将更合适。
- 您需要从此处 Google 获取 API 密钥,并在此处启用新的 Gmail API。然后,设置
GMAIL_CLIENT_EMAIL
环境变量,以及GMAIL_PRIVATE_KEY
或GMAIL_KEYFILE
。
要使用 Gmail 工具,您需要安装以下官方对等依赖项
提示
- npm
- Yarn
- pnpm
npm install @langchain/openai @langchain/community @langchain/core googleapis
yarn add @langchain/openai @langchain/community @langchain/core googleapis
pnpm add @langchain/openai @langchain/community @langchain/core googleapis
用法
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,
// // Either (privateKey + clientEmail) or accessToken is required
// accessToken: "an access token or function to get access token",
// },
// scopes: ["https://mail.google.com/"], // Not required if using access token
// };
// 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 hopefulparrot@gmail.com 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