Web Grounding

El Anclaje web permite a Amazon Nova buscar información actual en Internet y proporcionar respuestas con citas. Esta característica resulta útil para consultas que requieren información actualizada más allá de los datos de entrenamiento del modelo.

Cómo funciona Web Grounding

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

Cómo utilizar Web Grounding

Para obtener ejemplos completos de código que utiliza el Anclaje web, consulte la sección Muestras de código.

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

import boto3
from botocore.config import Config

# Create the Bedrock Runtime client with extended timeout
bedrock = boto3.client(
    "bedrock-runtime",
    region_name="us-east-1",
    config=Config(read_timeout=3600)
)

# Define the tool configuration
tool_config = {
    "tools": [{
        "systemTool": {
            "name": "nova_grounding"
        }
    }]
}

# Send the request
response = bedrock.converse(
    modelId="us.amazon.nova-2-lite-v1:0",
    messages=[{
        "role": "user",
        "content": [{"text": "What are the latest developments in quantum computing?"}]
    }],
    toolConfig=tool_config
)

# Extract text with interleaved citations
output_with_citations = ""
content_list = response["output"]["message"]["content"]
for content in content_list:
    if "text" in content:
        output_with_citations += content["text"]
    elif "citationsContent" in content:
        citations = content["citationsContent"]["citations"]
        for citation in citations:
            url = citation["location"]["web"]["url"]
            output_with_citations += f" [{url}]"

print(output_with_citations)

Disponibilidad en las regiones

Actualmente, el Anclaje web solo está disponible en las regiones de EE. UU. y solo es compatible con los perfiles CRIS estadounidenses.

Estructura de una respuesta

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

{
  "output": {
    "message": {
      "content": [
        {
          "text": "Recent quantum computing developments include...",
          "citationsContent": [
            {
              "location": {
                "web": {
                  "url": "https://example.com/quantum-news",
                  "domain": "example.com"
                }
              }
            }
          ]
        }
      ]
    }
  }
}

Cada cita incluye lo siguiente:

Seguridad del anclaje

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 Internet y nuestros gráficos de conocimiento priorizan los orígenes fiables y de alta calidad, y filtran el contenido malicioso cuando ingresa. 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:

Permisos obligatorios para herramientas integradas

Tiene dos opciones para asegurarse de que el rol pueda acceder al Anclaje web en Amazon Bedrock:

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

El Anclaje web 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.