用途:该技能用于让用户或智能体与 Google Address Validation 数据交互。Google Address Validation 是一项验证和标准化邮政地址的服务,开发者用它提升地址准确度、减少投递错误、改善需要地址输入的应用体验。官方文档:https://developers.google.com/maps/documentation/address-validation/overview
主要能力:核心为地址验证(Validates the address)。通过 Membrane CLI 与该服务交互,Membrane 负责认证与凭据自动刷新,用户无需自行处理鉴权流程。可用自然语言意图搜索动作,运行动作或直接通过代理发送请求。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;非交互环境会打印授权 URL,完成后用 membrane login complete <code>。添加 --json 可获得机器可读输出。建立连接:membrane connection ensure "https://mapsplatform.google.com/intl/en/maps-products/address-validation/" --json,用户需在浏览器完成认证;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,参数用 --input '{"key": "value"}'。动作不覆盖时可用代理:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
最佳实践:优先使用 Membrane 预构建动作以获得内置认证、分页与错误处理;先发现再构建,避免直接写原始 API 调用;不要向用户索要 API 密钥或令牌,改由连接管理凭据。
限制:资料未提供具体动作清单、配额、计费价格或平台支持细节;地址验证的实际字段与返回结构需以官方文档为准。