Skip to main content

概述

Exa 是一个搜索引擎,能够根据输入查询从网络检索相关内容。 本指南将帮助您开始使用 ExaRetriever 检索器。有关 ExaRetriever 所有功能和配置的详细文档,请参阅 API 参考

集成详情

检索器来源
ExaRetriever网络信息。@langchain/exa

设置

您需要将 API 密钥设置为环境变量。 Exa 类在查找 API 密钥时默认使用 EXASEARCH_API_KEY
process.env.EXASEARCH_API_KEY="<您的 API 密钥>";
如果您希望从单个查询中获得自动跟踪,还可以通过取消注释以下内容来设置 LangSmith API 密钥:
// process.env.LANGSMITH_API_KEY = "<您的 API 密钥>";
// process.env.LANGSMITH_TRACING = "true";

安装

此检索器位于 @langchain/exa 包中:
npm install @langchain/exa @langchain/core

实例化

现在我们可以实例化检索器:
import { ExaRetriever } from "@langchain/exa";
import Exa from "exa-js";

const retriever = new ExaRetriever({
  // @lc-ts-ignore
  client: new Exa(
    process.env.EXASEARCH_API_KEY // 默认 API 密钥
  ),
  searchArgs: {
    numResults: 2,
  }
});

使用

const query = "发言人在 2022 年国情咨文中关于布雷耶大法官说了什么?";

