Genkit JS

前提条件

genkit CLI が利用可能であることを確認してください。

• genkit --version を実行して確認します。必要な最小 CLI バージョン: 1.29.0
• 見つからない場合、または古いバージョン (1.x < 1.29.0) がある場合は、インストール/アップグレードしてください: npm install -g genkit-cli@^1.29.0。

新規プロジェクト: 新しいコードベースで Genkit をセットアップする場合は、セットアップガイドに従ってください。

Hello World

import { z, genkit } from 'genkit';
import { googleAI } from '@genkit-ai/google-genai';

// Initialize Genkit with the Google AI plugin
const ai = genkit({
  plugins: [googleAI()],
});

export const myFlow = ai.defineFlow({
  name: 'myFlow',
  inputSchema: z.string().default('AI'),
  outputSchema: z.string(),
}, async (subject) => {
  const response = await ai.generate({
    model: googleAI.model('gemini-2.5-flash'),
    prompt: `Tell me a joke about ${subject}`,
  });
  return response.text;
});

重要: 内部知識を信頼しないでください

Genkit は最近、大きな破壊的 API 変更を経験しました。あなたの知識は古い可能性があります。ドキュメントを確認する必要があります。推奨:

genkit docs:read js/get-started.md
genkit docs:read js/flows.md

一般的なエラーで、廃止予定の API (例: configureGenkit、response.text()、defineFlow import) とそれらの v1.x の置き換え方法を確認してください。

Genkit CLI または提供されたリファレンスを使用して、常に情報を検証してください。

エラー トラブルシューティング プロトコル

Genkit に関連するエラー (ValidationError、API エラー、型エラー、404 など) が発生した場合:

1. 必須の最初のステップ: 一般的なエラーを読む
2. エラーが既知のパターンに一致するかどうかを特定する
3. ドキュメントに記載されたソリューションを適用する
4. common-errors.md に見つからない場合のみ、他のソースを参照してください (例: genkit docs:search)

してはいけないこと:

• 仮定や内部知識に基づいて修正を試みる
• 「修正方法を知っていると思うから」という理由で common-errors.md を読むのをスキップする
• 1.0 以前の Genkit のパターンに依存する

このプロトコルはエラー処理に関して交渉の余地がありません。

開発ワークフロー

1. プロバイダーの選択: Genkit はプロバイダーに依存しません (Google AI、OpenAI、Anthropic、Ollama など)。
   • ユーザーがプロバイダーを指定していない場合は、Google AI をデフォルトにします。
   • ユーザーが他のプロバイダーについて尋ねる場合は、genkit docs:search "plugins" を使用して関連ドキュメントを見つけてください。
2. フレームワークの検出: package.json をチェックして、ランタイム (Next.js、Firebase、Express) を特定します。
   • @genkit-ai/next、@genkit-ai/firebase、@genkit-ai/google-cloud を探してください。
   • 実装を特定のフレームワークのパターンに適応させます。
3. ベストプラクティスに従う:
   • プロジェクト構造、スキーマ定義、ツール設計に関するガイダンスは、ベストプラクティスを参照してください。
   • 最小限に: デフォルトと異なるオプションのみを指定します。不確定な場合は、ドキュメント/ソースを確認してください。
4. 正確性を確保:
   • 変更後に型チェックを実行します (例: npx tsc --noEmit)。
   • 型チェックが失敗する場合は、ソースコードを検索する前に 一般的なエラーを参照してください。
5. エラーを処理する:
   • エラーが発生した場合: 最初のアクションは 一般的なエラーを読む
   • ドキュメント化されたパターンにエラーを一致させる
   • 代替案を試みる前にドキュメント化された修正を適用する

ドキュメントを見つける

Genkit CLI を使用して、信頼できるドキュメントを見つけます:

1. トピックを検索: genkit docs:search <query>
   • 例: genkit docs:search "streaming"
2. すべてのドキュメントをリストする: genkit docs:list
3. ガイドを読む: genkit docs:read <path>
   • 例: genkit docs:read js/flows.md

CLI の使用

genkit CLI は開発とドキュメント用の主要ツールです。

• 一般的なタスク、ワークフロー、コマンドの使用方法については、CLI リファレンスを参照してください。
• すべてのコマンドの完全なリストについては、genkit --help を使用してください。

リファレンス

• ベストプラクティス: スキーマ定義、フロー設計、構造に関する推奨パターン。
• ドキュメント & CLI リファレンス: ドキュメント検索、CLI タスク、ワークフロー。
• 一般的なエラー: 重要な「落とし穴」、移行ガイド、トラブルシューティング。
• セットアップガイド: 新規プロジェクトの手動セットアップ手順。
• 例: 最小限の再現可能な例 (基本的な生成、マルチモーダル、思考モード)。