> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-docs-zh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CloudflareWorkersAIEmbeddings集成

> 集成 CloudflareWorkersAIEmbeddings 嵌入模型，使用 LangChain JavaScript。

这将帮助您使用 LangChain 开始使用 Cloudflare Workers AI [嵌入模型](https://langchain-docs-zh.mintlify.site/langchain/oss/python/integrations/embeddings.md)。有关 `CloudflareWorkersAIEmbeddings` 功能和配置选项的详细文档，请参阅 [API 参考](https://reference.langchain.com/javascript/langchain-cloudflare/CloudflareWorkersAIEmbeddings)。

## 概述

### 集成详情

| 类 | 包 | 本地 | Python 支持 | 下载 | 版本 |
| :- | :- | :-: | :-: | :-: | :-: |
| [`CloudflareWorkersAIEmbeddings`](https://reference.langchain.com/javascript/langchain-cloudflare/CloudflareWorkersAIEmbeddings) | [`@langchain/cloudflare`](https://npmjs.com/@langchain/cloudflare) | ❌ | ❌ | ![NPM - 下载](https://img.shields.io/npm/dm/@langchain/cloudflare?style=flat-square\&label=%20&) | ![NPM - 版本](https://img.shields.io/npm/v/@langchain/cloudflare?style=flat-square\&label=%20&) |

## 设置

要访问 Cloudflare 嵌入模型，您需要创建一个 Cloudflare 账户并安装 `@langchain/cloudflare` 集成包。此集成设计为在 Cloudflare Worker 中运行并接受绑定。

请按照 [官方文档](https://developers.cloudflare.com/workers-ai/get-started/workers-wrangler/) 设置您的 Worker。

您的 `wrangler.toml` 文件应类似于以下内容：

```toml theme={null}
name = "langchain-test"
main = "worker.js"
compatibility_date = "2024-01-10"

[[vectorize]]
binding = "VECTORIZE_INDEX"
index_name = "langchain-test"

[ai]
binding = "AI"
```

### 凭证

如果您希望对模型调用进行自动跟踪，可以通过取消注释以下内容来设置您的 [LangSmith](https://docs.langchain.com/langsmith/observability) API 密钥：

```bash theme={null}
# export LANGSMITH_TRACING="true"
# export LANGSMITH_API_KEY="your-api-key"
```

### 安装

LangChain CloudflareWorkersAIEmbeddings 集成位于 `@langchain/cloudflare` 包中：

```bash npm theme={null}
npm install @langchain/cloudflare @langchain/core
```

```bash yarn theme={null}
yarn add @langchain/cloudflare @langchain/core
```

```bash pnpm theme={null}
pnpm add @langchain/cloudflare @langchain/core
```

## 使用

以下是一个使用 Workers AI 嵌入和 [Cloudflare Vectorize 向量存储](https://langchain-docs-zh.mintlify.site/langchain/oss/javascript/integrations/vectorstores/cloudflare_vectorize.md) 的 Worker 示例。

```typescript theme={null}
// @ts-nocheck

import type {
  VectorizeIndex,
  Fetcher,
  Request,
} from "@cloudflare/workers-types";

import {
  CloudflareVectorizeStore,
  CloudflareWorkersAIEmbeddings,
} from "@langchain/cloudflare";

export interface Env {
  VECTORIZE_INDEX: VectorizeIndex;
  AI: Fetcher;
}

export default {
  async fetch(request: Request, env: Env) {
    const { pathname } = new URL(request.url);
    const embeddings = new CloudflareWorkersAIEmbeddings({
      binding: env.AI,
      model: "@cf/baai/bge-small-en-v1.5",
    });
    const store = new CloudflareVectorizeStore(embeddings, {
      index: env.VECTORIZE_INDEX,
    });
    if (pathname === "/") {
      const results = await store.similaritySearch("hello", 5);
      return Response.json(results);
    } else if (pathname === "/load") {
      // Upsertion by id is supported
      await store.addDocuments(
        [
          {
            pageContent: "hello",
            metadata: {},
          },
          {
            pageContent: "world",
            metadata: {},
          },
          {
            pageContent: "hi",
            metadata: {},
          },
        ],
        { ids: ["id1", "id2", "id3"] }
      );

      return Response.json({ success: true });
    } else if (pathname === "/clear") {
      await store.delete({ ids: ["id1", "id2", "id3"] });
      return Response.json({ success: true });
    }

    return Response.json({ error: "Not Found" }, { status: 404 });
  },
};
```

***

## API 参考

有关所有 `CloudflareWorkersAIEmbeddings` 功能和配置的详细文档，请前往 [API 参考](https://reference.langchain.com/javascript/langchain-cloudflare/CloudflareWorkersAIEmbeddings)。

***

> 官方原文：[src/oss/javascript/integrations/embeddings/cloudflare\_ai.mdx](https://github.com/langchain-ai/docs/blob/main/src/oss/javascript/integrations/embeddings/cloudflare_ai.mdx) · 非官方翻译，译文由 AI 生成，以英文原文为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.