developing-genkit-python skill
Genkit 0.13을 사용하여 에이전트, 플로우, 도구 및 구조화된 출력을 포함한 Python 기반 AI 애플리케이션을 구축합니다.
- GitHub 스타
- 39
- 파일
- 18
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- —
- 허용된 도구
- —
developing-genkit-python skill은 무엇을 하나요?
Genkit 0.13을 사용하여 에이전트, 플로우, 도구 및 구조화된 출력을 포함한 Python 기반 AI 애플리케이션을 구축합니다.
skill의 SKILL.md에서 생성된 요약입니다.
developing-genkit-python skill 정보
이 SKILL은 Genkit 0.13을 사용하는 개발자를 위해 Python 기반 AI 애플리케이션을 구축하는 데 중점을 둡니다. 에이전트, 플로우, 도구 및 구조화된 출력을 생성하는 데 필요한 가이드를 제공합니다. 개발자는 실험적인 genkit.exp 모듈을 통해 히스토리와 상태가 포함된 멀티턴 채팅을 관리하거나, @ai.flow 데코레이터를 사용하여 상태가 없는 요청/응답 파이프라인을 구축할 수 있습니다.
이 리소스는 import 및 설정 변경 사항을 다루므로 Genkit 0.12에서 0.13으로 프로젝트를 마이그레이션하는 사용자에게 필수적입니다. Google AI, Vertex AI, Anthropic, OpenAI, Ollama, Amazon Bedrock 등 다양한 프로바이더를 지원합니다. 사용자는 이러한 기능을 FastAPI 라우트나 독립형 스크립트에 통합할 수 있습니다. 성공적인 개발을 위해 표준 실행 명령에 의존하기보다 Genkit CLI를 사용하여 트레이스를 캡처하고 Dev UI로 검사하는 것을 권장합니다.
agent가 수행할 수 있는 작업
- 1상태 유지 에이전트 개발타입화된 상태와 Human-in-the-loop 승인 기능을 활용하는 멀티턴 대화형 에이전트를 생성합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
developing-genkit-python skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 developing-genkit-python skill 설치
~/.claude/skills/developing-genkit-python/SKILL.md
$ npx degit genkit-ai/skills/skills/developing-genkit-python ~/.claude/skills/developing-genkit-pythonClaude Code (project)에 developing-genkit-python skill 설치
.claude/skills/developing-genkit-python/SKILL.md
$ npx degit genkit-ai/skills/skills/developing-genkit-python .claude/skills/developing-genkit-pythonCodex에 developing-genkit-python skill 설치
~/.agents/skills/developing-genkit-python/SKILL.md
$ npx degit genkit-ai/skills/skills/developing-genkit-python ~/.agents/skills/developing-genkit-pythonGemini CLI에 developing-genkit-python skill 설치
~/.gemini/skills/developing-genkit-python/SKILL.md
$ npx degit genkit-ai/skills/skills/developing-genkit-python ~/.gemini/skills/developing-genkit-pythonClaude.ai에 developing-genkit-python skill 설치
npx degit genkit-ai/skills/skills/developing-genkit-python developing-genkit-python && zip -r developing-genkit-python.zip developing-genkit-python # claude.ai → Customize → Skills → + → Create skill → Upload a skill → developing-genkit-python.zip
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 검증되지 않았습니다. 스킬은 점수 80, 심각한 발견 없음, 검사에 충분한 데이터가 필요합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능genkit-ai/skills/skills/developing-genkit-python is public and reachablegithub.com/genkit-ai/skills/tree/HEAD/skills/developing-genk ↗통과
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-11-09github.com/genkit-ai/skills/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/genkit-ai/skills/blob/HEAD/skills/developing-genk ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/genkit-ai/skills/blob/HEAD/skills/developing-genk ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 236 linesgithub.com/genkit-ai/skills/blob/HEAD/skills/developing-genk ↗통과
SKILL.md
GitHub에서 보기Genkit Python
Build AI features in Python — generation, structured output, streaming, tools, flows, and multi-turn agents — with Genkit Python 0.13.
- New project? See Setup and Examples.
- Upgrading from 0.12 or fixing broken 0.12 imports/signatures? Read Migrating from 0.12 to 0.13 first.
Prerequisites
- Python 3.10+ and
uv(install) - Genkit CLI:
npm install -g genkit-cliifgenkit --versionis missing
Hello World
from genkit import Genkit
from genkit_google_genai import GoogleAI
ai = Genkit(
plugins=[GoogleAI()],
model=GoogleAI.gemini('gemini-flash-latest'),
)
async def main() -> None:
response = await ai.generate(prompt='Suggest one seasonal pasta dish.')
if response.error:
raise RuntimeError(response.error.message)
print(response.text)
# => Lemony tagliatelle with asparagus, sweet peas, and herb ricotta
if __name__ == '__main__':
ai.run_main(main())
ai.generate does not raise when the provider rejects or fails a call
(INVALID_ARGUMENT, UNAVAILABLE, rate limits). It returns response.error
(Failure with .status and .message), finish_reason == 'failed', and
empty text. Problems caught before the call raise: GoogleAI() raises
ValueError without GEMINI_API_KEY; an unknown model, invalid key, or unknown
config field raises GenkitError. See
Common Errors.
Agents (Experimental)
Multi-turn chats with history, typed state, human approval, branching, and
background work live under genkit.exp and genkit.exp.agent. Start here:
Agents.
from genkit.exp import Genkit
from genkit.exp.agent import InMemorySessionStore
from genkit_google_genai import GoogleAI
ai = Genkit(plugins=[GoogleAI()], model=GoogleAI.gemini('gemini-flash-latest'))
agent = ai.define_agent(
name='concierge',
system='You are a concise hotel concierge.',
store=InMemorySessionStore(),
)
chat = agent.chat()
res = await chat.send('Recommend a quiet dinner spot.') # AgentResponse
print(res.text)
# => Try Osteria Lume on 5th; it has booths and low music.
turn = chat.send_stream('Is it open past 10pm?') # AgentTurn
async for chunk in turn.stream:
if chunk.text:
print(chunk.text, end='')
final = await turn.response # AgentResponse
More: sessions · HITL · branching · background · state · artifacts · custom · HTTP
Imports
Every symbol lives in one public module (never import private _ submodules;
see Migrating from 0.12 to 0.13 if a 0.12
symbol moved):
- Core app:
from genkit import Genkit, FlowContext, ToolContext, Message, Part, Role, Media, Document, MultipartToolResponse, PublicError, GenkitError, Failure, ErrorReason - Google GenAI & Vertex AI:
from genkit_google_genai import GoogleAI, VertexAI, GeminiConfig, GeminiImageConfig, GeminiTtsConfig - Other providers:
from genkit_vertexai import ModelGarden·from genkit_anthropic import Anthropic, AnthropicConfig·from genkit_openai import OpenAI, OpenAIConfig·from genkit_ollama import Ollama, OllamaConfig·from genkit_amazon_bedrock import Bedrock, BedrockConfig - Built-in middleware:
from genkit_middleware import Middleware, Retry, Fallback, ToolApproval, Skills, Filesystem(plusfrom genkit_middleware.exp import Artifactsfor agent sessions) - Writing custom middleware:
from genkit.middleware import Middleware, MiddlewareContext - FastAPI & HTTP:
from genkit_fastapi import serve_flow, genkit_fastapi_handler, handle_genkit_request·from genkit_fastapi.exp import serve_agent·from genkit.web import RequestData, to_sse, error_body, error_status - Agents (experimental):
from genkit.exp import Genkit, current_session·from genkit.exp.agent import Agent, Session, InMemorySessionStore, FileSessionStore, remote_agent - Telemetry:
from genkit_google_cloud import enable_google_cloud_telemetry·from genkit.telemetry import configure_instrumentation·from genkit_otel import GenAiInstrumentation - MCP (Client & Host):
from genkit_mcp import define_mcp_client, define_mcp_host, McpClient, McpHost - Testing & Mocks:
from genkit.testing import define_echo_model, define_scripted_model, EchoModel, ScriptedModel - Evaluators (0.13 only; cut from 1.0, additive later):
from genkit_evaluators import register_genkit_evaluators·from genkit.evaluator import BaseDataPoint, EvaluatorResponse, Score, ScoreDetails, ScoreStatus
Workflow
- Agent or flow? Use
ai.define_agent(ongenkit.exp.Genkit, see Agents) for multi-turn chats, state, or human-in-the-loop approval instead of hand-rolling a message loop inside a flow. Use@ai.flow()ongenkit.Genkitfor stateless request/response or streaming pipelines. - Configure credentials & model refs. Set
GEMINI_API_KEY. Prefer typed refs (GoogleAI.gemini('gemini-flash-latest')) and typed flat configs (GeminiConfig(...)) so your type checker validates fields before runtime. Prefixed strings ('googleai/gemini-flash-latest') also work. - Enter via
ai.run_main(main())for standalone scripts and CLI apps so the process stays up for the Dev UI undergenkit start. FastAPI apps skiprun_main; uvicorn keeps the process alive:genkit start -- uv run uvicorn main:app --reload. - Run with Dev Workflow (
genkit start+ Dev UI) and type-check withpyright,mypy, orty. - Verify with traces, not a blind
uv run. See Genkit CLI. - Stuck? Check Gotchas, Common Errors, or Migrating from 0.12 to 0.13.
Gotchas
- Agents need
genkit.exp:from genkit.exp import Genkit. Stablegenkit.Genkithas nodefine_agent. - Tools are async:
@ai.tool()raisesTypeErroron a plaindef; useasync def. - Check
response.error: provider failures come back on the response, not as exceptions (see Hello World). - Gemini thinking levels:
GeminiConfig(thinking_level='MINIMAL')fails ongemini-flash-latest; use'LOW','MEDIUM', or'HIGH'. - Vertex AI model IDs: Vertex does not serve
-latestaliases. Pass a pinned model ID toVertexAI.gemini(...). - Logging:
genkit.get_loggeris structlog-based.enable_google_cloud_telemetry()injects trace context for GCP log-trace correlation. - Cloud telemetry auth: call
enable_google_cloud_telemetry()with Application Default Credentials or explicitcredentials=(service account dict orCredentialsinstance).
Genkit CLI (recommended)
genkit start wraps any Python program that uses Genkit, capturing traces from
every action while forwarding stdio cleanly. Running uv run directly skips
trace capture.
Primary pattern (persistent server + Dev UI):
genkit start -- uv run src/main.py
genkit start --noui -- uv run src/main.py # persistent runtime without opening the Dev UI
genkit start runs until stopped with Ctrl+C (even with --noui). Do not
run genkit start as a blocking step in automated/non-interactive scripts; use
flow:run instead.
Non-interactive use (agents/CI): pass --non-interactive before -- so the
CLI never blocks on prompts:
genkit start --non-interactive -- uv run src/main.py
One-shot flow execution (flow:run): spins up the runtime, invokes one
@ai.flow() by name, prints a Trace ID, and exits:
genkit flow:run myFlow '{"data": "input"}' -- uv run src/main.py
Note: flow:run invokes flows (@ai.flow()), not agents (ai.define_agent).
Wrap a single agent turn in a helper flow to exercise it via flow:run (see
Agents).
Inspecting traces:
genkit trace:list # list recent trace IDs
genkit trace:get <traceId> # human-readable trace inspection
genkit trace:get <traceId> --format json # machine-readable JSON for jq / scripts
Always pass --format json when piping into jq or other parsers.
See Dev Workflow for the full pre-run checklist and Dev UI walkthrough.
References
- Migrating from 0.12 to 0.13:
Deterministic 0.12 -> 0.13 renames, config flattening,
PublicError, andexpmoves. - Examples: Structured output, streaming, media parts, flows, tools, interrupts, cancellation, embeddings.
- Setup: Project bootstrap with
uv, version alignment, and provider plugins. - Common Errors: Fast fixes for 0.13 validation errors, HTTP 500 redaction, streaming, and sessions.
- FastAPI:
serve_flow,serve_agent,PublicError, SSE streaming, and parallel flows. - Dotprompt:
.promptfiles, schema validation, variants, partials, and helpers. - Evals: 0.13 evaluator syntax (deprecated; removed in 1.0).
- Dev Workflow:
genkit start, Dev UI, and trace verification checklist. - Agents (Experimental): Multi-turn stateful agents
(
genkit.exp).
이 스킬의 파일
18developing-genkit-python skill 질문
Claude Code에 developing-genkit-python skill을 어떻게 설치하나요?
npx degit genkit-ai/skills/skills/developing-genkit-python ~/.claude/skills/developing-genkit-python를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
developing-genkit-python skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
Genkit에서 멀티턴 에이전트를 어떻게 실행하나요?
멀티턴 에이전트는 현재 실험적 기능이며 genkit.exp 모듈에서 제공됩니다.