📚

Agentspace を Custom Runtime で構築した Agent Engine で拡張する

2025/09/12に公開

 tl;drAgent Engine の Custom Runtime を使用することで、標準では含まれないバイナリ（FFmpeg、Playwright 等）を含むエージェントエンジンをデプロイできます。
Setup Script でバイナリをインストールし、デプロイ時に設定を追加することでエージェントを拡張することが可能です。

 はじめにこの blog では、Agentspace を使用したエージェント開発について書きます。AI エージェントの開発環境は日々進化しており、適切なツールとフレームワークの選択が開発の効率と品質に影響すると考えています。
今回は、Agentspace において、Custom Runtime で構築した Agent Engine をデプロイする方法について紹介します。

 Agentspace の概要Agentspace については、以前作成した記事を参照してください。
https://zenn.dev/dannya/articles/5e77aacc0a311d

 Custom Runtime で Agent Engine のデプロイAgent Engine の Runtime は Agent Developer Kit などの Framework で実装されたエージェントを実行できるよう構成されています。一方で、エージェント内で画像変換やブラウザ操作などを実行したい場合があります。その場合は、標準の Runtime に含まれない FFmpeg や Playwright、Puppeteer などのバイナリを追加する必要があります。そこで必要になるのが Custom Runtime です。
Agent Engine を Custom Runtime でデプロイするには、以下の手順を実行します。
Setup Script の作成: Binary をインストールする Script を作成します。
ポイントは環境変数で PLAYWRIGHT_BROWSERS_PATH を設定してインストールすることです。
install.sh
#!/bin/bash
set -e
apt-get update
apt-get install -y python3 python3-pip
pip3 install playwright
export PLAYWRIGHT_BROWSERS_PATH=/opt/playwright-browsers
playwright install-deps
playwright install chromium firefox webkit
デプロイ Script の作成: Setup Script をデプロイ Script から実行するようにします。
ポイントは環境変数（ PLAYWRIGHT_BROWSERS_PATH ）を設定することです。インストールされたバスの Browser を指定しないと、実行時にエラーとなります。 BrowserType.launch: Executable doesn't exist at /home/appuser/.cache/ms-playwright/chromium_headless_shell-1187/chrome-linux/headless_shell
deploy.py
    remote_app = agent_engines.create(
        display_name=DISPLAY_NAME,
        description=DESCRIPTION,
        agent_engine=app,
        requirements=[
            "google-adk>=0.1.0",
            "google-cloud-aiplatform[adk,agent-engines]>=1.88.0",
            "playwright>=1.40.0",
            "python-dotenv>=1.0.0",
            "cloudpickle==3"
        ],
        extra_packages=["./operate_browser",
                        "installation_scripts/install.sh"],
        build_options={"installation_scripts": [
            "installation_scripts/install.sh"]},
        env_vars={
            "PLAYWRIGHT_BROWSERS_PATH": "/opt/playwright-browsers"
        }
    )

デプロイ: 設定が完了したら、エージェントをデプロイします。
これで、Custom Runtime 上でエージェントが実行されるようになります。

 Summary本記事では、Agentspace で Custom Runtime を使用してエージェントエンジンをデプロイする方法を紹介しました。Custom Runtime を活用することで、エージェントの活動範囲を大きく広げることができます。

 Closing経営課題の解決に向けた AI エージェントの社会実装に注力する。

GitHubで編集を提案

tl;dr

はじめに

Agentspace の概要

Custom Runtime で Agent Engine のデプロイ

Summary

Closing

Discussion