export GOOGLE_API_KEY='your_key'

export GOOGLE_GENAI_USE_VERTEXAI=trueexport GOOGLE_CLOUD_PROJECT='your-project-id'export GOOGLE_CLOUD_LOCATION='global'

gcloud auth application-default login

uv pip install git+https://github.com/google-agentic-commerce/AP2.git@main

cd AP2

bash samples/python/scenarios/your-scenario-name/run.sh

bash samples/android/scenarios/digital-payment-credentials/run.sh

cd samples/go/scenarios/a2a/human-present/cardsbash run.sh

// Copyright 2025 Google LLCpackage main
import (    "log"    "github.com/google-agentic-commerce/ap2/samples/go/pkg/common"    "github.com/google-agentic-commerce/ap2/samples/go/pkg/roles/merchant_agent")
const (    MerchantAgentPort = 8001    RPCURL            = "/a2a/merchant_agent")
func main() {    // 加载代理卡片配置    agentCard, err := common.LoadAgentCard("pkg/roles/merchant_agent")    if err != nil {        log.Fatalf("Failed to load agent card: %v", err)    }
    // 创建商户代理执行器    executor := merchant_agent.NewMerchantAgentExecutor(agentCard.Capabilities.Extensions)
    // 启动代理服务器    server := common.NewAgentServer(MerchantAgentPort, agentCard, executor, RPCURL)
    if err := server.Start(); err != nil {        log.Fatalf("Server error: %v", err)    }}

# Copyright 2025 Google LLC"""An A2A Agent Executor for the credentials provider agent."""
from typing import Anyfrom . import toolsfrom common.base_server_executor import BaseServerExecutorfrom common.system_utils import DEBUG_MODE_INSTRUCTIONS
class CredentialsProviderExecutor(BaseServerExecutor):    """AgentExecutor for the credentials provider agent."""        _system_prompt = """    You are a credentials provider agent acting as a secure digital wallet.    Your job is to manage a user's payment methods and shipping addresses.        Based on the user's request, identify their intent and select the    single correct tool to use. Your only output should be a tool call.    Do not engage in conversation.        %s    """ % DEBUG_MODE_INSTRUCTIONS
    def __init__(self, supported_extensions: list[dict[str, Any]] = None):        """Initializes the CredentialsProviderExecutor."""        agent_tools = [            tools.handle_create_payment_credential_token,            tools.handle_get_payment_method_raw_credentials,            tools.handle_get_shipping_address,            tools.handle_search_payment_methods,            tools.handle_signed_payment_mandate,            tools.handle_payment_receipt,        ]        super().__init__(supported_extensions, agent_tools, self._system_prompt)

# Copyright 2025 Google LLC"""Contains the definitions of the Agent Payments Protocol mandates."""
from datetime import datetimefrom datetime import timezonefrom typing import Optionalfrom pydantic import BaseModel, Field
class IntentMandate(BaseModel):    """Represents the user's purchase intent."""        user_cart_confirmation_required: bool = Field(        True,        description="If false, the agent can make purchases on the user's behalf"    )    natural_language_description: str = Field(        ...,        description="The natural language description of the user's intent"    )    merchants: list[str] = Field(default_factory=list)    skus: list[str] = Field(default_factory=list)    requires_refundability: bool = Field(False)    intent_expiry: str = Field(        default_factory=lambda: (            datetime.now(timezone.utc).replace(hour=0, minute=0, second=0, microsecond=0) +             timedelta(days=1)        ).isoformat()    )

// Copyright 2025 Google LLCpackage types
type PaymentCurrencyAmount struct {    Currency string  `json:"currency"`    Value    float64 `json:"value"`}
type PaymentItem struct {    Label        string                `json:"label"`    Amount       PaymentCurrencyAmount `json:"amount"`    Pending      *bool                 `json:"pending,omitempty"`    RefundPeriod int                   `json:"refund_period,omitempty"`}
type PaymentRequest struct {    MethodData      []PaymentMethodData `json:"method_data"`    Details         PaymentDetailsInit  `json:"details"`    Options         *PaymentOptions     `json:"options,omitempty"`    ShippingAddress *ContactAddress     `json:"shipping_address,omitempty"`}