Genkit Go

Genkit Go は Go 用の AI SDK であり、生成、構造化出力、ストリーミング、ツール呼び出し、プロンプト、フローを複数のモデルプロバイダー間で統一されたインターフェースで提供します。

Hello World

package main

import (
	"context"
	"fmt"
	"log"
	"net/http"

	"github.com/genkit-ai/genkit/go/ai"
	"github.com/genkit-ai/genkit/go/genkit"
	"github.com/genkit-ai/genkit/go/plugins/googlegenai"
	"github.com/genkit-ai/genkit/go/plugins/server"
)

func main() {
	ctx := context.Background()
	g := genkit.Init(ctx, genkit.WithPlugins(&googlegenai.GoogleAI{}))

	genkit.DefineFlow(g, "jokeFlow", func(ctx context.Context, topic string) (string, error) {
		return genkit.GenerateText(ctx, g,
			ai.WithModelName("googleai/gemini-flash-latest"),
			ai.WithPrompt("Tell me a joke about %s", topic),
		)
	})

	mux := http.NewServeMux()
	for _, f := range genkit.ListFlows(g) {
		mux.HandleFunc("POST /"+f.Name(), genkit.Handler(f))
	}
	log.Fatal(server.Start(ctx, "127.0.0.1:8080", mux))
}

コア機能

必要なものに応じて、適切なリファレンスを確認してください:

機能	リファレンス	いつロードするか
初期化	references/getting-started.md	genkit.Init のセットアップ、プラグイン、*Genkit インスタンスパターン
生成	references/generation.md	Generate、GenerateText、GenerateData、ストリーミング、出力フォーマット
プロンプト	references/prompts.md	DefinePrompt、DefineDataPrompt、.prompt ファイル、スキーマ
ツール	references/tools.md	DefineTool、ツール割り込み、RestartWith/RespondWith
ミドルウェア	references/middleware.md	ai.Middleware、ai.WithUse、Hooks (Generate/Model/Tool)、ビルトイン (Retry、Fallback、ToolApproval、Filesystem、Skills)
フロー & HTTP	references/flows-and-http.md	DefineFlow、DefineStreamingFlow、genkit.Handler、HTTP サーバリング
モデルプロバイダー	references/providers.md	Google AI、Vertex AI、Anthropic、OpenAI 互換、Ollama セットアップ

Genkit CLI

インストール済みか確認: genkit --version

インストール:

curl -sL cli.genkit.dev | bash

主要コマンド:

# Developer UI (トレーシング、フロー テスト) を使ってアプリを開始 (http://localhost:4000)
genkit start -- go run .
genkit start -o -- go run .   # ブラウザも開く

# CLI から直接フローを実行
genkit flow:run myFlow '{"data": "input"}'
genkit flow:run myFlow '{"data": "input"}' --stream   # ストリーミング付き
genkit flow:run myFlow '{"data": "input"}' --wait      # 完了を待機

# Genkit ドキュメントを検索
genkit docs:search "streaming" go
genkit docs:list go
genkit docs:read go/flows.md

詳細な CLI と Developer UI については references/getting-started.md を参照してください。

主要なガイダンス

• g を明示的に渡す。 genkit.Init が返す *Genkit インスタンスは中央レジストリです。グローバルに保存するのではなく、すべての Genkit 関数に渡します。これは SDK 全体での中心的なパターンです。
• AI ロジックをフローでラップする。 フローはトレーシング、可観測性、genkit.Handler 経由の HTTP デプロイ、Developer UI と CLI からのテスト機能を提供します。保持する価値のある生成呼び出しはフローの中に配置してください。
• 出力型に jsonschema:"description=..." struct タグを使用する。 モデルはこれらの説明を使用して、各フィールドに何を含めるべきかを理解します。これらがなければ、構造化出力の品質が大幅に低下します。
• 優れたツール説明を書く。 モデルは説明文字列に基づいてどのツールを呼び出すかを決定します。曖昧な説明は、ツール呼び出しの欠落または誤った呼び出しにつながります。
• 複雑なプロンプトには .prompt ファイルを使用する。 プロンプト コンテンツを Go コードから分離し、Handlebars テンプレートをサポートし、再コンパイルなしで反復できます。コード定義プロンプトはシンプルなワンライナーのケースに適しています。
• カスタムミドルウェアを書く前に、ビルトインミドルウェアに手を出す。 Retry、Fallback、ToolApproval、Filesystem、Skills は一般的な横断的ニーズをカバーし、ai.WithUse を通じて相互に構成できます。references/middleware.md を参照してください。カスタムミドルウェアを書く場合は、New でキャプチャされたクロージャ内で呼び出しごとの状態を割り当て、WrapTool が変異するものを保護してください。ツールは並行して実行される場合があるからです。
• 最新のモデル ID を確認する。 モデル名は頻繁に変更されます。ハードコードされた名前に頼るのではなく、プロバイダーのドキュメントで現在のモデル ID を確認してください。references/providers.md を参照してください。