@genkit-ai/next

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

Genkit 的下一个.js 插件

中文使用文档

Genkit 下一个.js 插件

见 正式文件 为了更多.

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

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

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

这个插件为通过 Next.js app routs 使 Genkit 的流量和动作通过 REST API 进行凸起提供效用 .

// /genkit/simpleFlow.ts
const simpleFlow = ai.defineFlow(
  'simpleFlow',
  async (input, streamingCallback) => {
    const { text } = await ai.generate({
      model: googleAI.model('gemini-flash-latest'),
      prompt: input,
      streamingCallback: (chunk) => streamingCallback(chunk.text),
    });
    return text;
  }
);
// /app/api/simpleFlow/route.ts
import { simpleFlow } from '@/genkit/simpleFlow';
import { appRoute } from '@genkit-ai/next';

export const POST = appRoute(simpleFlow);

持久流(Beta)

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

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

// /app/api/myDurableFlow/route.ts
import { myFlow } from '@/genkit/myFlow';
import { appRoute } from '@genkit-ai/next';
import { InMemoryStreamManager } from 'genkit/beta';

export const POST = appRoute(myFlow, {
  streamManager: new InMemoryStreamManager(),
});

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

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

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

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

API 可以用通用调用 genkit/beta/client 库,或 @genkit-ai/next/client

import { runFlow, streamFlow } from '@genkit-ai/next/client';
import { simpleFlow } from '@/genkit/simpleFlow';

const result = await runFlow<typeof simpleFlow>({
  url: '/api/simpleFlow',
  input: 'say hello',
});

console.log(result); // hello

// set auth headers (when using auth policies)
const result = await runFlow<typeof simpleFlow>({
  url: `/api/simpleFlow`,
  headers: {
    Authorization: 'open sesame',
  },
  input: 'say hello',
});

console.log(result); // hello

// and streamed
const { stream, output } = streamFlow<typeof simpleFlow>({
  url: '/api/simpleFlow',
  input: 'say hello',
});
for await (const chunk of stream) {
  console.log(chunk.output);
}
console.log(await output); // output is a promise, must be awaited

初始化数据

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

const result = await runFlow<typeof myFlow>({
  url: '/api/myFlow',
  input: 'say hello',
  init: { sessionId: 'abc123', config: { temperature: 0.7 } },
});

// Also works with streaming
const { stream, output } = streamFlow<typeof myFlow>({
  url: '/api/myFlow',
  input: 'say hello',
  init: { sessionId: 'abc123' },
});
for await (const chunk of stream) {
  console.log(chunk.output);
}
console.log(await output);

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

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

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

许可证: Apache 2.0

版本与发布记录

@genkit-ai/next 共发布 96 个版本,首次发布于 2025/02/06;过去 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/next 的常见问题

@genkit-ai/next 是什么?

Genkit 的下一个.js 插件

如何安装 @genkit-ai/next?

在项目目录运行 npm install @genkit-ai/next,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^3.24.1)、next(^15.0.0 || ^16.0.0)、genkit(1.44.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@genkit-ai/next 支持 TypeScript 吗?

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

@genkit-ai/next 支持 ESM 还是 CommonJS?

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

@genkit-ai/next 可以商用吗?

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

@genkit-ai/next 的下载量有多少?

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

@genkit-ai/next 还在维护吗?

最新版本 1.44.0 发布于 2026/11/04(12 天前);至今共发布 96 个版本,其中过去 12 个月发布了 40 个;首次发布于 2025/02/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。