mcpField
D
developing-genkit-python

developing-genkit-python

github.com/firebase开发49133.6k 次安装1 天前更新
代码仓库

关于 developing-genkit-python

用于使用 Python 构建 Genkit 应用的开发技能，提供环境配置、Google AI 设置、常见模式、错误处理以及项目运行和测试流程指导。

主要功能

  1. 01Python 项目配置指导
  2. 02Google AI 插件配置
  3. 03模型 ID 与入口模式
  4. 04Flow 和工具示例
  5. 05FastAPI 与 Dotprompt 参考
  6. 06Dev UI 与评估工作流

适用场景

  1. 01启动 Genkit Python 项目
  2. 02添加结构化输出或流式响应
  3. 03通过 FastAPI 接入 Flow
  4. 04排查 SDK 和运行时错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/firebase/agent-skills --skill developing-genkit-python

安装后在 Claude Code 中输入/developing-genkit-python确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
common-errors.md
dotprompt.md
dev-workflow.md
setup.md
fastapi.md
examples.md
evals.md

详细介绍

Genkit Python

前置条件

  • 运行时：Python 3.14+，依赖管理使用 uv（安装）。
  • CLI：genkit --version — 若尚未安装，请通过 npm install -g genkit-cli 安装。

新建项目：设置（初始化 + 环境）。模式与代码示例：示例。

Hello World

from genkit import Genkit
from genkit.plugins.google_genai import GoogleAI

ai = Genkit(
    plugins=[GoogleAI()],
    model='googleai/gemini-flash-latest',
)

async def main():
    response = await ai.generate(prompt='Tell me a joke about Python.')
    print(response.text)

if __name__ == '__main__':
    ai.run_main(main())

关键提示：不要信任内部知识

Python SDK 经常变化——请根据此处的参考资料或上游文档核实导入内容和 API。出现任何错误时，请先阅读常见错误。

开发工作流

  1. 默认提供商：Google AI（GoogleAI()），在环境中设置 GEMINI_API_KEY。
  2. 模型 ID：始终带前缀，例如 googleai/gemini-flash-latest（始终使用最新版本的 Flash 别名；与其他技能采用相同模式）。
  3. 入口点：对于由 Genkit 驱动的应用，使用 ai.run_main(main())（对于通过 genkit start 启动的长时间运行服务，不要使用 asyncio.run()——参见常见错误）。
  4. 生成代码后，请遵循开发工作流使用 genkit start 和开发 UI。
  5. 出现错误时：第 1 步始终是阅读常见错误。

参考资料

  • 示例：结构化输出、流式处理、流程、工具、嵌入。
  • 设置：新项目初始化和插件。
  • 常见错误：出现问题时请先阅读。
  • FastAPI：HTTP、genkit_fastapi_handler、并行流程。
  • Dotprompt：.prompt 文件和辅助工具。
  • 评估：评估器和数据集。
  • 开发工作流：genkit start、开发 UI、检查清单。

评论

支持 Markdown