@genkit-ai/express

中文文档
1.44.0发布于 2026/11/04Apache-2.0TypeScriptESM + CJS近 30 天下载 2.1万

Express服务器的 Genkit AI 框架插件

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 持久流(Beta)
  4. 初始化数据
  5. 捐款
  6. 许可证

Genkit快递插件

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

用编码代理? 先安装基因组JS技能.

npx skills add genkit-ai/skills --skill developing-genkit-js

它教你的代理人 现任Genkit JS APIs 和普通的gitchas. 其他语言的来源、人工安装和技能: 技能/技能。 。 。 .

见 正式文件 为了更多.

安装

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

npm i @genkit-ai/express

使用量

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);

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

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 用于开发和测试:

import { InMemoryStreamManager } from 'genkit/beta';

// ...

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

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

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

// 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 库 :

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 选项:

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 迅速揭露多种流动和行动:

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],
});

您也可以配置服务器 :

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

捐款

此套件的来源主要为 精灵 复发. 请提交问题 和拉请求反对的回波.

使用信息和参考详情见 genkit 正式文件。 。 。 .

许可证

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

版本与发布记录

@genkit-ai/express 共发布 112 个版本,首次发布于 2024/12/17;过去 12 个月发布了 40 个版本。

版本发布日期距今
1.44.0latest2026/11/0412 天前
1.43.02026/10/2225 天前
1.43.0-rc.3next2026/10/2225 天前
1.43.0-rc.22026/10/2126 天前
1.43.0-rc.12026/10/091 个月前
1.43.0-rc.02026/10/091 个月前

关于 @genkit-ai/express 的常见问题

@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 和提交记录判断。