本文档介绍了如何配置 Agent Gateway for Google Kubernetes Engine (GKE),以管理和保护在 GKE 集群上运行的自管理 AI 智能体的出站(出站流量)流量。
如需建立完整的出站流量数据路径,您需要结合使用多个 Google Cloud 和 GKE 网络服务。此设置会通过安全正向代理路由代理流量,该代理会强制执行您的政策并清理内容。
如需保护出站代理流量,请完成以下步骤:
- 启用 GKE 环境代理。
- 创建 Secure Web Proxy。
- 配置 mTLS 身份验证。
- 创建出站流量 Agent Gateway。
- 在 GKE 中配置出站流量重定向。
- 配置授权和内容安全政策。
如需详细了解此架构,请参阅 GKE 上的 Agent Gateway 概览。
准备工作
在配置出站流量治理之前,请完成以下前提条件:
- 完成 GKE 上的 Agent Gateway 概览中的常见前提条件。
工作负载配置:向 Agent Registry 注册工作负载,并使用 SPIFFE 身份部署工作负载。将以下内容保存为
agent.yaml,并将其应用于您的集群:apiVersion: v1 kind: ServiceAccount metadata: name: KSA_NAME namespace: NAMESPACE --- apiVersion: apps/v1 kind: Deployment metadata: name: AGENT_NAME namespace: NAMESPACE labels: # Identifies the workload as an AI agent registry.gke.io/functional-type: "AGENT" spec: replicas: 1 selector: matchLabels: app: AGENT_NAME template: metadata: labels: app: AGENT_NAME annotations: # Indicates that the agent uses Agent Identity iam.gke.io/spiffe-identity-type: "agent-identity" # To assign an agent identity and per-Pod credentials to a workload iam.gke.io/identity: "spiffe://TRUST_DOMAIN/*" spec: serviceAccountName: KSA_NAME containers: - name: curl image: curlimages/curl:8.10.1 command: ["sleep", "infinity"]替换以下内容:
KSA_NAME:Kubernetes 服务账号的名称。NAMESPACE:服务账号的命名空间。AGENT_NAME:代理部署的名称。AGENT_IMAGE:代理的容器映像。CONTAINER_NAME:代理容器的名称。ORG_ID:您的 Google Cloud 组织的 ID。
启用 GKE 环境代理
为了重定向来自智能体的流量,Agent Gateway 使用了无边车的 GKE 环境代理。
按照为 Ambient Networking 准备集群中的说明准备集群。
为代理工作负载创建命名空间:
kubectl create namespace NAMESPACE将
NAMESPACE替换为命名空间的名称,例如agent-ns。将 Ambient 标签添加到包含代理工作负载的命名空间:
kubectl label namespace NAMESPACE networking.gke.io/dataplane-mode=ambient将
NAMESPACE替换为代理命名空间的名称,例如agent-ns。
创建 Secure Web Proxy
如需强制执行安全政策并执行 Agent Gateway 护栏所需的 TLS 检查,您必须预配安全 Web 代理 (SWP) 以及必要的证书、证书授权机构 (CA) 池和网关安全政策。
创建代理专用子网。Secure Web Proxy 要求每个区域和 VPC 网络有一个活跃的代理专用子网。如果您的网络在您所在区域已有活跃的代理专用子网,则可以跳过此步骤。
gcloud compute networks subnets create PROXY_SUBNET_NAME \ --purpose=REGIONAL_MANAGED_PROXY \ --role=ACTIVE \ --region=REGION \ --network=NETWORK \ --range=10.10.0.0/24替换以下内容:
PROXY_SUBNET_NAME:子网的名称,例如gateway-subnet。REGION:子网的区域。NETWORK:您的 VPC 网络的名称。
生成自签名证书和私钥:
openssl req -x509 -newkey rsa:2048 -nodes \ -keyout CERT_KEY_FILE.key \ -out CERT_FILE.crt \ -days CERT_VALIDITY_DAYS \ -subj "/CN=SWP_HOSTNAME" \ -addext "subjectAltName=DNS:SWP_HOSTNAME"替换以下内容:
CERT_KEY_FILE和CERT_FILE:私钥和证书的本地文件名,例如swp。CERT_VALIDITY_DAYS:证书的有效期,例如365。SWP_HOSTNAME:代理证书的主机名,例如swp.example.internal。(代理不会通过此名称连接到代理,因此任何内部名称都可用于测试)。
将证书上传到与 SWP 位于同一区域的 Certificate Manager:
gcloud certificate-manager certificates create CERTIFICATE_NAME \ --location=REGION \ --certificate-file=CERT_FILE.crt \ --private-key-file=CERT_KEY_FILE.key替换以下内容:
CERTIFICATE_NAME:证书的名称,例如swp-cert。REGION:证书的区域。CERT_FILE和CERT_KEY_FILE:您之前创建的证书和私钥的本地文件名。
创建 CA 池和根 CA:
gcloud privateca pools create CA_POOL_NAME \ --location=REGION \ --tier=devops gcloud privateca roots create ROOT_CA_NAME \ --pool=CA_POOL_NAME \ --location=REGION \ --subject="CN=CA_COMMON_NAME, O=ORGANIZATION" \ --key-algorithm=rsa-pkcs1-4096-sha256 \ --max-chain-length=1 \ --auto-enable替换以下内容:
CA_POOL_NAME:CA 池的名称,例如swp-ca-pool。ROOT_CA_NAME:根 CA 的名称,例如swp-root-ca。CA_COMMON_NAME:CA 的通用名称,例如swp-ca。ORGANIZATION:组织的名称,例如My Company。
允许网络安全服务代理从池中颁发证书:
gcloud beta services identity create --service=networksecurity.googleapis.com gcloud privateca pools add-iam-policy-binding CA_POOL_NAME \ --location=REGION \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-networksecurity." \ --role=roles/privateca.certificateManager替换以下内容:
PROJECT_NUMBER:您的项目编号。将PROJECT_NUMBER替换为您的项目编号。REGION:CA 池的区域。CA_POOL_NAME:CA 池的名称。
导出 CA 证书。TrustConfig 会在后续步骤中使用此信息:
gcloud privateca pools get-ca-certs CA_POOL_NAME \ --location=REGION \ --output-file=CA_CERT_FILE.pem替换以下内容:
CA_POOL_NAME:CA 池的名称。REGION:CA 池的区域。- 将
CA_CERT_FILE替换为证书的本地文件名,例如swp-ca-cert。
创建 TLS 检查政策。
将以下内容保存为
tls-inspection.yaml:name: projects/PROJECT_ID/locations/REGION/tlsInspectionPolicies/TLS_INSPECTION_POLICY_NAME caPool: projects/PROJECT_NUMBER/locations/REGION/caPools/CA_POOL_NAME导入政策:
gcloud network-security tls-inspection-policies import TLS_INSPECTION_POLICY_NAME \ --location=REGION \ --source=tls-inspection.yaml替换以下内容:
TLS_INSPECTION_POLICY_NAME替换为 TLS 检查政策的名称,例如swp-tls-inspection。REGION:政策的区域。CA_POOL_NAME:CA 池的名称。PROJECT_NUMBER:您的项目编号。
根据导出的 CA 证书生成 TrustConfig 并将其导入:
{ echo "trustStores:"; echo "- trustAnchors:"; echo " - pemCertificate: |"; \ sed 's/^/ /' CA_CERT_FILE.pem; } > trust-config.yaml gcloud certificate-manager trust-configs import TRUST_CONFIG_NAME \ --location=REGION \ --source=trust-config.yaml替换以下内容:
TRUST_CONFIG_NAME:信任配置的名称,例如swp-trust-config。REGION:信任配置所在的区域。CA_CERT_FILE:您之前导出的 CA 证书的本地文件名。
创建网关安全政策和“全部允许”规则:
将该政策保存为
swp-policy.yaml:name: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME description: POLICY_DESCRIPTION tlsInspectionPolicy: projects/PROJECT_NUMBER/locations/REGION/tlsInspectionPolicies/TLS_INSPECTION_POLICY_NAME导入政策:
gcloud network-security gateway-security-policies import POLICY_NAME \ --location=REGION \ --source=swp-policy.yaml将规则保存为
rule.yaml:name: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME/rules/RULE_NAME priority: RULE_PRIORITY enabled: true sessionMatcher: "SESSION_MATCHER" applicationMatcher: "APPLICATION_MATCHER" basicProfile: ALLOW tlsInspectionEnabled: true导入规则:
gcloud network-security gateway-security-policies rules import RULE_NAME \ --gateway-security-policy=POLICY_NAME \ --location=REGION \ --source=rule.yaml
为 mTLS 创建服务器 TLS 政策。将以下内容保存为
server-tls.yaml:name: projects/PROJECT_ID/locations/REGION/serverTlsPolicies/SERVER_TLS_POLICY_NAME allowOpen: false mtlsPolicy: clientValidationMode: ALLOW_INVALID_OR_MISSING_CLIENT_CERT clientValidationTrustConfig: projects/PROJECT_NUMBER/locations/REGION/trustConfigs/TRUST_CONFIG_NAME导入政策:
gcloud network-security server-tls-policies import SERVER_TLS_POLICY_NAME \ --location=REGION \ --source=server-tls.yaml替换以下内容:
SERVER_TLS_POLICY_NAME:政策的名称,例如swp-server-tls。TRUST_CONFIG_NAME:您之前创建的 TrustConfig 的名称(例如swp-trust-config)。
创建 Secure Web Proxy。
将以下清单保存为
swp.yaml:name: projects/PROJECT_ID/locations/REGION/gateways/SWP_NAME type: SECURE_WEB_GATEWAY addresses: ["IP_ADDRESS"] ports: [443, 80] certificateUrls: ["projects/PROJECT_ID/locations/REGION/certificates/CERTIFICATE_NAME"] serverTlsPolicy: projects/PROJECT_ID/locations/REGION/serverTlsPolicies/SERVER_TLS_POLICY_NAME gatewaySecurityPolicy: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME network: projects/PROJECT_ID/global/networks/NETWORK subnetwork: projects/PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK routingMode: EXPLICIT_ROUTING_MODE导入代理:
gcloud network-services gateways import SWP_NAME \ --source=swp.yaml \ --location=REGION
替换以下内容:
IP_ADDRESS:代理的 IP 地址。CERTIFICATE_NAME:您之前创建的 Certificate Manager 证书的名称(例如swp-cert)。NETWORK:VPC 网络的名称。SUBNETWORK:子网的名称。EXPLICIT_ROUTING_MODE:路由模式。对于 Agent Gateway,此字段必须为EXPLICIT_ROUTING_MODE。SERVER_TLS_POLICY_NAME:服务器 TLS 政策的名称。
配置 mTLS 身份验证
如需对 GKE 环境代理与 Secure Web Proxy 之间的流量进行身份验证,请配置双向 TLS (mTLS)。使用 Workload Identity Federation for GKE 时,您的 Workload Identity Federation for GKE 池已配置默认共享证书授权机构 (CA)。
如需验证此配置,请运行以下命令:
gcloud iam workload-identity-pools describe PROJECT_ID. \
--location=global \
--format="yaml(inlineCertificateIssuanceConfig)"
将 PROJECT_ID 替换为您的项目 ID。
在输出中,验证 useDefaultSharedCa 是否已设置为 true。预期输出结果类似如下所示:
inlineCertificateIssuanceConfig:
keyAlgorithm: ECDSA_P256
lifetime: 86400s
rotationWindowPercentage: 50
useDefaultSharedCa: true
如果 useDefaultSharedCa: true 缺失或设置为 false,请运行以下命令进行配置:
gcloud iam workload-identity-pools update PROJECT_ID. \
--location=global \
--use-default-shared-ca
创建出站流量 Agent Gateway
在 Agent Platform 中创建出站 Agent Gateway 资源,并将其连接到 Secure Web Proxy。
将以下清单保存为名为
agent-gateway.yaml的文件:name: GATEWAY_NAME protocols: - MCP registries: ["//agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION"] selfManaged: resourceUris: - "projects/PROJECT_ID/locations/REGION/gateways/SWP_NAME"替换以下内容:
- 将
GATEWAY_NAME替换为网关的名称,例如my-agent-egress-gateway。 PROJECT_ID:您的 Google Cloud 项目 ID。REGION:网关所在的区域。SWP_NAME:Secure Web Proxy 的名称。
- 将
创建网关:
gcloud beta network-services agent-gateways import GATEWAY_NAME \ --source=agent-gateway.yaml \ --location=REGION替换以下内容:
GATEWAY_NAME:Gateway 的名称,例如my-agent-egress-gateway。REGION:网关所在的区域。
如需验证 AgentGateway 资源是否已创建,请描述 Gateway:
gcloud beta network-services agent-gateways describe GATEWAY_NAME \ --location=REGION替换以下内容:
GATEWAY_NAME:Gateway 的名称,例如my-agent-egress-gateway。REGION:网关所在的区域。
在 GKE 中配置出站流量重定向
如需将出站智能体流量路由到 Secure Web Proxy,请为 GKE 环境代理定义代理的位置。
将以下清单保存为名为
swp-backend.yaml的文件。您必须在代理工作负载所在的命名空间中创建GCPBackend资源。如果 Secure Web Proxy 与集群位于同一 VPC 中,请使用网关 URI:
apiVersion: networking.gke.io/v1 kind: GCPBackend metadata: name: swp-backend namespace: NAMESPACE spec: serviceUris: - "//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/gateways/SWP_NAME"或者,如果您的代理位于其他 VPC 中并使用 Private Service Connect,请使用服务连接 URI:
apiVersion: networking.gke.io/v1 kind: GCPBackend metadata: name: swp-backend namespace: NAMESPACE spec: serviceUris: - "//compute.googleapis.com/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME"替换以下内容:
NAMESPACE:代理工作负载的命名空间。PROJECT_ID:您的 Google Cloud 项目 ID。REGION:代理或服务连接的区域。SWP_NAME:代理的名称(适用于同一 VPC 设置)。ATTACHMENT_NAME:Private Service Connect 服务连接的名称(适用于跨 VPC 设置)。
将清单应用到您的集群:
kubectl apply -f swp-backend.yaml获取集群的 Service IPv4 CIDR 范围:
gcloud container clusters describe CLUSTER_NAME \ --location=LOCATION \ --format="value(ipAllocationPolicy.servicesIpv4Cidr)"替换以下内容:
CLUSTER_NAME:GKE 集群的名称。LOCATION:集群的位置。
将以下清单保存为名为
egress-policy.yaml的文件:apiVersion: networking.gke.io/v1 kind: GCPEgressPolicy metadata: name: prod-egress-policy namespace: NAMESPACE spec: to: excludeCIDRRanges: - SERVICE_CIDR - VPC_CIDR proxyRef: group: networking.gke.io kind: GCPBackend name: swp-backend替换以下内容:
SERVICE_CIDR:上一步中的集群 Service CIDR,例如34.118.224.0/20。VPC_CIDR:不应通过代理的其他内部范围,例如10.0.0.0/8。
如需防止内部流量(例如与 Kubernetes 控制平面的通信)通过代理进行路由,请使用
excludeCIDRRanges字段。将清单应用到您的集群:
kubectl apply -f egress-policy.yamlGKE Ambient 数据平面现在会将出站流量从代理命名空间路由到 Secure Web Proxy,以便强制执行政策。
(可选)部署测试客户端
如需验证出站流量政策是否正常运行,您可以部署一个具有已注册 SPIFFE 身份的测试代理(正控制)和一个没有身份的普通客户端(负控制)。
将以下清单保存为
agents.yaml:apiVersion: v1 kind: ServiceAccount metadata: name: agent-sa namespace: NAMESPACE --- apiVersion: apps/v1 kind: Deployment metadata: name: test-agent namespace: NAMESPACE labels: registry.gke.io/functional-type: "AGENT" spec: replicas: 1 selector: matchLabels: app: test-agent template: metadata: labels: app: test-agent annotations: iam.gke.io/spiffe-identity-type: "agent-identity" iam.gke.io/identity: "spiffe://agents.global.org-ORG_ID.system.id.goog/*" spec: serviceAccountName: agent-sa containers: - name: curl image: curlimages/curl:8.10.1 command: ["sleep", "infinity"] --- apiVersion: apps/v1 kind: Deployment metadata: name: plain-client namespace: NAMESPACE spec: replicas: 1 selector: matchLabels: app: plain-client template: metadata: labels: app: plain-client spec: containers: - name: curl image: curlimages/curl:8.10.1 command: ["sleep", "infinity"]替换以下内容:
NAMESPACE:您的代理命名空间。ORG_ID:您的 Google Cloud 组织的 ID。
应用部署并等待其就绪:
kubectl apply -f agents.yaml kubectl rollout status deploy/test-agent deploy/plain-client -n NAMESPACE将 Secure Web Proxy CA 证书复制到两个 Pod 中,以便它们在测试期间通过代理安全连接:
B64=$(base64 -w0 CA_CERT_FILE.pem) for p in test-agent plain-client; do kubectl exec -i -n NAMESPACE deploy/"$p" -- sh -c "cat > /tmp/swp-ca.pem" < CA_CERT_FILE.pem done将
CA_CERT_FILE替换为您在 Secure Web Proxy 设置期间导出的 CA 证书的本地名称。
配置授权和内容安全政策
如需强制执行访问权限控制并清理内容,请将出站流量转发到扩展服务(例如 Identity-Aware Proxy (IAP) 或 Model Armor),然后再将其发送到目的地。
然后,您可以将授权委托给 IAP 或自定义授权引擎,并将内容清理委托给 Model Armor。
将授权委托给 IAP
如需使用 IAP 为出站请求授权,请将扩展程序绑定到网关。
将以下匹配条件保存为名为
match.yaml的文件,以定义哪些流量路由到 IAP。例如,如需在测试期间评估流向 example.com 的流量,请执行以下操作:name: ext-binding producerExtension: iap.googleapis.com target: resources: - "//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/agentGateways/GATEWAY_NAME" matchConditions: # invoke IAP for traffic to example.com for testing - to: destination: hosts: - exact: "example.com"导入扩展程序绑定:
gcloud beta service-extensions extension-bindings import my-iap-binding \ --source=match.yaml \ --location=REGION将
REGION替换为扩展程序绑定的区域。如需验证 IAP 响应,请运行以下测试命令:
echo -n "no identity -> example.com: "; kubectl exec -n NAMESPACE deploy/plain-client -- curl -s -o /tmp/b -w "%{http_code} " --cacert /tmp/swp-ca.pem https://example.com/; kubectl exec -n NAMESPACE deploy/plain-client -- head -c 120 /tmp/b; echo echo -n "agent -> example.com: "; kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -o /tmp/b -w "%{http_code} " --cacert /tmp/swp-ca.pem https://example.com/; kubectl exec -n NAMESPACE deploy/test-agent -- head -c 120 /tmp/b; echo echo -n "agent -> www.google.com (no IAP match): "; kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -o /dev/null -w "%{http_code}\n" --cacert /tmp/swp-ca.pem https://www.google.com/预期输出:
- 无身份 → example.com:401,正文…错误代码 1200(无令牌)
- agent → example.com:200(示例网域 HTML)。绑定 IAP 后,您可能会在 IAP 传播期间先看到 403“出站流量请求未经授权”错误,持续约 1-2 分钟。
- 代理 → www.google.com:200(绑定不匹配,因此跳过 IAP)
将内容安全防护工作委托给 Model Armor
为了防范出站流量中的提示注入和敏感数据泄露,您可以将 Google Cloud Model Armor 绑定到出站网关。
向 Agent Gateway 服务账号或 Service Extensions 服务账号授予所需角色。
gcloud projects add-iam-policy-binding MODEL_ARMOR_PROJECT_ID \ --member="serviceAccount:SERVICE_ACCOUNT" \ --role="roles/modelarmor.calloutUser" gcloud projects add-iam-policy-binding MODEL_ARMOR_PROJECT_ID \ --member="serviceAccount:SERVICE_ACCOUNT" \ --role="roles/serviceusage.serviceUsageConsumer" gcloud projects add-iam-policy-binding MODEL_ARMOR_PROJECT_ID \ --member="serviceAccount:SERVICE_ACCOUNT" \ --role="roles/modelarmor.user"替换以下内容:
MODEL_ARMOR_PROJECT_ID:Model Armor 所在项目的 ID。SERVICE_ACCOUNT:网关的服务账号。
创建 Model Armor 模板,以过滤敏感数据和提示词注入攻击。我们的后续验证步骤依赖于此配置:
gcloud model-armor templates create TEMPLATE_NAME \ --location=REGION \ --basic-config-filter-enforcement=enabled \ --pi-and-jailbreak-filter-settings-enforcement=enabled \ --pi-and-jailbreak-filter-settings-confidence-level=MEDIUM_AND_ABOVE将
TEMPLATE_NAME替换为模板的名称,例如safety-template。如需获取新模板的完整资源路径(扩展程序绑定步骤需要用到),请运行以下命令:
gcloud model-armor templates describe TEMPLATE_NAME \ --location=REGION \ --format="value(name)"将
REGION替换为模板所在的区域。将以下匹配条件保存为名为
model-armor-match.yaml的文件,以便在测试期间评估流向 www.google.com 的流量:- to: destination: hosts: - exact: "www.google.com"将 Model Armor 绑定到您的网关:
gcloud beta service-extensions extension-bindings create my-model-armor-binding \ --location=REGION \ --producer-extension="modelarmor.REGION.rep.googleapis.com" \ --target-resources="//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/agentGateways/GATEWAY_NAME" \ --fail-open \ --match-conditions=model-armor-match.yaml \ --producer-metadata=model_armor_settings='[{"request_template_id":"projects/TEMPLATE_PROJECT_ID/locations/REGION/templates/REQUEST_TEMPLATE","response_template_id":"projects/TEMPLATE_PROJECT_ID/locations/REGION/templates/RESPONSE_TEMPLATE"}]'替换以下内容:
REGION:Agent Gateway 所在的区域。绑定和 Model Armor 提供方扩展程序必须使用同一区域,并且 Model Armor 必须在该区域中可用。不接受其他区域和全球modelarmor.googleapis.com端点。PROJECT_ID:您的 Google Cloud 项目 ID。GATEWAY_NAME:Agent Gateway 的名称。TEMPLATE_PROJECT_ID、REQUEST_TEMPLATE和RESPONSE_TEMPLATE:Model Armor 模板的详细信息。模板必须在REGION中创建。如果该区域中不存在模板,则匹配的请求会失败,并显示 HTTP 404“未找到”错误。
注意:默认情况下,绑定会失败关闭(如果 Model Armor 不可用,请求会被屏蔽)。
--fail-open标志允许在无法访问扩展程序时传输流量。如需验证 Model Armor 是否在过滤请求,请运行以下测试命令:
SENS='{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deploy-html","arguments":{"value":"<html> card 4111111111111111</html>"}}}' BEN='{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deploy-html","arguments":{"value":"Hello, how are you?"}}}' kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -w " HTTP=%{http_code}\n" --cacert /tmp/swp-ca.pem -X POST -H 'Content-Type: application/json' -d "$SENS" "https://www.google.com/" kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -o /dev/null -w "HTTP=%{http_code}\n" --cacert /tmp/swp-ca.pem -X POST -H 'Content-Type: application/json' -d "$BEN" "https://www.google.com/"预期输出:
- sensitive:
403{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"Traffic blocked by MA security policy."}],"isError":true}} - benign:
405(来源;它到达了 www.google.com)
- sensitive:
将授权委托给自定义扩展程序
除了 IAP 之外,您还可以使用自定义扩展程序来委托授权决策。如需了解详情,请参阅提供方:构建和发布扩展程序,以创建适当的 ProducerExtension 和 ExtensionBinding。
问题排查
如果您遇到连接问题,请验证以下配置:
- API:验证项目中是否已启用所有必需的 API。
- 命名空间标签:验证您的代理命名空间是否具有
networking.gke.io/dataplane-mode=ambient标签。 - 自定义资源:验证
GCPBackend和GCPEgressPolicy自定义资源是否已成功应用,且与智能体位于同一命名空间中。
后续步骤
- 如需监控智能体的流量和行为,请参阅监控 Agent Gateway 流量。
- 如需解决连接或政策问题,请参阅排查 Agent Gateway 问题。