Getting Started

Playable!Mobile を理解するために、Getting Started を実施してみましょう。

はじめに

Playable!Mobile の自動テストを体験するために、サンプルゲームを用意しています。
このサンプルゲームは、Playable!Mobile Unity Plugin を導入済みですので、すぐに自動テストを体験することができます。

Plugin の導入方法については、こちらを参照してください。

導入準備

playable general agent for mobileのダウンロード

Playable! のマイページ からファイルをダウンロードしてください。
ダウンロードが完了したら、任意のディレクトリに解凍してください。

サンプルゲームのダウンロード

こちらからサンプルゲームをダウンロードしてください。

ファイルをダウンロードしたら、任意のディレクトリに解凍してください。

LLMの設定

LLM を利用するため、事前に利用するプロバイダーの情報 (API key 等) をご用意ください。

Playable General Agent for Mobile では、以下のプロバイダーを利用することができます。

• OpenAI
• Azure OpenAI Service
• Anthropic

ダウンロードしたPlayable General Agent for Mobileのディレクトリにある settings_provider.yaml を編集し、利用するプロバイダーの情報を設定してください。

# settings_provider.yaml
openai:  # OpenAI
  api_key: ""  # sk-xxxx
  organization: ""  # org-xxxx
azure:  # Azure OpenAI Service
  api_key: ""  # 32桁の16進数
  endpoint: ""  # https://?????????.openai.azure.com
  deploy_name: ""  # デプロイ名
anthropic:  # Anthropic (Claude)
  api_key: ""  # sk-xxxx

利用しないプロバイダーはそのままで大丈夫です。

セットアップ

playable general agent for mobile の起動

General Agent Mobile のディレクトリ内にある general_agent_mobile.exe を起動してください。

起動すると、上記の画面が表示されます。

左上の「設定」ボタンをクリックし、一般にあるLLMをご自身の環境に合わせて設定してください。

ゲームバイナリの設定

ゲームバイナリの「選択」ボタンをクリックし、サンプルゲームの実行ファイルを選択してください。
「開始」を押すことで、サンプルゲームが起動し、Playable!Mobile と連携されます。

ゲームが起動し、ゲームとの接続状態が「CONNECTED」と表示されれば、準備完了です。

サンプルゲームの自動テスト

対話型インターフェースの「指示文」に、テストしたい操作を入力することで、自動テストを実行することができます。

サンプルゲームでは、タイトル画面とホーム画面が用意されており、それぞれのボタンが用意されております。
(サンプルゲームについては、詳しくはこちらをご覧ください。)

タイトル画面

• ホーム画面遷移ボタン
• ライセンス表示ボタン

ホーム画面

• ホームボタン（遷移なし）
• プレイヤーボタン
  • 名前変更
  • メッセージ変更
• オプションボタン
  • タイトル遷移

指示文の入力

指示文を入力し、「実行」を押すことで、自動テストが実行されます。

LLM の応答の完了判定が「完了」と表示されれば、自動テストが完了です。

• 指示文の例

ホーム画面に遷移

プレイヤーボタンを選択して、名前を「Test」に変更

テストシーケンスの活用

Excel ファイルを用いることで、実行したいテストシーケンスを一括で実行することができます。

「自動チェック」タブを選択し、「テストシーケンス」にダウンロードファイルに同梱されてあるsample.xlsxを選択してください。
「シーケンスを実行」を押すことで、Excelファイルに記述されたテストシーケンスを自動で実行することができます。

高度な機能

知識グラフの自動生成

知識グラフ(Knowledge Graph)とは、ゲーム内情報やゲームの操作に関する知識を記憶させることで、より効率的な自動テストを実現する機能です。

左上の「設定」ボタンをクリックし、知識グラフの設定を行うことができます。
「知識グラフ」を選択し、「Build Knowledge Graph When Task Succsess」にチェックを入れることで、自動テスト成功時に、下図のように知識グラフを自動生成することができます。

また、生成された知識グラフを手動で編集することや、「空の知識を追加」から新たな知識を手動で追加することも可能です。

画面遷移グラフの自動生成

画面遷移グラフ（Experimental）を選択していただき、「探索開始」を押すことで、画面遷移グラフを自動生成することができます。

画面遷移グラフの生成を行うと、遷移先として生成された画面遷移に対して、LLMを利用せずに遷移を行うことができるようになります。
これにより、APIコスト無しで画面遷移を行うことができます。

ログファイルの確認

General Agent Mobile 内にある log ディレクトリに、ログファイルが出力されます。

ログファイルについてはこちらを参照してください。

次のステップ

チュートリアルは以上となります。 自社タイトルへの組み込みについては、各ページのマニュアルを参照してください。

また、AIQVE ONE株式会社では導入のご支援や組み込み代行、テスト設計や Playable! の活用方法についてのコンサルティング業務を承っております。 ご興味がある方は以下のWebサイトもしくは公式 Discord からお問い合わせください。

• Web サイトからのお問い合わせ
• 公式 Discord