View a markdown version of this page

Uso de la API de Invoke - Amazon Nova

Uso de la API de Invoke

La API de Invoke proporciona acceso directo a los modelos de Amazon Nova con más capacidad para controlar el formato de solicitud y respuesta. A diferencia de la API de Converse, que resume los detalles específicos del modelo, la API de Invoke le permite trabajar directamente con las estructuras de solicitud y respuesta nativas del modelo.

nota

La API de Invoke admite las mismas características que la API de Converse, excepto la modalidad de entrada de documentos, que es específica de la API de Converse.

Estructura de la solicitud

Una solicitud de la API de Invoke requiere el ID del modelo y el cuerpo de la solicitud en formato JSON:

import boto3 import json bedrock = boto3.client('bedrock-runtime', region_name='us-east-1') request_body = { 'messages': [ { 'role': 'user', 'content': [{'text': 'What is machine learning?'}] } ], 'inferenceConfig': { 'maxTokens': 512, 'temperature': 0.7 } } response = bedrock.invoke_model( modelId='us.amazon.nova-2-lite-v1:0', body=json.dumps(request_body) ) response_body = json.loads(response['body'].read()) content_list = response_body["output"]["message"]["content"] # Extract the first text block text_block = next((item for item in content_list if "text" in item), None) if text_block is not None: print(text_block["text"])

Parámetros de solicitud

La API de Invoke admite los siguientes parámetros claves:

  • messages: matriz de mensajes de conversación con rol y contenido

  • system: petición del sistema opcional para el contexto y las instrucciones

  • inferenceConfig: parámetros que controlan la salida del modelo (temperatura, maxTokens, topP, topK, stopSequences, reasoningConfig)

  • toolConfig: especificaciones y elección de la herramienta para la llamada a funciones