Cómo conectar las respuestas con los resultados de búsqueda en tiempo real - Amazon Nova
Cómo funciona Web GroundingCómo utilizar Web Grounding Seguridad de conexión Gestión de errores

Cómo conectar las respuestas con los resultados de búsqueda en tiempo real

nota

Esta documentación corresponde a la versión 1 de Amazon Nova. Para obtener información sobre el uso de Web Grounding (anclaje web) con Amazon Nova 2, consulte Web Grounding.

Web Grounding mejora los modelos Nova al conectarlos con información en tiempo real más allá de su límite de conocimiento, lo que se traduce en respuestas más precisas y confiables.

Cómo funciona Web Grounding

Cuando se habilita Web Grounding para una petición, se llevan a cabo los siguientes pasos:

  1. Solicitud de configuración: la aplicación envía una petición de usuario a la API de Amazon Bedrock con nova_grounding habilitado como systemTool.

  2. Evaluación de la búsqueda: el modelo analiza la petición y determina si es necesaria una búsqueda para mejorar la respuesta.

  3. Ejecución de la búsqueda: cuando es necesario, el modelo realiza automáticamente una o más búsquedas de información relevante.

  4. Análisis de resultados: el modelo decide si se requieren búsquedas adicionales para ampliar su comprensión o profundizar en subtemas específicos.

  5. Generación de respuestas: Nova sintetiza automáticamente la información de los resultados de búsqueda para generar una respuesta final de la API basada en información en tiempo real, con citas de sus fuentes.

Cómo utilizar Web Grounding

Para incluir Web Grounding en los resultados, especifique el siguiente parámetro systemTool en el bloque toolConfig:

"toolConfig": {
    "tools": [
        {"systemTool": {"name": "nova_grounding"}}
    ]
}

En la toolConfig, añada una herramienta con el parámetro systemTool como en el ejemplo anterior. Este parámetro le permite especificar las herramientas definidas por el sistema. Las herramientas definidas por el sistema son herramientas que proporciona e invoca el proveedor del modelo. Para obtener más información sobre cómo usar el parámetro systemTool, consulte SystemTool en la referencia de la API de Amazon Bedrock.

nota

Web Grounding solo está disponible en las regiones de EE. UU. Puede utilizar Web Grounding llamando a Amazon Nova Premier con el perfil de inferencia entre regiones us.amazon.nova-premier-v1:0.

El siguiente ejemplo es un comando CLI de AWS que utiliza Web Grounding:

aws --profile 111122223333 --region us-east-1 bedrock-runtime converse --model-id us.amazon.nova-premier-v1:0 --tool-config '{"tools":[{"systemTool":{"name":"nova_grounding"}}]}' --messages '[{"role":"user","content":[{"text":"What is the latest news about renewable energy sources?"}]}]'

A continuación, se muestra un ejemplo de respuesta. La respuesta se ha acortado por motivos de brevedad:

...
{
    "text": ".\n- **Solar energy** is leading growth with a 31% increase in generation in early 2025, outpacing wind's 7.7% growth "
},
{
    "citationsContent": {
        "citations": [
            {
                "location": {
                    "web": {
                        "url": "https://www.rfi.fr/en/environment/20251008-renewables-overtake-coal-but-growth-slows-amid-us-and-china-report-shows",
                        "domain": "rfi.fr"
                    }
            }
         }
        ]
    }
},
...

Esta respuesta contiene dos componentes: el texto que generó el modelo y la información de cita de ese texto. Los elementos incluidos son:

  • text: un segmento de la respuesta que generó el modelo.

  • citationsContent: el contenedor principal de los datos de la cita relacionados con un segmento text.

  • citations: un contenedor dentro de citationsContent que contiene la ubicación de una cita.

  • location: un contenedor dentro de citations que contiene la fuente de una cita.

  • web: un contenedor dentro de location que contiene los detalles de la fuente web.

  • url: la dirección web completa (URL) de la fuente de la cita.

  • domain: el dominio raíz de la url fuente.

Seguridad de conexión

Sus datos nunca abandonan la infraestructura de AWS. Las consultas generadas por el modelo permanecen dentro de los servicios de AWS y nunca se envían al resto de Internet. Nuestro amplio índice interno de búsquedas en la web y nuestros gráficos de conocimiento dan prioridad a las fuentes confiables y de alta calidad, y filtran el contenido malicioso cuando ingresa. Web Grounding refina aún más la información en tiempo de ejecución mediante referencias cruzadas desde múltiples fuentes. Por último, protegemos su aplicación contra la inyección de peticiones indirectas y la información errónea mediante el filtrado en tiempo de ejecución (tenga en cuenta que esta mitigación está limitada a los idiomas distintos del inglés).

Gestión de errores

No incluya una entrada de toolSpec con el nombre nova_grounding. Si se incluye una herramienta con este nombre, se producirá un error.

A continuación, se ofrece una lista de los posibles errores que se pueden producir al utilizar Web Grounding:

  • malformed_tool_use

  • max_tokens

  • malformed_model_output

Acceso a la herramienta de depuración

Tiene dos opciones para asegurarse de que su rol pueda acceder a Web Grounding en AWS Bedrock:

  1. Habilite BedrockFullAccess en su rol de IAM: si su rol posee BedrockFullAccess, tendrá acceso automáticamente a Web Grounding.

  2. Agregue permisos específicos (si es necesario): si necesita un control de acceso más detallado, añada esta política a la política de IAM de su rol y sustituya el texto rojo por el ID de su cuenta de AWS:

    
{ 
    Statement: [ 
      { 
        Effect: "Allow", 
        Action: [ "bedrock:InvokeTool" ], 
        Resource: [ "arn:aws:bedrock::{111122223333}:system-tool/amazon.nova_grounding" ] 
       } 
      ] 
}

Web Grounding tiene la clave de condición AWS:RequestedRegion configurada como “sin especificar”. Si sus políticas o políticas de control de servicios (SCP) actuales imponen esta condición, es posible que tenga problemas de acceso. Actualizar la condición para permitir una región solicitada “no especificada” puede resolver este problema.

importante

Si habilita la herramienta Web Grounding, usted es responsable del uso que usted haga, y del uso que hagan los usuarios finales, de los resultados que incorporen información básica. Sabrá si su resultado incluye información fundamentada procedente de citas o enlaces al material fuente. Debe retener y mostrar estas citas y enlaces en el resultado que proporcione a sus usuarios finales.

nota

Web Grounding tiene un costo adicional. Para obtener más información consulte https://aws.amazon.com//bedrock/pricing/