await retriever.invoke(query);
[
  Document {
    pageContent: '拜登总统的国情咨文演讲\n' +
      '议长女士、副总统女士、第一夫人和第二先生、国会议员和内阁成员、最高法院大法官们、我的美国同胞们:去年,COVID-19 使我们分离。今年,我们终于再次相聚。\n' +
      '今晚——今晚我们以民主党人、共和党人和独立人士的身份相聚,但最重要的是,作为美国人,我们彼此负有责任,对美国、对美国人民、对宪法负有责任,并坚定不移地决心让自由永远战胜暴政。\n' +
      '六——谢谢。六天前,俄罗斯的弗拉基米尔·普京试图动摇自由世界的根基,以为他可以让世界屈服于他的威胁方式。但他严重误判了。他以为可以长驱直入乌克兰,而世界会袖手旁观。相反,他遇到了他从未预料或想象到的力量之墙。他遇到了乌克兰人民。\n' +
      '从泽连斯基总统到每一位乌克兰人,他们的无畏、勇气和决心真正激励了世界。公民们用身体阻挡坦克。从学生到退休人员,再到转变为士兵的教师,每个人都在保卫他们的家园。\n' +
      '在这场斗争中——泽连斯基总统在欧洲议会的演讲中说:“光明将战胜黑暗。”\n' +
      '乌克兰驻美国大使今晚在这里,与第一夫人坐在一起。让我们每个人,如果能够站立,请站起来,向世界和乌克兰发出一个明确的信号。谢谢。谢谢,谢谢,谢谢。\n' +
      '她明亮、坚强且坚定。\n' +
      '是的。我们,美利坚合众国,与乌克兰人民站在一起。\n' +
      '纵观我们的历史,我们学到了这个教训:当独裁者不为他们的侵略付出代价时,他们会造成更多的混乱;他们会继续前进;而代价、对美国和世界的威胁会不断上升。\n' +
      '这就是北约联盟成立的原因:为了在二战后确保欧洲的和平与稳定。\n' +
      '美国是成员国,还有其他 29 个国家。这很重要。美国的外交很重要。美国的决心很重要。\n' +
      '普京对乌克兰的最新攻击是有预谋且完全无端的。他拒绝了反复的外交努力。\n' +
      '他以为西方和北约不会回应。他以为可以在国内、在这个议院、在这个国家分裂我们。他以为也可以在欧洲分裂我们。\n' +
      '但普京错了。我们准备好了。我们团结一致。这就是我们所做的:我们保持团结。\n' +
      '我们进行了广泛而细致的准备。我们花了数月时间在欧洲和美洲建立其他热爱自由的国家的联盟——从美国到亚洲和非洲大陆,以对抗普京。\n' +
      '像你们中的许多人一样,我花了无数时间团结我们的欧洲盟友。\n' +
      '我们提前与世界分享了我们知道普京在计划什么,以及他将如何试图错误地为其侵略行为辩护。\n' +
      '我们用真相反击俄罗斯的谎言。而现在——现在他已经行动,自由世界正在追究他的责任,连同欧盟的 27 个成员国——包括法国、德国、意大利——以及英国、加拿大、日本、韩国、澳大利亚、新西兰等许多其他国家。甚至瑞士也在对俄罗斯施加痛苦并支持乌克兰人民。\n' +
      '普京现在比以往任何时候都更加孤立于世界。\n' +
      '一起。一起。一起,与我们的盟友一起,我们现在正在实施强有力的经济制裁。我们正在将俄罗斯最大的银行从国际金融体系中切断;阻止俄罗斯中央银行捍卫俄罗斯卢布,使普京的 6300 亿美元战争基金变得一文不值。我们正在扼杀俄罗斯获取技术的途径,这将削弱其经济实力并削弱其军事力量多年。\n' +
      '今晚,我对俄罗斯寡头和从这个暴力政权中榨取数十亿美元的腐败领导人们说:到此为止。\n' +
      '美国——我是认真的。美国司法部正在组建一个专门的工作组来追究俄罗斯寡头的罪行。\n' +
      '我们正与欧洲盟友合作,寻找并没收他们的游艇、豪华公寓和私人飞机。我们要追回你们的不义之财。\n' +
      '今晚,我宣布我们将与盟友一起对美国领空对所有俄罗斯航班关闭,进一步孤立俄罗斯并对其经济施加额外压力。\n' +
      '他不知道即将发生什么。\n' +
      '卢布已经贬值 30%,俄罗斯股市已经损失 40% 的价值,交易仍然暂停。\n' +
      '俄罗斯经济正在衰退,而普京是唯一该受责备的人。\n' +
      '与我们的盟友一起,我们正在为乌克兰人民的自由斗争提供支持:军事援助、经济援助、人道主义援助。我们向乌克兰提供超过 10 亿美元的直接援助。我们将继续帮助乌克兰人民保卫他们的国家并缓解他们的痛苦。\n' +
      '但让我明确一点:我们的部队没有参与,也不会参与与乌克兰境内俄罗斯部队的冲突。我们的部队不是去欧洲在乌克兰作战,而是为了在普京决定继续西进时保卫我们的北约盟友。\n' +
      '为此,我们已经动员了美国地面部队、空军中队和舰船部署,以保护北约国家,包括波兰、罗马尼亚、拉脱维亚、立陶宛和爱沙尼亚。\n' +
      '正如我已经明确表示的,美国和我们的盟友将用我们集体力量的全部力量保卫北约领土的每一寸——每一寸。\n' +
      '我们头脑清醒。乌克兰人民正在以纯粹的勇气反击。但接下来的几天、几周和几个月对他们来说将是艰难的。\n' +
      '普京已经释放了暴力和混乱。但尽管他可能在战场上取得进展,他将在长期付出持续的高昂代价。\n' +
      '而乌克兰人民——自豪的人民——每一磅都准备好用他们拥有的每一寸(听不清)战斗。他们经历了 30 年的独立——一再表明他们不会容忍任何试图让他们的国家倒退的人。\n' +
      '致所有美国人,我会对你们诚实,正如我一直承诺的那样。一个俄罗斯独裁者入侵外国国家在世界各地都有代价。我正在采取强有力的行动,确保我们制裁的痛苦针对俄罗斯经济,并且我们利用我们掌握的一切工具来保护美国企业和消费者。\n' +
      '今晚,我可以宣布美国已经与 30 个国家合作,从世界各地的储备中释放 6000 万桶石油。美国将领导这项努力,释放我们自己战略石油储备中的 3000 万桶。如果需要,我们准备做得更多,与我们的盟友团结一致。\n' +
      '这些措施将有助于抑制国内的汽油价格。但我知道,关于正在发生的事情的新闻可能让所有美国人感到担忧。但我想让你们知道:我们会没事的。我们会没事的。\n' +
      '当这个时代的历史被书写时,普京对乌克兰的战争将使俄罗斯更弱,而世界其他国家更强大。\n' +
      '虽然不应该,虽然不应该需要如此可怕的事情让世界各地的人们看到利害关系,但现在每个人都清楚地看到了。\n' +
      '我们看到各国领导人之间的团结,一个更加统一的欧洲,一个更加统一的西方。\n' +
      '我们看到人民之间的团结,他们在世界各地的城市聚集,甚至在俄罗斯,以展示他们对乌克兰人民的支持。\n' +
      '在民主与专制之间的斗争中,民主正在挺身而出,世界显然选择了和平与安全的一边。\n' +
      '这是真正的考验,而且需要时间。所以,让我们继续从乌克兰人民的钢铁意志中汲取灵感。\n' +
      '致我们连接我们两个国家的深厚纽带的乌克兰裔美国同胞:我们与你们站在一起。我们与你们站在一起。\n' +
      '普京可能用坦克包围基辅,但他永远不会赢得乌克兰人民的心和灵魂。他永远不会——他永远不会熄灭他们对自由的热爱。他也永远不会,永远不会削弱自由世界的决心。\n' +
      '我们今晚相聚在一个经历了这个国家有史以来最艰难的两年中的美国。疫情一直很严酷。如此多的家庭靠薪水度日,努力跟上食品、汽油、住房等不断上涨的成本。\n' +
      '我理解,就像你们中的许多人一样。我父亲不得不离开他在宾夕法尼亚州斯克兰顿的家去找工作。所以,像你们中的许多人一样,我成长在一个家庭中,当食品价格上涨时,整个家庭都能感受到;它产生了影响。\n' +
      '这就是为什么我作为总统做的第一件事就是努力通过《美国救援计划》,因为人们正在受苦。我们需要行动,我们做到了。\n' +
      '《美国救援计划》 \n' +
      '很少有立法在我们历史上的关键时刻做了更多的工作来使我们摆脱危机。它推动了我们为全国接种疫苗和抗击 COVID-19 的努力。它为数千万美国人提供了直接的经济救济。它帮助将食物摆上餐桌。还记得那些排着长队等待数小时只为把一箱食物放进后备箱的汽车吗?它降低了医疗保险的成本。正如我父亲常说的,它给了人们“一点点喘息的空间”。\n' +
      '与上一届政府通过的使美国前 1% 人群受益的 2 万亿美元减税不同,《美国救援计划》帮助了劳动人民,没有让任何人掉队。而且,各位——它奏效了。它奏效了。\n' +
      '它奏效了并创造了就业机会——很多就业机会。事实上,我们的经济仅在去年就创造了超过 650 万个新工作岗位,比美国历史上任何一年都多。\n' +
      '经济进展报告 \n' +
      '去年经济增长率为 5.7——最强劲的增长'... 还有 35166 个字符,
    metadata: {
      score: 0.16303963959217072,
      title: '2022 年国情咨文 | 白宫',
      id: 'https://www.whitehouse.gov/state-of-the-union-2022/',
      url: 'https://www.whitehouse.gov/state-of-the-union-2022/',
      publishedDate: '2022-02-25',
      author: ''
    },
    id: undefined
  },
  Document {
    pageContent: "总统:非常感谢大家。谢谢,请。非常感谢。议长女士、副总统女士、第一夫人和第二先生、国会议员和内阁成员、最高法院大法官们、我的美国同胞们:去年,COVID-19 使我们分离。今年,我们终于再次相聚。\n" +
      '今晚我们以民主党人、共和党人和独立人士的身份相聚,但最重要的是,作为美国人,我们彼此负有责任,对美国、对美国人民、对宪法负有责任,并坚定不移地决心让自由永远战胜暴政。\n' +
      "六——[掌声]——谢谢。六天前,俄罗斯的弗拉基米尔·普京试图动摇自由世界的根基,以为他可以让世界屈服于他的威胁方式。但他严重误判了。他以为可以长驱直入乌克兰,而世界会袖手旁观。相反,他遇到了他从未预料或想象到的力量之墙。他遇到了乌克兰人民。\n" +
      '从泽连斯基总统,他们的——到每一位乌克兰人,他们的无畏、勇气和决心真正激励了世界。公民们用身体阻挡坦克。从学生到退休人员,再到转变为士兵的教师,每个人都在保卫他们的家园。在这场斗争中——泽连斯基总统在欧洲议会的演讲中说:“光明将战胜黑暗。”\n' +
      "乌克兰驻美国大使今晚在这里,与第一夫人坐在一起。让我们每个人,如果能够站立,请站起来,向世界和乌克兰发出一个明确的信号。谢谢。谢谢,谢谢,谢谢。她明亮、坚强且坚定。是的。我们,美利坚合众国,与乌克兰人民站在一起。\n" +
      "纵观我们的历史,我们学到了这个教训:当独裁者不为他们的侵略付出代价时,他们会造成更多的混乱;他们会继续前进;而代价、对美国和世界的威胁会不断上升。这就是北约联盟成立的原因:为了在二战后确保欧洲的和平与稳定。美国是成员国,还有其他 29 个国家。这很重要。美国的外交很重要。美国的决心很重要。\n" +
      "普京对乌克兰的最新攻击是有预谋且完全无端的。他拒绝了反复——反复——的外交努力。他以为西方和北约不会回应。他以为可以在国内、在这个议院、在这个国家分裂我们。他以为也可以在欧洲分裂我们。\n" +
      "但普京错了。我们准备好了。我们团结一致。这就是我们所做的:我们保持团结。我们进行了广泛而细致的准备。我们花了数月时间在欧洲和美洲建立其他热爱自由的国家的联盟——从美国到亚洲和非洲大陆,以对抗普京。\n" +
      "像你们中的许多人一样,我花了无数时间团结我们的欧洲盟友。我们提前与世界分享了我们知道普京在计划什么,以及他将如何试图伪造和为其侵略行为辩护。我们用真相反击俄罗斯的谎言。而现在——现在他已经行动,自由世界正在追究他的责任,连同欧盟的 27 个成员国——包括法国、德国、意大利——以及英国、加拿大、日本、韩国、澳大利亚、新西兰等许多其他国家——甚至瑞士——也在对俄罗斯施加痛苦并支持乌克兰人民。普京现在比以往任何时候都更加孤立于世界。\n" +
      "一起,与我们的盟友一起,我们现在正在实施强有力的经济制裁。我们正在将俄罗斯最大的银行从国际金融体系中切断;阻止俄罗斯中央银行捍卫俄罗斯卢布,使普京的 6300 亿美元战争基金变得一文不值。我们正在扼杀俄罗斯获取技术的途径,这将削弱其经济实力并削弱其军事力量多年。\n" +
      '今晚我对俄罗斯寡头和从这个暴力政权中榨取数十亿美元的腐败领导人们说:到此为止。美国——[掌声]——我是认真的。美国司法部正在组建一个专门的工作组来追究俄罗斯寡头的罪行。\n' +
      "我们正与欧洲盟友合作,寻找并没收他们的游艇、豪华公寓和私人飞机。我们要追回你们的不义之财。今晚我宣布我们将与盟友一起对美国领空对所有俄罗斯航班关闭,进一步孤立俄罗斯并对其经济施加额外压力。\n" +
      "他不知道即将发生什么。卢布已经贬值 30%,俄罗斯股市已经损失 40% 的价值,交易仍然暂停。俄罗斯经济正在衰退,而普京是唯一该受责备的人。\n" +
      "与我们的盟友一起,我们正在为乌克兰人民的自由斗争提供支持:军事援助、经济援助、人道主义援助。我们向乌克兰提供超过 10 亿美元的直接援助。我们将继续帮助乌克兰人民保卫他们的国家并缓解他们的痛苦。\n" +
      "但让我明确一点:我们的部队没有参与,也不会参与与乌克兰境内俄罗斯部队的冲突。我们的部队不是去欧洲在乌克兰作战,而是为了在普京决定继续西进时保卫我们的北约盟友。为此,我们已经动员了美国地面部队、空军中队和舰船部署,以保护北约国家,包括波兰、罗马尼亚、拉脱维亚、立陶宛和爱沙尼亚。正如我已经明确表示的,美国和我们的盟友将用我们集体力量的全部力量保卫北约领土的每一寸——每一寸。\n" +
      "我们头脑清醒。乌克兰人民正在以纯粹的勇气反击。但接下来的几天、几周和几个月对他们来说将是艰难的。普京已经释放了暴力和混乱。但尽管他可能在战场上取得进展,他将在长期付出持续的高昂代价。而乌克兰人民——自豪的人民——每一磅都准备好用他们拥有的每一寸能量战斗。他们经历了 30 年的独立——一再表明他们不会容忍任何试图让他们的国家倒退的人。\n" +
      "致所有美国人,我会对你们诚实,正如我一直承诺的那样。一个俄罗斯独裁者入侵外国国家在世界各地都有代价。我正在采取强有力的行动,确保我们制裁的痛苦针对俄罗斯经济,并且我们利用我们掌握的一切工具来保护美国企业和消费者。\n" +
      '今晚我可以宣布美国已经与 30 个国家合作,从世界各地的储备中释放 6000 万桶石油。美国将领导这项努力,释放我们自己战略石油储备中的 3000 万桶。如果需要,我们准备做得更多,与我们的盟友团结一致。\n' +
      "这些措施将有助于抑制国内的汽油价格。但我知道,关于正在发生的事情的新闻可能让所有美国人感到担忧。但我想让你们知道:我们会没事的。我们会没事的。\n" +
      "当这个时代的历史被书写时,普京对乌克兰的战争将使俄罗斯更弱,而世界其他国家更强大。\n" +
      "虽然不应该需要如此可怕的事情让世界各地的人们看到利害关系,但现在每个人都清楚地看到了。我们看到各国领导人之间的团结,一个更加统一的欧洲,一个更加统一的西方。我们看到人民之间的团结,他们在世界各地的城市聚集,甚至在俄罗斯,以展示他们对乌克兰人民的支持。\n" +
      "在民主与专制之间的斗争中,民主正在挺身而出,世界显然选择了和平与安全的一边。这是真正的考验,而且需要时间。所以,让我们继续从乌克兰人民的钢铁意志中汲取灵感。\n" +
      "致我们连接我们两个国家的深厚纽带的乌克兰裔美国同胞:我们与你们站在一起。我们与你们站在一起。普京可能用坦克包围基辅,但他永远不会赢得乌克兰人民的心和灵魂。他永远不会熄灭他们对自由的热爱。他也永远不会,永远不会削弱自由世界的决心。\n" +
      '我们今晚相聚在一个经历了这个国家有史以来最艰难的两年中的美国。疫情一直很严酷。如此多的家庭靠薪水度日,努力跟上食品、汽油、住房等不断上涨的成本。\n' +
      "我理解,就像你们中的许多人一样。我父亲不得不离开他在宾夕法尼亚州斯克兰顿的家去找工作。所以,像你们中的许多人一样,我成长在一个家庭中,当食品价格上涨时,整个家庭都能感受到;它产生了影响。这就是为什么我作为总统做的第一件事就是努力通过《美国救援计划》,因为人们正在受苦。我们需要行动,我们做到了。\n" +
      '很少有立法在我们历史上的关键时刻做了更多的工作来使我们摆脱危机。它推动了我们为全国接种疫苗和抗击 COVID-19 的努力。它为数千万美国人提供了直接的经济救济。它帮助将食物摆上餐桌。还记得那些排着长队等待数小时只为把一箱食物放进后备箱的汽车吗?它降低了医疗保险的成本。正如我父亲常说的,它给了人们“一点点喘息的空间”。\n' +
      '与上一届政府通过的使美国前 1% 人群受益的 2 万亿美元减税不同,《美国救援计划》——\n' +
      ' 观众成员:嘘!\n' +
      ' 总统: ——《美国救援计划》帮助了劳动人民,没有让任何人掉队。而且,各位——它奏效了。它奏效了。它奏效了并创造了就业机会,很多就业机会。事实上,我们的经济仅在去年就创造了超过 650 万个新工作岗位,比美国历史上任何一年都多。去年经济增长率为 5.7,是 40 年来最强劲的增长率,也是第一步'... 还有 35254 个字符,
    metadata: {
      score: 0.16301880776882172,
      title: '在国会联席会议上的国情咨文演讲',
      id: 'https://www.presidency.ucsb.edu/documents/address-before-joint-session-the-congress-the-state-the-union-28',
      url: 'https://www.presidency.ucsb.edu/documents/address-before-joint-session-the-congress-the-state-the-union-28',
      publishedDate: '2022-03-01',
      author: ''
    },
    id: undefined
  }
]

API 参考

有关 ExaRetriever 所有功能和配置的详细文档,请参阅 API 参考