# @genkit-ai/google-cloud 中文文档

规范地址：https://npmcn.com/package/%40genkit-ai/google-cloud/

版本：1\.44\.0
npm 元数据更新时间：2026-11-03T20:51:45.872Z
中文译文更新时间：2026-11-16T03:41:18.817Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40genkit-ai/google-cloud
原文对照：https://npmcn.com/package/%40genkit-ai/google-cloud/?lang=original
项目主页：https://github.com/genkit-ai/genkit#readme
源码仓库：https://github.com/genkit-ai/genkit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：773 kB，123 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：19 个
- peer 依赖：genkit ^1\.44\.0
- 首次发布：2024-04-04T17:46:17.009Z
- 最新版本发布：2026-11-03T20:51:45.579Z
- 近 30 天下载量：927022（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：167（近 12 个月 40 个）

## 中文简介

Genkit AI框架插件用于Google Cloud平台,包括Firestore track/ state store和用于Firebase的Cloud函数的部署助手.

## 安装

```sh
npm install @genkit-ai/google-cloud
```

也可以使用：`pnpm add @genkit-ai/google-cloud`、`yarn add @genkit-ai/google-cloud`、`bun add @genkit-ai/google-cloud`

## README

# Google 用于 Genkit 的云插件

Google Cloud插件为Genkit提供与Google Cloud平台服务的集成.

