技能 developing-genkit-js
📦

developing-genkit-js

低风险 ⚙️ 外部命令

使用 Genkit 构建 AI 应用程序

也可从以下获取: firebase

Genkit 简化了 JavaScript 和 TypeScript 中的 AI 应用程序开发,但理解其 API 变更和最佳实践可能非常耗时。本技能提供关于 flows、tools 和 providers 的专家指导,帮助您快速构建生产就绪的 AI 应用程序。

支持: Claude Codex Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“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 现已配置完成,可以使用。

安全审计

低风险
v1 • 4/19/2026

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.

6
已扫描文件
543
分析行数
5
发现项
1
审计总数
中风险问题 (1)
CLI Command Examples in Documentation
176 markdown code blocks show CLI commands (npm install, genkit start, etc.). These are documentation examples, not executable code. No user input injection vectors exist.
低风险问题 (3)
Hardcoded Localhost URL
Documentation references http://localhost:4000 for local development server. Standard development pattern, not a security risk.
Example URL in Documentation
Documentation uses https://example.com/photo.jpg as placeholder image URL. Standard example domain, not sensitive.
API Key Reference in Documentation
Documentation mentions GEMINI_API_KEY environment variable. Reminds users to configure their own keys, does not contain or transmit secrets.
审计者: claude

质量评分

45
架构
100
可维护性
87
内容
50
社区
79
安全
91
规范符合性

你能构建什么

新项目设置

使用正确的结构初始化新的 Genkit 项目,配置 provider,并创建简单的工作 flow。非常适合刚开始学习 AI 应用程序开发的开发者。

错误排查

调试 Genkit 验证错误、类型不匹配和废弃的 API 用法。本技能包含带有解决方案的综合常见错误参考。

高级 Flow 设计

使用自定义 tools、流式响应和多模态能力(文本、图像、音频生成)构建复杂的多步骤 flows。

试试这些提示

创建简单 Flow
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.
构建多 Tool Agent
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.
排查 Genkit 错误
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

常见问题

本技能支持哪些 AI providers?
Genkit 支持多个 providers,包括 Google AI(默认)、OpenAI、Anthropic、Ollama 和 Vertex AI。使用 'genkit docs:search plugins' 搜索文档以查找特定包。
如何更新 Genkit CLI?
运行 'npm install -g genkit-cli@^1.29.0' 获取最新版本。使用 'genkit --version' 验证。
为什么我的 Genkit 代码有类型错误?
大多数类型错误来自废弃的导入。确保从 'genkit' 导入 { z, genkit },并从特定包(如 '@genkit-ai/google-genai')导入 plugins。
如何在本地测试我的 flows?
运行 'genkit start -- <your command>' 启动开发者 UI。使用 'genkit flow:run <flowName>' 进行基于 CLI 的测试。
我可以在 Genkit 中使用 Claude 或 OpenAI 模型吗?
可以。使用 @genkit-ai/oai-compat 插件支持 OpenAI 模型,或使用 'genkit docs:search anthropic' 搜索 Anthropic 专用插件。
Flows 和 Tools 有什么区别?
Flows 是可以调用多个 tools 并返回复杂结果的多步骤 AI 操作。Tools 是可以由 flows 或 agents 调用的单一用途函数。

开发者详情