GGua 日本語リファレンスEnglishGitHub ↗
英語版が正式な参照です。内容に差異がある場合は、英語版を優先してください。
GUIDE / AGENT POLICY

AIエージェントのゲームプレイに必要な情報だけを公開する

エージェント公開ポリシーは、AIエージェントプレイヤーに見せてよいUI・World情報と、許可するUI操作をゲーム側で決める仕組みです。開発者向けDebug情報は残したまま、隠しobject、内部値、Debug logなどをAIへ渡さない安全な公開Viewを作ります。

AIへ情報を渡すすべての経路に同じルールを使う

安全な公開Viewは、tree取得、検索、状態変化の待機、diagnostics、Recording/Replay、UI操作の許可判定に共通して使われます。非公開にしたobjectは、AIからは存在しないobjectと同じように見えます。UI操作はゲームが実行する直前にも再確認するため、sceneやpolicyが変わった後に古い権限が残りません。

何を見せ、何を隠すか決める

Object単位で隠す

UIまたはWorldのsubtreeをprivateにすると、そのobjectと子objectをAIエージェントプレイヤーへ公開しません。UIは親を含めて表示中であること、World objectはplayer visibilityとactiveな親も必要です。

Field単位で情報を減らす

omitで項目を消す、redactで伏せる、型を保ったreplaceや数値quantizeで詳細度を下げる、といった変換ができます。許可するUI actionもallowlistで限定できます。

Engine設定

Godot UI controlではgua_agent_exposuregua_agent_field_rulesgua_agent_allowed_actionsを使い、World objectでは対応するgua_world_agent_* metadataを使います。UnityではuGUIまたはWorld objectへGuaAgentPolicyComponentを追加し、UI Toolkit/custom adapterはpolicyをregistryへ登録します。

見せてよい情報と、操作してよいゲーム入力は別に許可する

エージェント公開ポリシー

AIエージェントプレイヤーが見られるUI・World情報と、押してよいUI buttonなどを決めます。

ゲーム入力の権限

AIがjumpmoveを実行できるか、キーボードやマウスを直接操作できるかを別に決めます。

たとえば、AIへ敵の位置を見せても、自動的にキャラクターを動かせるようにはなりません。逆に、開発者用Debug Inspectorでkeyboard入力を有効にしても、WebMCPなどのAIエージェントプレイヤーには引き継がれません。ゲーム側でPlayer向けSemantic Game Actionを明示的に許可し、Raw Inputはdevice入力の検証が必要な場合だけ個別に許可します。