> **用编码代理? 先安装基因组JS技能.**
> 
> ```bash
> npx skills add genkit-ai/skills --skill developing-genkit-js
> ```
> 
> 它教你的代理人 现任Genkit JS APIs 和普通的gitchas. 其他语言的来源、人工安装和技能: [技能/技能](https://github.com/genkit-ai/skills)。 。 。 .

## 特征

-   **Google 云可观测性**:将遥测(追踪,度量衡)和日志输出到Google Cloud的操作套件.
-   **型号装甲**:用于用Google Cloud Model Armor对用户进行消毒的中端软件提示和模型响应.
-   **Firestore 会话存储器 (Beta)**: Persist 代理会话在Firestore的快照,被硬化并可任意缩放为长会话.

## 安装

```bash
npm install @genkit-ai/google-cloud
```

## Google 云可观测性

该插件允许您将遥测数据导出至Google Cloud. 这对监测你的基因组流动和生产模式很有用.

为了启用它,使用 `enableGoogleCloudTelemetry`数字 :

```typescript
import { enableGoogleCloudTelemetry } from '@genkit-ai/google-cloud';

enableGoogleCloudTelemetry({
  // Optional configuration
  // projectId: 'your-project-id',
  // forceDevMode: false, // Set to true to enable export in dev environment
});
```

这将配置 Genkit , 将 OpenTeleometry 的痕迹和度量衡发送到 Cloud Trace 和 Cloud 监控, 并将日志发送到 Cloud 日志 .

## 型号装甲

[谷歌云型装甲](https://docs.cloud.google.com/model-armor/overview) 在使用"大语言模型"(LLMs)时,通过提供一层保护来帮助您减轻风险,这层保护既能消毒用户的提示,又能消毒模型的响应.

### 使用量

你可以用这个 `modelArmor` 在您的世代中, 中间软件请求 :

```typescript
import { modelArmor } from '@genkit-ai/google-cloud/model-armor';
import { googleAI } from '@genkit-ai/google-genai';
import { genkit } from 'genkit';

const ai = genkit({
  plugins: [googleAI()],
});

const response = await ai.generate({
  model: googleAI.model('gemini-flash-latest'),
  prompt: 'your prompt here',
  use: [
    modelArmor({
      templateName: 'projects/your-project/locations/your-location/templates/your-template',
      // Optional configuration
      filters: ['pi_and_jailbreak', 'malicious_uris'], // Specific filters to enforce
      strictSdpEnforcement: true, // Block if sensitive data is found even if masked
      protectionTarget: 'all', // 'all', 'userPrompt', or 'modelResponse'
      clientOptions: {
        apiEndpoint: 'modelarmor.us-central1.rep.googleapis.com',
      },
    }),
  ],
});
```

### 配置选项

-   `templateName` (需要): 您的模型装甲模板的资源名称( 例如, ), `projects/.../locations/.../templates/...`) (中文(简体) ).
-   `filters` (可选):需要执行的过滤器列表(例如, `rai`, (中文(简体) ), `pi_and_jailbreak`, (中文(简体) ), `malicious_uris`, (中文(简体) ), `csam`, (中文(简体) ), `sdp`) (中文(简体) ). 如果没有指定,模板中启用的所有过滤器都会被执行.
-   `strictSdpEnforcement` (备选):如果 `true`,如果敏感数据保护(SDP)检测到敏感信息,即使成功解析信息,也会块块执行。 默认为 `false`。 。 。 .
-   `protectionTarget` (可选):具体如何消毒. 选项 : `'all'` (违约), `'userPrompt'`, (中文(简体) ), `'modelResponse'`。 。 。 .
-   `clientOptions` (可选):基础型号装甲客户端的附加选项.

## Firestore 会话存储器 (Beta)

`FirestoreSessionStore` 是一个火炉支撑 `SessionStore` 用于持续代理会话快照。 与天真的单一文件店不同,它作为JSON Patch diff的增量站点,一直持续到定期的被压榨的全州检查站,所以:

-   没有任何文档接近 Firestore [1个米B限制](https://firebase.google.com/docs/firestore/quotas) (状态在文档中变硬).
-   每个回合读出/写出的文件数量以下列文件为准: `checkpointInterval` 而不是总会话长度,因此它缩放为任意长会话(例如长寿的聊天员,编码代理).
-   重建仅在只读交易中使用文档-ID查看,因此不需要二次索引,而且非常一致.

> 如果你运行在火基地 `@genkit-ai/firebase` 软件包用 Firebase 应用程序设置再导出此商店( a) `firebaseApp` 选项)。 见它的读取.

### 使用量

从这里导入 `@genkit-ai/google-cloud/beta` 并传递作为 `store` 当定义代理人时:

```typescript
import { genkit } from 'genkit/beta';
import { FirestoreSessionStore } from '@genkit-ai/google-cloud/beta';

const ai = genkit({
  plugins: [
    // ...
  ],
});

const myAgent = ai.defineAgent({
  name: 'myAgent',
  system: 'You are a helpful assistant.',
  // Defaults to a new Firestore() instance using Application Default
  // Credentials; pass `db` to provide your own.
  store: new FirestoreSessionStore(),
});
```

### 选项

-   `db`:一个明显的Firestore实例. 默认为新 `Firestore()` 实例(它取出应用程序默认证书和 `FIRESTORE_EMULATOR_HOST` 环境变量).
-   `collection`: 存储快照文档的集合 。 默认为 `"genkit-sessions"`由它衍生出两个伴生集: `"<collection>-pointers"` (每个会话一个指针文档)和 `"<collection>-shards"` (坚固的检查站状态).
-   `checkpointInterval`:全州检查站之间的转弯次数. 默认为 `25`. 降低(如:. `10`) 对于小国,读重会;提高会(例如. `50`\- 说吧`100`),用于长时间留存的大回转状态.
-   `shardSize`: 单个硬度/ diff 文档的最大字节大小。 默认为 `512 KiB`。任何超过此限的分数会被提升到一个被压碎的检查站,所以没有文件接近1 MiB 的限值.

## 参考文献

访问 [genkit 正式文件](https://genkit.dev/docs/js/get-started/) 更多信息.

此套件的来源主要为 [精灵](https://github.com/genkit-ai/genkit) 复发. 请提交问题 和拉请求反对的回波.

许可证: Apache 2.0

## 常见问题

### @genkit-ai/google-cloud 是什么？

Genkit AI框架插件用于Google Cloud平台,包括Firestore track/ state store和用于Firebase的Cloud函数的部署助手\.

### 如何安装 @genkit-ai/google-cloud？

在项目目录运行 npm install @genkit-ai/google-cloud，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：genkit（^1\.44\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @genkit-ai/google-cloud 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @genkit-ai/google-cloud 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @genkit-ai/google-cloud 可以商用吗？

@genkit-ai/google-cloud 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @genkit-ai/google-cloud 的下载量有多少？

根据 npm 官方下载统计，@genkit-ai/google-cloud 在 2026/10/16 – 2026/11/14 这 30 天内被下载 927,022 次，日均约 30,901 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @genkit-ai/google-cloud 还在维护吗？

最新版本 1\.44\.0 发布于 2026/11/04（12 天前）；至今共发布 167 个版本，其中过去 12 个月发布了 40 个；首次发布于 2024/04/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

