Genkit 简化了 JavaScript 和 TypeScript 中的 AI 应用程序开发,但理解其 API 变更和最佳实践可能非常耗时。本技能提供关于 flows、tools 和 providers 的专家指导,帮助您快速构建生产就绪的 AI 应用程序。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“developing-genkit-js”。 Create a Genkit flow that translates text between languages
预期结果:
已创建 flow 'translateText',输入 schema(text、sourceLang、targetLang)和输出 schema(translatedText)。使用 googleAI model 'gemini-2.5-flash'。Flow 已注册,可以使用 `genkit flow:run translateText` 进行测试。
正在使用“developing-genkit-js”。 Help me fix this error: 'response.text is not a function'
预期结果:
此错误表示您使用的是 Genkit 1.0 之前的语法。在 Genkit v1.x 中,响应属性直接访问,而非作为方法调用。请将代码中的 `response.text()` 改为 `response.text`。更多迁移说明请参阅 references/common-errors.md。
正在使用“developing-genkit-js”。 Set up Genkit in my existing Next.js project
预期结果:
检测到 Next.js 项目结构。正在安装 @genkit-ai/next 和 @genkit-ai/google-genai 包。在 src/ai 目录创建 genkit.ts 配置。在 package.json 中添加 genkit:ui 脚本。Genkit 现已配置完成,可以使用。
安全审计
低风险Static analysis flagged 194 potential security issues, primarily CLI command examples in markdown documentation. All flagged patterns are documentation showing Genkit CLI usage (genkit start, npm install, genkit docs:search, etc.). No actual executable code patterns or malicious intent found. The skill provides standard Genkit development patterns for AI application development.
中风险问题 (1)
低风险问题 (3)
风险因素
质量评分
你能构建什么
新项目设置
使用正确的结构初始化新的 Genkit 项目,配置 provider,并创建简单的工作 flow。非常适合刚开始学习 AI 应用程序开发的开发者。
错误排查
调试 Genkit 验证错误、类型不匹配和废弃的 API 用法。本技能包含带有解决方案的综合常见错误参考。
高级 Flow 设计
使用自定义 tools、流式响应和多模态能力(文本、图像、音频生成)构建复杂的多步骤 flows。
试试这些提示
Create a Genkit flow that takes a topic as input and returns a summary. Use the Google AI provider with gemini-2.5-flash model.
Create a Genkit flow with two tools: one to search the web and another to format results. Chain them together in a single flow.
Convert a regular Genkit flow to use streaming output so users see responses as they are generated.
I am getting a 'configureGenkit is not a function' error when running my Genkit code. The code worked yesterday but I updated some packages. Help me fix this.
最佳实践
- 始终使用最新的模型版本(gemini-2.5-flash 或更高版本),并参考 Genkit CLI 的当前建议
- 对所有输入和输出字段使用带有 .describe() 的 Zod schema 以指导 LLM 行为
- 编写 Genkit 代码后运行类型检查(npx tsc --noEmit)以及早发现 schema 不匹配问题
避免
- 不要使用已废弃的模型版本(gemini-1.5-*、gemini-2.0-*),这些版本已被停用且会失败
- 不要从内部包导入(@genkit-ai/ai、@genkit-ai/core、@genkit-ai/flow)—— 应从主包 'genkit' 导入
- 不要依赖内部知识来修复错误——在使用其他来源之前,始终先查阅 references/common-errors.md