Archiviazione della cronologia e del contesto delle conversazioni in una sessione - Amazon Bedrock
CreateInvocation esempioPutInvocationSteps esempio

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Archiviazione della cronologia e del contesto delle conversazioni in una sessione

Dopo aver creato una sessione, utilizza l'CreateInvocationAPI per creare un raggruppamento di interazioni all'interno della sessione. Per ogni raggruppamento, utilizza le operazioni PutInvocationStepAPI per memorizzare i checkpoint di stato, inclusi testo e immagini, per ogni interazione.

Il modo in cui organizzi le fasi di invocazione all’interno delle invocazioni dipende dal tuo caso d’uso. Ad esempio, se disponi di un agente che aiuta i clienti a effettuare prenotazioni di viaggio, l’invocazione e le fasi di invocazione potrebbero essere i seguenti:

  • L’invocazione potrebbe servire come raggruppamento per il testo di una conversazione tra un agente e un cliente che verifica la disponibilità di camere in un determinato hotel per diverse notti.

  • Ogni fase di invocazione può corrispondere a ciascun messaggio tra l’agente e l’utente e a ciascuna azione eseguita dall’agente per recuperare la disponibilità.

Nella tua PutInvocationStepAPI, puoi importare immagini associate alla conversazione.

  • Puoi includere fino a 20 immagini. Le dimensioni, l’altezza e la larghezza di ciascuna immagine non devono superare rispettivamente 3,75 MB, 8000 px e 8000 px.

  • Puoi importare i seguenti tipi di immagini:

    • PNG

    • JPEG

    • GIF

    • WEBP

CreateInvocation esempio

L’esempio di codice seguente mostra come aggiungere un’invocazione a una sessione attiva con AWS SDK per Python (Boto3). Per sessionIdentifier, puoi specificare il sessionId della sessione o il relativo nome della risorsa Amazon (ARN). Per ulteriori informazioni sull'API, consulta CreateInvocation. 

def create_invocation(session_identifier):
try:
    invocationId = client.create_invocation(
        sessionIdentifier=session_identifier,
        description="User asking about weather in Seattle",
        invocationId="12345abc-1234-abcd-1234-abcdef123456"
    )["invocationId"]
    print("invocation created")
    return invocationId
except ClientError as e:
    print(f"Error: {e}")

PutInvocationSteps esempio

L’esempio di codice seguente mostra come aggiungere una fase di invocazione a una sessione attiva con AWS SDK per Python (Boto3). Il codice aggiunge testo e un’immagine dalla directory di lavoro. Per sessionIdentifier, puoi specificare il sessionId della sessione o il relativo nome della risorsa Amazon (ARN). Per l’identificatore dell’invocazione, specifica l’identificatore univoco (in formato UUID) dell’invocazione a cui aggiungere la fase di invocazione. Per ulteriori informazioni sull'API, consulta PutInvocationStep. 

def put_invocation_step(invocation_identifier, session_identifier):
with open('weather.png', 'rb') as image_file:
    weather_image = image_file.read()

try:
    client.put_invocation_step(
        sessionIdentifier=session_identifier,
        invocationIdentifier=invocation_identifier,
        invocationStepId="12345abc-1234-abcd-1234-abcdef123456",
        invocationStepTime="2023-08-08T12:00:00Z",
        payload={
            'contentBlocks': [
                {
                    'text': 'What\'s the weather in Seattle?',

                },
                {
                    'image': {
                        'format': 'png',
                        'source': {'bytes': weather_image}
                    }
                }

            ]
        }
    )
    print("invocation step created")
except ClientError as e:
    print(f"Error: {e}")