跳到主要内容

Mixedbread AI

MixedbreadAIEmbeddings 类使用 Mixedbread AI API 来生成文本嵌入。本指南将引导您完成 MixedbreadAIEmbeddings 类的设置和使用,帮助您有效地将其集成到您的项目中。

安装

要安装 @langchain/mixedbread-ai 包,请使用以下命令

提示

有关安装集成包的通用说明,请参阅此部分

npm install @langchain/mixedbread-ai @langchain/core

初始化

首先,在 Mixedbread AI 网站上注册并在此处获取您的 API 密钥。然后,您可以使用此密钥来初始化 MixedbreadAIEmbeddings 类。

您可以将 API 密钥直接传递给构造函数,或将其设置为环境变量 (MXBAI_API_KEY)。

基本用法

以下是如何创建 MixedbreadAIEmbeddings 的实例

import { MixedbreadAIEmbeddings } from "@langchain/mixedbread-ai";

const embeddings = new MixedbreadAIEmbeddings({
apiKey: "YOUR_API_KEY",
// Optionally specify model
// model: "mixedbread-ai/mxbai-embed-large-v1",
});

如果未提供 apiKey,则将从 MXBAI_API_KEY 环境变量中读取。

生成嵌入

嵌入单个查询

要为单个文本查询生成嵌入,请使用 embedQuery 方法

const embedding = await embeddings.embedQuery(
"Represent this sentence for searching relevant passages: Is baking fun?"
);
console.log(embedding);

嵌入多个文档

要为多个文档生成嵌入,请使用 embedDocuments 方法。此方法会根据 batchSize 参数自动处理批处理

const documents = ["Baking bread is fun", "I love baking"];

const embeddingsArray = await embeddings.embedDocuments(documents);
console.log(embeddingsArray);

自定义请求

您可以通过传递其他参数来自定义 SDK。

const customEmbeddings = new MixedbreadAIEmbeddings({
apiKey: "YOUR_API_KEY",
baseUrl: "...",
maxRetries: 6,
});

错误处理

如果未提供 API 密钥,并且在环境变量中也找不到,则会抛出错误

try {
const embeddings = new MixedbreadAIEmbeddings();
} catch (error) {
console.error(error);
}

此页内容是否对您有帮助?


您也可以留下详细的反馈 在 GitHub 上.