En vivo 18.11 · Cohorte 318 nov, 19:00 MSK — taller práctico gratuito de agentes IA · Cohorte 3 en vivo inicia 23.11Taller 18 nov →Cohorte 3 (23.11)
LanzamientoCódigo / SDK · Listo para usarAWS Machine Learning Blog→ original

AWS abre la Web Search API para agentes: una llamada, sin gateway ni claves

Antes, la búsqueda web en Amazon Bedrock AgentCore funcionaba solo a través de AgentCore Gateway: había que crear un gateway, un destino de búsqueda y pasar por un cliente MCP. Ahora existe una llamada directa InvokeWebSearch desde el SDK o la CLI con la firma IAM habitual. Resulta cómodo si el agente está escrito con LangChain o ni siquiera es un agente, sino un script.

Procesado por IA desde AWS Machine Learning Blog; editado por Hamidun News
AWS abre la Web Search API para agentes: una llamada, sin gateway ni claves
Fuente: AWS Machine Learning Blog. Collage: Hamidun News.
Escuchar artículo
Ficha técnica y cifras clave
ParámetroDatos
Fuente originalAWS Machine Learning Blog ↗
Editor jefe
Una llamadahasta 25 resultados con texto, título, URL y fecha
Dato clave #2Filtros por dominios (hasta 100 en la lista) y por fecha de publicación
Límite por defecto10 solicitudes por segundo por región

El modelo no sabe qué pasó la semana pasada. Para que un agente responda sobre lanzamientos, precios o leyes recientes, necesita búsqueda. AWS ya tenía esa búsqueda, pero solo a través de AgentCore Gateway: creas un gateway, añades un destino de búsqueda web y llamas a la herramienta desde un cliente MCP. Para un equipo de plataforma con reglas comunes esto es adecuado. Para un desarrollador que solo necesita resultados de búsqueda, es una capa de más.

Ahora AWS ha lanzado una Web Search API independiente. Es la operación InvokeWebSearch en el data plane del servicio bedrock-agentcore. No hace falta crear nada de antemano: tomas las credenciales de IAM, llamas y obtienes los resultados.

Cómo se ve en la práctica

En Boto3 es un único método, invoke_web_search. Se pasa una cadena de consulta (hasta 200 caracteres), un número de resultados de 1 a 25 y filtros. Por ejemplo, se puede limitar la búsqueda a los dominios aws.amazon.com y kubernetes.io y pedir páginas publicadas después del 1 de enero de 2026. La respuesta es una lista ordenada por relevancia. Cada resultado tiene un fragmento de texto, mientras que el título, la URL y la fecha de publicación aparecen si el índice los conoce. Por eso hay que leerlos con get y no por clave.

La autenticación se hace mediante SigV4, es decir, no hay claves de API. Si el código se ejecuta en Lambda, ECS, EC2 o EKS, basta con añadir al rol un permiso: bedrock-agentcore:InvokeWebSearch sobre el recurso administrado web-search.v1. Es el mismo permiso que usa el rol de servicio del gateway, así que una sola política cubre ambas vías.

También se puede probar sin código: en CloudShell basta un comando, aws bedrock-agentcore invoke-web-search. Para Python se necesita Boto3 1.43.127 o posterior.

Dónde resulta útil

AWS menciona varios escenarios en los que el gateway es excesivo:

  • un bucle de agente propio o frameworks como LangChain y LlamaIndex;
  • tareas que no son de agentes: dashboards, verificación de datos, enriquecimiento de contenido, monitorización;
  • casos en que quieres gestionar tú mismo los reintentos, la caché y los errores;
  • aplicaciones que ya tienen su propia capa de API.

Para LangChain hay un toolkit listo en langchain-aws 1.9.3 y posteriores. Permite fijar reglas que el modelo no puede cambiar: dominios excluidos, un límite inferior de fecha y un presupuesto de búsqueda. Es útil cuando no quieres que el agente amplíe por su cuenta el alcance de la búsqueda. También hay un envoltorio WebSearchClient en AgentCore Python SDK 1.26.0.

Seguridad y limitaciones

El argumento principal para los equipos corporativos es que las consultas las atiende un índice gestionado por Amazon y no se envían a un buscador de terceros. El mismo índice respalda Alexa+, Kiro y Quick. El acceso se regula mediante IAM y SCP, y las llamadas pueden pasar por PrivateLink sin salir a internet. Con la condición aws:SourceVpce se puede permitir la búsqueda solo desde tu VPC.

Hay matices:

  • CloudTrail registra las llamadas como data events, pero están desactivados por defecto. Hay que añadir manualmente un selector para el recurso AWS::BedrockAgentCore::WebSearch. El texto de la consulta y los filtros no aparecen en los registros.
  • El límite por defecto es de 10 solicitudes por segundo por región y cuenta. Para pipelines masivos habrá que solicitar un aumento.
  • Las condiciones de uso obligan a conservar y mostrar los enlaces a las fuentes junto con los resultados. Si tu producto oculta las fuentes, es un problema.
  • Los endpoints de VPC de tipo interfaz se facturan con las tarifas estándar de PrivateLink.
  • El índice es de Amazon, así que conviene comprobar la cobertura y la frescura con tus propias consultas antes de abandonar Brave, Tavily o Bing.

Qué hacer

Si ya estás en AWS y quieres añadir web grounding a un agente, empieza por la API directa: son cinco minutos y no hace falta desplegar un gateway. Si tienes muchos agentes y una política común de herramientas, el gateway sigue siendo la opción. Para comparar con otras API de búsqueda, ejecuta el mismo conjunto de consultas en ambas y, en producción, activa de inmediato los data events de CloudTrail y limita los dominios en el toolkit.

Historia

Preguntas frecuentes sobre la noticia

Cómo se ve en la práctica?

En Boto3 es un único método, invoke_web_search. Se pasa una cadena de consulta (hasta 200 caracteres), un número de resultados de 1 a 25 y filtros. Por ejemplo, se puede limitar la búsqueda a los dominios aws.amazon.com y kubernetes.io y pedir páginas publicadas después del 1 de enero de 2026. La respuesta es una lista ordenada por relevancia. Cada resultado tiene un fragmento de texto, mientras que el título, la URL y la fecha de publicación aparecen si el índice los conoce.

Dónde resulta útil?

AWS menciona varios escenarios en los que el gateway es excesivo: un bucle de agente propio o frameworks como LangChain y LlamaIndex; tareas que no son de agentes: dashboards, verificación de datos, enriquecimiento de contenido, monitorización; casos en que quieres gestionar tú mismo los reintentos, la caché y los errores; aplicaciones que ya tienen su propia capa de API. Para LangChain hay un toolkit listo en langchain-aws 1.9.3 y posteriores.

¿Qué se sabe sobre Seguridad y limitaciones?

El argumento principal para los equipos corporativos es que las consultas las atiende un índice gestionado por Amazon y no se envían a un buscador de terceros. El mismo índice respalda Alexa+, Kiro y Quick. El acceso se regula mediante IAM y SCP, y las llamadas pueden pasar por PrivateLink sin salir a internet. Con la condición aws:SourceVpce se puede permitir la búsqueda solo desde tu VPC. Hay matices: CloudTrail registra las llamadas como data events, pero están desactivados por defecto.

ZK
Zhemal Khamidun — CPO de Alpina Digital, product manager de AlpinaGPT. Crea productos de IA desde 2019. Hamidun News es un proyecto personal que creció hasta ser un agregador en producción con más de 6.000 lectores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
¿Qué te parece?
Cargando comentarios…