GEMINI：エージェントの副作用・復旧・人への引継ぎ

Source SHA-256 04f5eaeda52c15531872a9ebe646eafe7cd7fc8c0a7b196e7c8bee64cb3839de

PRODUCT_MAPPING_ID: PM-GEMINI-CORE-05-v0.1

PROVIDER: GEMINI

CORE_PACKET: PKT-GEMINI-A-CORE-05-v0.1

AS_OF: 2026-09-06 23:02 JST

STATUS: PUBLIC_ACTION_SURFACES_MAPPED / CONFIRMATION_AND_RESUME_LIMITS_EXPLICIT / TENANT_VALUES_UNKNOWN

LAYER: PRODUCT_MAPPING (not Enterprise AI Core; not Organization Overlay)

CORE-05のread/write境界、confirmation、idempotency、recovery、undo、human escalationを、Gemini Apps、Gemini API、ADK、Vertex AI系runtimeへ対応づける。公開機能の存在を、trusted approval、exactly-once、external readback、完全undo、tenant採用の証拠へ昇格しない。CORE-05のlocal 26/26 profileはprovider-neutral reference implementationとして保持し、Gemini製品保証には転用しない。

• ROW: PM-C05-GEM-001; Core contract: read/write boundary / action class; Gemini surface / current evidence: Gemini Appsのconnected-app action、Gemini API function call、ADK Tool実行は別surfaceである。Gemini APIではmodelがfunction name/argumentsを返し、実行はapplication責任と明記される; Mapping decision: model proposal / application execution / external receipt / final-state readback / business acceptanceを別eventにする。Apps UIのaction完了表示をAPI/ADK runtime保証へ横展開しない; Required verification / UNKNOWN: Apps/Gem/API/ADK/Vertexのtenant採用、許可tool、credential、実receipt/readbackはUNKNOWN

• ROW: PM-C05-GEM-002; Core contract: confirmation / approval binding; Gemini surface / current evidence: ADK Tool ConfirmationはExperimentalで、boolean、advanced payload、REST responseを提供する。公開docsはPython v1.14.0、TypeScript v0.2.0、Go v0.3.0、Kotlin v0.1.0のsupport floorを示す; Mapping decision: dialog、hint、payload、confirmed flagの存在はcanonical operation、trusted renderer、digest binding、理解率を証明しない。action summaryはapplication側でtyped fieldsから生成し、target/argument/source変更時に再承認する; Required verification / UNKNOWN: 実UI表示順、sanitize、summary digest、timeout、fatigue、reviewer identity/competenceはUNKNOWN

• ROW: PM-C05-GEM-003; Core contract: session / confirmation continuity; Gemini surface / current evidence: ADK confirmation docsはResume併用時に同じinvocation_idを返す必要を明記し、異なるIDでは新しいinvocationが始まる。DatabaseSessionServiceとVertexAiSessionServiceはconfirmation非対応とされる; Mapping decision: confirmation receiptへinvocation/session/operation IDを結び、session backendをcompatibility matrixで事前除外する。unsupported backendで暗黙fallbackしない; Required verification / UNKNOWN: hosted/deployed構成の実support、永続性、failover後のapproval continuityはUNKNOWN

• ROW: PM-C05-GEM-004; Core contract: retry / at-least-once recovery; Gemini surface / current evidence: ADK Resumeは停止workflowのcompleted eventを復元する一方、toolは少なくとも1回、場合により複数回実行されるため、purchase等はtool側で重複防止するよう明記する。ADK Web UI/CLIからのresumeは現時点で非対応; Mapping decision: operation ID、parameter digest、dedup retention、attempt history、external readbackをapplication/toolへ実装する。resume/retryをexactly-onceとみなさず、COMMIT_UNKNOWNの非冪等toolは停止する; Required verification / UNKNOWN: remote key/mutation atomicity、dedup TTL、late arrival、external reconciliation/compensationは製品横断UNKNOWN

• ROW: PM-C05-GEM-005; Core contract: pre/post tool guard; Gemini surface / current evidence: ADKのbefore_tool_callbackはtool/argsを検査・変更し、override resultで実行をskipでき、after_tool_callbackは結果を扱える; Mapping decision: callbackをpolicy/argument validation/telemetry hookとして使えるが、自動的なleast privilege、trusted approval、receipt、source-of-truth readbackにはしない。callback return semantics自体をfixed-version testへ含める; Required verification / UNKNOWN: 採用callback順序、例外時挙動、並列時のatomicity、audit completenessはUNKNOWN

