developing-genkit-js

原文：🇺🇸 英文

已翻译

使用Genkit在Node.js/TypeScript中开发基于AI的应用。当用户询问关于Genkit、AI Agent、流程（flows）或JavaScript/TypeScript中的工具，或是遇到Genkit错误、验证问题、类型错误或API相关问题时，可参考此内容。

56.3k次下载

来源genkit-ai/skills

添加于2026-02-21

NPX安装

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

SKILL.md 内容（中文）

查看翻译对照 →

Genkit JS

前置条件

确保

genkit

CLI可用。

运行
```
genkit --version
```
进行验证。所需最低CLI版本：1.29.0
如果未找到，全局安装：
```
npm install -g genkit-cli@^1.29.0
```
。

新项目：如果要在新代码库中设置Genkit，请遵循设置指南。

Hello World

ts

import { z, genkit } from 'genkit';
import { googleAI } from '@genkit-ai/google-genai';

// Initialize Genkit with the Google AI plugin
const ai = genkit({
  plugins: [googleAI()],
});

export const myFlow = ai.defineFlow({
  name: 'myFlow',
  inputSchema: z.string().default('AI'),
  outputSchema: z.string(),
}, async (subject) => {
  const response = await ai.generate({
    model: googleAI.model('gemini-2.5-flash'),
    prompt: `Tell me a joke about ${subject}`,
  });
  return response.text;
});

重要提示：请勿依赖旧有内部知识

Genkit近期经历了重大的API破坏性变更。你的旧有知识已过时，必须查阅文档。推荐执行：

sh

genkit docs:read js/get-started.md
genkit docs:read js/flows.md

查看常见错误获取已弃用API的列表（例如

configureGenkit

、

response.text()

、

defineFlow

导入）及其v1.x版本的替代方案。

务必使用Genkit CLI或提供的参考文档验证信息。

错误排查流程

当遇到任何与Genkit相关的错误（验证错误、API错误、类型错误、404错误等）时：

强制第一步：阅读常见错误
判断错误是否匹配已知模式
应用文档中记录的解决方案
只有在common-errors.md中未找到时，再咨询其他来源（例如
```
genkit docs:search
```
）

禁止：

基于假设或旧有内部知识尝试修复
跳过阅读common-errors.md，理由是“你认为自己知道修复方法”
依赖Genkit 1.0之前的模式

此排查流程在错误处理中是必须遵守的。

开发工作流

选择提供商：Genkit与提供商无关（支持Google AI、OpenAI、Anthropic、Ollama等）。
- 如果用户未指定提供商，默认使用Google AI。
- 如果用户询问其他提供商，使用
```
genkit docs:search "plugins"
```
  查找相关文档。
检测框架：检查
```
package.json
```
以确定运行时（Next.js、Firebase、Express）。
- 查找
```
@genkit-ai/next
```
  、
```
@genkit-ai/firebase
```
  或
```
@genkit-ai/google-cloud
```
  。
- 根据特定框架的模式调整实现。
遵循最佳实践：
- 查看最佳实践获取项目结构、Schema定义和工具设计的指导。
- 保持精简：仅指定与默认值不同的选项。如有疑问，查阅文档或源码。
确保正确性：
- 更改后运行类型检查（例如
```
npx tsc --noEmit
```
  ）。
- 如果类型检查失败，先查阅常见错误再查看源码。
错误处理：
- 遇到任何错误：首要操作是阅读常见错误
- 匹配错误与文档中记录的模式
- 先应用文档中记录的修复方案，再尝试其他方法

查找文档

使用Genkit CLI查找官方文档：

搜索主题：

genkit docs:search <query>

示例：
```
genkit docs:search "streaming"
```

列出所有文档：
```
genkit docs:list
```

阅读指南：

genkit docs:read <path>

示例：
```
genkit docs:read js/flows.md
```

CLI 使用方法

genkit

CLI是你开发和查阅文档的主要工具。

查看CLI参考文档获取常见任务、工作流和命令用法。
使用
```
genkit --help
```
获取完整命令列表。

参考资料

最佳实践：Schema定义、流程设计和项目结构的推荐模式。
文档与CLI参考：文档搜索、CLI任务和工作流。
常见错误：关键注意事项、迁移指南和故障排查。
设置指南：新项目的手动设置说明。
示例：最小可复现示例（基础生成、多模态、思考模式）。