# @genkit-ai/express 中文文档

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

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

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

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

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

- 包体积（解压后）：130 kB，18 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：genkit ^1\.44\.0，express ^4\.21\.1 \|\| ^5
- 首次发布：2024-12-16T17:01:46.032Z
- 最新版本发布：2026-11-03T20:51:45.980Z
- 近 30 天下载量：20750（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：112（近 12 个月 40 个）

## 中文简介

Express服务器的 Genkit AI 框架插件

## 安装

```sh
npm install @genkit-ai/express
```

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

## README

# Genkit快递插件

此插件为通过Express HTTP 服务器以 REST API 来对接地曝光 Genkit 流量和动作提供公用设备.

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

见 [正式文件](https://genkit.dev/docs/frameworks/express/) 为了更多.

## 安装

要使用此插件, 请在您的工程中安装 :

```bash
npm i @genkit-ai/express
```

## 使用量

```ts
import { expressHandler } from '@genkit-ai/express';
import express from 'express';

const simpleFlow = ai.defineFlow('simpleFlow', async (input, { sendChunk }) => {
  const { text } = await ai.generate({
    model: googleAI.model('gemini-flash-latest'),
    prompt: input,
    onChunk: (c) => sendChunk(c.text),
  });
  return text;
});

const app = express();
app.use(express.json());

app.post('/simpleFlow', expressHandler(simpleFlow));

app.listen(8080);
```

您也可以使用上下文提供者处理认证 :

```ts
import { UserFacingError } from 'genkit';
import { ContextProvider, RequestData } from 'genkit/context';

const context: ContextProvider<Context> = (req: RequestData) => {
  if (req.headers['authorization'] !== 'open sesame') {
    throw new UserFacingError('PERMISSION_DENIED', 'not authorized');
  }
  return {
    auth: {
      user: 'Ali Baba',
    },
  };
};

app.post(
  '/simpleFlow',
  authMiddleware,
  expressHandler(simpleFlow, { context })
);
```

### 持久流(Beta)

您可以配置流量以使用 `StreamManager` 坚持他们的状态。 这使得客户端可以断开并重新连接到一个流而不会失去状态.

为了能够持久地流出,提供 `streamManager` 输入 `expressHandler` 选项。 这个 `InMemoryStreamManager` 用于开发和测试:

```ts
import { InMemoryStreamManager } from 'genkit/beta';

// ...

app.post(
  '/myDurableFlow',
  expressHandler(myFlow, {
    streamManager: new InMemoryStreamManager(),
  })
);
```

对于生产环境,你应该使用耐用 `StreamManager` 执行,例如: `FirestoreStreamManager` 或者说 `RtdbStreamManager` 从 `@genkit-ai/firebase` 插件,或自定义执行 .

然后客户端可以使用 `streamId`数字 :

```ts
// Start a new stream
const result = streamFlow({
  url: `http://localhost:8080/myDurableFlow`,
  input: 'tell me a long story',
});
const streamId = await result.streamId; // Save this ID

// ... later, reconnect if needed ...
const reconnectedResult = streamFlow({
  url: `http://localhost:8080/myDurableFlow`,
  streamId: streamId,
});
```

使用 `expressHandler` 函数可以使用 `genkit/beta/client` 库 :

```ts
import { runFlow, streamFlow } from 'genkit/beta/client';

const result = await runFlow({
  url: `http://localhost:${port}/simpleFlow`,
  input: 'say hello',
});

console.log(result); // hello

// set auth headers (when using auth policies)
const result = await runFlow({
  url: `http://localhost:${port}/simpleFlow`,
  headers: {
    Authorization: 'open sesame',
  },
  input: 'say hello',
});

console.log(result); // hello

// and streamed
const result = streamFlow({
  url: `http://localhost:${port}/simpleFlow`,
  input: 'say hello',
});
for await (const chunk of result.stream) {
  console.log(chunk);
}
console.log(await result.output);
```

### 初始化数据

如果您的流量或动作接受初始化数据(通过 `initSchema`你可以通过它使用 `init` 选项:

```ts
const result = await runFlow({
  url: `http://localhost:${port}/myFlow`,
  input: 'say hello',
  init: { sessionId: 'abc123', config: { temperature: 0.7 } },
});

// Also works with streaming
const streamed = streamFlow({
  url: `http://localhost:${port}/myFlow`,
  input: 'say hello',
  init: { sessionId: 'abc123' },
});
for await (const chunk of streamed.stream) {
  console.log(chunk);
}
console.log(await streamed.output);
```

这个 `init` 数据与请求中的数据同时发送 `data` 并被验证 行动 `initSchema` 在服务器侧。 如果 `init` 数据不符合 `initSchema`时,请求失败 `400 INVALID_ARGUMENT` 流量运行前出错 .

您还可以使用 `startFlowServer` 迅速揭露多种流动和行动:

```ts
import { startFlowServer } from '@genkit-ai/express';
import { genkit } from 'genkit';

const ai = genkit({});

export const menuSuggestionFlow = ai.defineFlow(
  {
    name: 'menuSuggestionFlow',
  },
  async (restaurantTheme) => {
    // ...
  }
);

startFlowServer({
  flows: [menuSuggestionFlow],
});
```

您也可以配置服务器 :

```ts
startFlowServer({
  flows: [menuSuggestionFlow],
  port: 4567,
  cors: {
    origin: '*',
  },
});
```

## 捐款

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

使用信息和参考详情见 [genkit 正式文件](https://genkit.dev/docs/get-started/)。 。 。 .

## 许可证

凭"Apache 2.0许可证"获得许可.

## 常见问题

### @genkit-ai/express 是什么？

Express服务器的 Genkit AI 框架插件

### 如何安装 @genkit-ai/express？

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

### @genkit-ai/express 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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

