developing-genkit-python

原文：🇺🇸 英文

已翻译

使用Python中的Genkit开发AI驱动的应用程序。适用于用户询问Python中的Genkit、AI Agent、流程或工具，或是遇到Genkit报错、导入问题或API相关问题的场景。

33.8k次下载

来源firebase/agent-skills

添加于2026-04-24

NPX安装

npx skill4agent add firebase/agent-skills developing-genkit-python

SKILL.md 内容（中文）

查看翻译对照 →

Genkit Python

前提条件

运行环境：Python 3.14+，依赖管理工具**
```
uv
```
**（安装教程）。
命令行工具：执行
```
genkit --version
```
检查版本，若未安装可通过
```
npm install -g genkit-cli
```
安装。

新项目创建：参考初始化指南（项目初始化 + 环境配置）。模式与代码示例：参考示例集。

Hello World

python

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用法。遇到任何错误，请先阅读常见错误文档。

开发工作流

默认服务商：Google AI（
```
GoogleAI()
```
），需在环境变量中配置**
```
GEMINI_API_KEY
```
**。
模型ID：需始终添加前缀，例如**
```
googleai/gemini-flash-latest
```
**（始终指向最新版Flash的别名；与其他技能的命名模式一致）。
入口点：Genkit驱动的应用需使用**
```
ai.run_main(main())
```
**（对于通过
```
genkit start
```
启动的长期运行服务器，请勿使用
```
asyncio.run()
```
——详见常见错误）。
生成代码后，请遵循开发工作流使用
```
genkit start
```
与开发UI。
遇到错误时：第一步永远是查阅常见错误。

参考资料

示例集：结构化输出、流式传输、流程、工具、嵌入。
初始化指南：新项目初始化与插件配置。
常见错误：遇到问题时首先查阅。
FastAPI：HTTP服务、
```
genkit_fastapi_handler
```
、并行流程。
Dotprompt：
```
.prompt
```
文件与辅助工具。
Evals：评估器与数据集。
开发工作流：
```
genkit start
```
、开发UI、检查清单。