• ROW: PM-C05-GEM-006; Core contract: confirmation + parallel + resume counterevidence; Gemini surface / current evidence: open issue #6732はADK 2.7.0 + Postgres session + parallel gated/ungated tool条件で、confirmation pause後にungated sibling結果が失われ、確認済み破壊的toolは実行済み、final replyは空になり得ると報告する; Mapping decision: 限定構成のfailure signalとして採用する。同一side-effect/approval groupは固定版でfault testするまでserial既定とし、空応答を未実行扱いせずexternal readbackする; Required verification / UNKNOWN: issueの現行status、root cause、fix version、他backend/modelへの適用性はUNKNOWN。Gemini全体の欠陥とは主張しない

• ROW: PM-C05-GEM-007; Core contract: undo / residual side effect; Gemini surface / current evidence: Gemini AppsのCalendar helpはaction後のUndo導線を示す一方、event変更時にguestへ送られたemail等はundo不能で、background Gemini Liveで作成したeventもGeminiからundoできないと明記する; Mapping decision: UI UndoをFULLへ昇格せず、primary stateとsecondary effectを別々にread backする。undo不能または期限不明ならPARTIAL/UNKNOWNとし、manual recoveryを提示する; Required verification / UNKNOWN: tenantでのCalendar availability、通知発生条件、undo window、guest側残留、audit eventはUNKNOWN

• ROW: PM-C05-GEM-008; Core contract: human escalation / agent UI; Gemini surface / current evidence: Gemini Appsのmulti-step agent系公開helpはplan/progress、confirmation、stop/take-control等のUIを示すが、experimental/plan/region依存のproduct surfaceであり、全Gemini Apps・Enterprise・Gem・ADKの共通保証ではない; Mapping decision: visible plan/confirmation/stopをoperational affordanceとしてのみ記録し、trusted digest、meaningful oversight、external final-state verificationの代用にしない; Required verification / UNKNOWN: 業務tenant availability、admin policy、reviewer role、risk threshold、action log、readback能力はUNKNOWN

• VERIFIED_PUBLIC_SPEC: Google一次資料。function execution責任、ADK confirmation/resume/callback、Apps action/undoをaccess date付きで固定する。

• EXPERIMENTAL_PRODUCT_SURFACE: public help/docs上でexperimentalまたは限定supportのsurface。一般提供・tenant採用へ昇格しない。

• AUTHOR_MAINTAINED_FAILURE_SIGNAL: google/adk-python issue #6732。限定版・backend・parallel構成として保持する。

• PINNED_LOCAL_REFERENCE: CORE-05 local fault profile 26/26。Gemini/ADKの実装試験ではない。

• SAFE_UI_OBSERVATION: CORE-02で収録したbusiness Gemini新規chat・synthetic prompt。action/tool/confirmationは未実行で、回答表面だけを支える。

• UNKNOWN: tenant availability、remote atomicity、dedup TTL、approval UI effectiveness、external readback、undo残差、organization thresholdを推測で閉じない。

• Gemini API function calling: <https://ai.google.dev/gemini-api/docs/function-calling> (accessed 2026-09-06)

• ADK Tool Confirmation: <https://adk.dev/tools-custom/confirmation/> (Experimental; accessed 2026-09-06)

• ADK callback types: <https://adk.dev/callbacks/types-of-callbacks/> (accessed 2026-09-06)

• ADK Resume: <https://adk.dev/runtime/resume/> (accessed 2026-09-06)

• ADK issue #6732: <https://github.com/google/adk-python/issues/6732> (opened 2026-08-15; ADK 2.7.0 report; read 2026-09-06)

• Gemini Apps Calendar actions and undo limits: <https://support.google.com/gemini/answer/15305236> (accessed 2026-09-06)

• Gemini Apps multi-step agent help: <https://support.google.com/gemini/answer/16596215> (accessed 2026-09-06; availability/branding treated as volatile)

• CORE-05 local reference: tests/CORE-05_approval_nonidempotent_fault_result_v0.1.json

• CORE-02 UI observation: tests/CORE-02_gemini_interactive_ui_surface_result_2026-09-05.json

Gemini action surfaceをApps/API/ADK/runtimeへ分離し、confirmationのexperimental/support境界、Resumeのat-least-once risk、session backend非対応、Calendar undo残差、限定構成のopen failure signalを記録した。公開仕様からtrusted approval、exactly-once、remote atomicity、tenant adoptionを推定しない。PM-GEMINI-CORE-05は公開証拠範囲でbounded closeし、組織値はORG-CORE-05へ残す。