Cloud Run に LangChain エージェントをデプロイする

1. 概要

エージェントは、AI モデルと対話して、エージェントが持つツールとコンテキストを使用して目標ベースの操作を実行する自律型プログラムです。真実に基づいた自律的な意思決定を行うことができます。

Agent Development Kit（ADK）、LangChain、smolagents などのエージェントフレームワークは、エージェントの作成に使用されます。このようなフレームワークで作成されたエージェントアプリケーションは Cloud Run にデプロイでき、サーバーレスアプリケーションとしてユーザーが利用できるようになります。

この Codelab では、LangChain を使用してエージェントを構築し、Cloud Run にデプロイします。

作成するアプリの概要

プロトタイププロンプトからエージェントの構築に移行する準備はできましたか？LangChain を使用して、歴史上の人物に関する情報を構造化された形式で取得するエージェントを作成します。このラボでは、次の作業を行います。

LangChain を使用して、歴史上の人物に関する情報を構造化された形式で生成するシンプルなエージェントを構築する
エージェントをローカルで実行し、想定どおりに動作することを確認する
エージェントを Cloud Run にデプロイし、Cloud Run URL を使用して呼び出す

要件

ブラウザ（Chrome、Firefox など）
課金を有効にした Google Cloud プロジェクト

2. 始める前に

プロジェクトを作成する

Google Cloud コンソールのプロジェクト選択ページで、Google Cloud プロジェクトを選択または作成します。
Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
このリンクをクリックして、Cloud Shell を有効にします。Cloud Shell で対応するボタンをクリックすると、Cloud Shell ターミナル（クラウドコマンドの実行用）とエディタ（プロジェクトのビルド用）を切り替えることができます。
Cloud Shell に接続したら、次のコマンドを使用して、すでに認証済みであることと、プロジェクトがプロジェクト ID に設定されていることを確認します。

gcloud auth list

Cloud Shell で次のコマンドを実行して、gcloud コマンドがプロジェクトを認識していることを確認します。

gcloud config list project

プロジェクトが設定されていない場合は、次のコマンドを使用して設定します。

gcloud config set project <YOUR_PROJECT_ID>

Python 3.13 以降がインストールされていることを確認する

他の gcloud コマンドとその使用方法については、ドキュメントをご覧ください。

3. LangChain エージェントの作成

プロジェクト構造

Cloud Shell で、langchain-app という名前のフォルダを作成し、その中に次のファイルを追加します。

langchain-gemini-fastapi-app/
├── main.py
├── requirements.txt

アプリケーションコード

requirements.txt に追加する必要がある依存関係は次のとおりです。

fastapi
uvicorn
langchain
langchain-google-genai
python-dotenv

main.py では、Gemini モデルを使用して歴史上の人物に関する情報を取得するエージェントコードを記述します。取得したら、指示どおりに構造化された形式にフォーマットします。

この実装では、最新の LCEL（LangChain Expression Language）構文を使用しています。

import os
import uvicorn
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from langchain_google_genai import ChatGoogleGenerativeAI
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.output_parsers import JsonOutputParser

# Initialize FastAPI
app = FastAPI(title="LangChain App for Historical Figures")

# 1. Setup Gemini Model
# We expect GOOGLE_API_KEY to be set in the environment variables
llm = ChatGoogleGenerativeAI(
    model="gemini-2.5-flash",
    temperature=0.7
)

# 2. Define the Prompt
prompt = ChatPromptTemplate.from_template("You are an expert Historian. For the historical personality {name}, you are able to accurately tell their birth date and birth country. Return the output in the JSON format containing name, birthDate, birthCountry. In case you are unable to retrieve birthDate or birthCountry, just have the unknown values as null. ensure the response is a valid json object only.")
output_parser = JsonOutputParser()

# Chain: Prompt -> Model -> Json Output Parser
chain = prompt | llm | output_parser

# 3. Define Request Model
class QueryRequest(BaseModel):
    name: str

# 4. Define Endpoint
@app.post("/chat")
async def chat(request: QueryRequest):
    try:
        response = await chain.ainvoke({"name": request.name})
        return response
    except Exception as e:
        raise HTTPException(status_code=500, detail=str(e))

@app.get("/")
def health_check():
    return {"status": "ok", "service": "LangChain-Gemini-FastAPI"}

4. エージェントをテストする

デプロイする前に、ローカルでテストできます。

AI Studio で Gemini API キーを作成します。
Gemini API キーを次のようにエクスポートします。

export GOOGLE_API_KEY="AIzaSy..."

サーバーを実行します。

uvicorn main:app --port 8080 --host 0.0.0.0

次の curl コマンドを使用して、エージェントをテストします。

curl -X POST http://localhost:8080/chat \
     -H "Content-Type: application/json" \
     -d '{"name": "Abraham Lincoln"}'

name、birthDate、birthCountry を含む JSON 構造化出力が取得されていることを確認します。

5. Cloud Run にデプロイする

gcloud run deploy コマンドを使用して、エージェントアプリケーションを Cloud Run にデプロイします。次のコマンドは、Cloud Build を使用してコンテナをビルドし、1 つのステップで Cloud Run にデプロイします。

YOUR_API_KEY は、実際の Gemini API キーに置き換えます。

gcloud run deploy gemini-fastapi-service \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars GOOGLE_API_KEY=<YOUR_API_KEY>

デプロイが完了すると、ターミナルにエンドポイントが表示され、使用できるようになります。

6. Deployment をテストする

Cloud Run エンドポイントを使用して curl を実行し、期待どおりの結果が得られることを確認します。

curl -X POST <CLOUD_RUN_ENDPOINT> \
     -H "Content-Type: application/json" \
     -d '{"name": "Abraham Lincoln"}'

ローカルで実行したアプリケーションと同じ結果が得られるはずです。

7. クリーンアップ

この Codelab で使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。

Google Cloud コンソールで、[リソースの管理] ページに移動します。
プロジェクトリストで、削除するプロジェクトを選択し、[削除] をクリックします。
ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。

8. 完了

おめでとうございます！Cloud Run にデプロイされた LangChain エージェントを作成して操作できました。