Google AI Studio で APIキーを取得

• ブラウザで Google AI Studio (aistudio.google.com) を開きます。
• 左メニューの「Get API key」→「Create API key」を実行します。
• 発行された文字列をコピーします。これは鍵そのものなので、共有・コミットは厳禁です。

Colab の userdata (Secrets) にキーを登録

• Colab を開き、左サイドバーの 🔑 アイコン (Secrets) をクリックします。
• 「+ Add new secret」で新規シークレットを追加します。
• Name に GOOGLE_API_KEY、Value にコピーした鍵を入力し、「Notebook access」をオンにします。

ノートブックの先頭で読み込む

• 全レッスンのノートブックは、Setupセクションの先頭で次のセルを実行する規約です。
• userdata.get で取得し、環境変数 GOOGLE_API_KEY に流すと、PydanticAI が自動でこの値を見つけます。

from google.colab import userdata
import os
os.environ['GOOGLE_API_KEY'] = userdata.get('GOOGLE_API_KEY')

PydanticAI を pip install

• 本ガイドのレッスンノートブックでは、最初に必要なパッケージを 1 行でインストールします。
• Colab はセッションごとに環境がリセットされるため、毎回必要です。

!pip install -q "pydantic-ai" "pydantic-ai-guide-helpers"

最初の Agent を動かす

• ここまで通れば、Ch0-L01「初Agent」のノートブックが動くはずです。
• 次のセルを実行し、日本語の応答が返ってくれば、セットアップは完了です。

from pydantic_ai import Agent

agent = Agent(
    'google-gla:gemini-3-flash-preview',
    instructions='あなたは親切なPydanticAIガイド役です。日本語で答えてください。',
)

result = agent.run_sync('PydanticAIのAgentを一言で説明して')
print(result.output)