SuperAPI AI 工具集

agentcore-websearch

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:通过用户 AWS 账户内的私有 MCP 网关调用 AgentCore Web Search 工具进行联网搜索,使用 agentcore-websearch CLI,认证依赖本地 AWS 凭证(SigV4/IAM),无需 API 密钥或令牌。

主要能力:返回有依据、带引用、时效性强的搜索结果;支持指定结果数量、输出原始 JSON、列出网关工具。

使用方式:该技能仅负责搜索,前提是 CLI 已安装且 AgentCore Gateway 已存在,并设置 AGENTCORE_GATEWAY_URL(环境变量或 .env)。首次使用先做预检:用 command -v agentcore-websearch 确认 CLI 在 PATH;用 echo "AGENTCORE_GATEWAY_URL=${AGENTCORE_GATEWAY_URL:-<empty>}" 确认变量在当前 shell 生效;用 aws sts get-caller-identity 确认签名身份。随后运行 agentcore-websearch --list-tools 做端到端验证。搜索命令为 agentcore-websearch "<search query>",查询须不超过 200 字符。选项:--max-results N(1–25,默认 10)、--json、--list-tools、--gateway-url/--profile/--region。回答中必须引用来源(标题+URL)。

适用场景:需要联网检索并给出可引用来源的问答或研究任务。

限制:本技能不创建或删除 AWS 资源;网关位于 us-east-1,CLI 自动按主机区域签名;费用约每 1000 次查询 7 美元(每次搜索计一次查询);调用方 IAM 主体需具备 bedrock-agentcore:InvokeGateway 权限。常见错误包括变量未设置、凭证缺失或过期、权限不足、命令未找到(可用 uv tool install git+https://github.com/aws-samples/sample-agentcore-websearch-agent-skill 安装)。