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à. # Implementazione e utilizzo di un agente di Amazon Bedrock nell’applicazione Per poter utilizzare un agente, è necessario prima implementarlo creando un alias. È quindi possibile utilizzare l’agente nell’applicazione chiamando l’operazione [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html). In questa sezione, scopri come creare e gestire un alias e come chiamare l’agente da un’applicazione. **Topics** + [Distribuzione di un agente](deploy-agent.md) + [Invocazione di un agente dalla propria applicazione](agents-invoke-agent.md) # Distribuzione di un agente Quando crei per la prima volta un agente di Amazon Bedrock, hai una versione della bozza di lavoro (`DRAFT`) e un alias di test (`TSTALIASID`) che rimanda alla versione della bozza di lavoro. Quando apporti modifiche al tuo agente, le modifiche si applicano alla bozza di lavoro. Continui a iterare sulla bozza di lavoro finché il comportamento dell’agente non risulta soddisfacente. Quindi, puoi configurare l’agente per implementarlo e integrarlo nell’applicazione creando gli *alias* dell’agente. **Alias e versioni** Per implementare l’agente, devi creare un *alias*. Durante la creazione dell’alias, Amazon Bedrock genera automaticamente una versione dell’agente. L’alias rimanda alla versione appena creata. In alternativa, puoi fare in modo che l’alias punti alla versione creata in precedenza dell’agente. Poi configura l’applicazione per effettuare chiamate API all’alias. Una *versione* è simile a uno snapshot che conserva la risorsa così com’era al momento della creazione. Puoi continuare a modificare la bozza di lavoro e creare nuovi alias (e di conseguenza, nuove versioni) dell’agente, se necessario. In Amazon Bedrock, per generare una nuova versione dell’agente, crea un alias che rimanda per impostazione predefinita a questa versione. Amazon Bedrock crea le versioni in ordine numerico, a partire da 1. Le versioni sono immutabili perché fungono da snapshot dell’agente al momento della creazione. Per eseguire aggiornamenti a un agente in produzione, è necessario creare una nuova versione e configurare l’applicazione in modo che chiami l’alias che punta a quella versione. Gli alias consentono di passare comodamente da una versione all’altra dell’agente, senza che l’applicazione debba tenere traccia della versione. Per esempio, puoi modificare un alias per puntare a una versione precedente del tuo agente, se ci sono modifiche che devi ripristinare rapidamente. ## Sospensione di un agente distribuito Potrebbe essere necessario sospendere temporaneamente l’esecuzione di un agente. Ad esempio, durante la manutenzione, gli aggiornamenti o durante la risoluzione di problemi di prestazioni. Per mettere in pausa un agente, utilizzi l’alias dell’agente con l’operazione [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html). Per sospendere un agente, imposta il campo `aliasInvocationState` su `REJECT_INVOCATIONS`. Per riavviare l’agente, imposta `aliasInvocationState` su `ACCEPT_INVOCATIONS`. Non è necessario apportare modifiche alla policy IAM per la sospensione dell’agente. Per verificare se un agente è attualmente in pausa, chiama [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) e controlla il campo `aliasInvocationState`. Puoi anche verificare la presenza di un alias nel campo `aliasInvocationState` nella risposta di [ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html). **Topics** + [Sospensione di un agente distribuito](#agent-pause) + [Creazione di un alias per l’agente](deploy-agent-proc.md) + [Visualizzazione delle informazioni sulle versioni degli agenti in Amazon Bedrock](agents-version-view.md) + [Eliminazione di una versione di un agente in Amazon Bedrock](agents-version-delete.md) + [Visualizzazione di informazioni sugli alias degli agenti in Amazon Bedrock](agents-alias-view.md) + [Modifica di un alias di un agente in Amazon Bedrock](agents-alias-edit.md) + [Eliminazione di un alias di un agente in Amazon Bedrock](agents-alias-delete.md) # Creazione di un alias per l’agente La procedura seguente mostra come creare un alias e una versione per l’agente. Dopo aver creato un alias, puoi utilizzare l’agente nell’applicazione effettuando una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) con un [endpoint di runtime Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). **Per creare un alias** + Crea un alias e una versione dell’agente. Scegli la scheda relativa al metodo che preferisci, quindi segui la procedura: ------ #### [ Console ] **Come creare un nuovo alias (e facoltativamente una nuova versione)** 1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**. 1. Nella sezione **Alias**, seleziona **Crea**. 1. Inserisci un **nome alias** univoco e fornisci una **Descrizione** facoltativa. 1. In **Associa una versione**, scegli una delle seguenti opzioni: + Per creare una nuova versione, scegli **Crea una nuova versione e associala a questo alias**. + Per utilizzare una versione esistente, scegli **Usa una versione esistente per associare questo alias**. Nel menu a discesa, scegli la versione a cui associare l’alias. 1. In **Seleziona throughput**, scegli una delle seguenti opzioni: + Per consentire all’agente di eseguire l’inferenza del modello alle velocità previste per il tuo account, seleziona **On demand (ODT)**. Per ulteriori informazioni, consulta [Quote per Amazon Bedrock](quotas.md). + Per consentire all’agente di eseguire l’inferenza del modello a una velocità maggiore utilizzando un throughput assegnato acquistato in precedenza per il modello, seleziona **Throughput assegnato (PT)**, quindi seleziona un modello assegnato. Per ulteriori informazioni, consulta [Aumenta la capacità di invocazione del modello con Provisioned Throughput in Amazon Bedrock](prov-throughput.md). 1. Seleziona **Crea alias**. ------ #### [ API ] Per creare un alias per un agente, invia una richiesta [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.html) a un [endpoint in fase di compilazione Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). I seguenti campi sono obbligatori: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/deploy-agent-proc.html) I seguenti campi sono facoltativi: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/deploy-agent-proc.html) ``` def create_agent_alias(self, name, agent_id): """ Creates an alias of an agent that can be used to deploy the agent. :param name: The name of the alias. :param agent_id: The unique identifier of the agent. :return: Details about the alias that was created. """ try: response = self.client.create_agent_alias( agentAliasName=name, agentId=agent_id ) agent_alias = response["agentAlias"] except ClientError as e: logger.error(f"Couldn't create agent alias. {e}") raise else: return agent_alias ``` Per ulteriori informazioni, consulta [Agent per Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md). ------ # Visualizzazione delle informazioni sulle versioni degli agenti in Amazon Bedrock Dopo aver creato una versione del tuo agente, puoi visualizzare le relative informazioni o eliminarla. Puoi creare una nuova versione di un agente solo creando un nuovo alias. Per scoprire come visualizzare le informazioni su una versione di un agente, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per visualizzare le informazioni sulla versione di un agente** 1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**. 1. Scegli la versione da visualizzare nella sezione **Versioni**. 1. Per visualizzare i dettagli relativi a modello, gruppi di operazioni o knowledge base collegati alla versione dell’agente, scegli il nome delle informazioni che desideri vedere. Non è possibile modificare alcuna parte di una versione. Per apportare modifiche all’agente, utilizza la bozza di lavoro e crea una nuova versione. ------ #### [ API ] Per ottenere informazioni su una versione dell’agente, invia una richiesta [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Specifica `agentId` e `agentVersion`. Per elencare le informazioni sulle versioni di un agente, invia una richiesta [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica l’`agentId`. È inoltre possibile specificare i parametri opzionali seguenti: **** | Campo | Breve descrizione | | --- | --- | | maxResults | Il numero massimo di risultati da restituire nella risposta. | | nextToken | Se i risultati sono superiori al numero specificato nel campo maxResults, la risposta restituisce un valore nextToken. Per visualizzare il batch di risultati successivo, invia il valore nextToken in un’altra richiesta. | ------ # Eliminazione di una versione di un agente in Amazon Bedrock Per scoprire come eliminare una versione di un agente, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per eliminare una versione di un agente** 1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**. 1. Per selezionare la versione da eliminare, nella sezione **Versioni**, scegli il pulsante di opzione accanto alla versione desiderata. 1. Scegli **Elimina**. 1. Viene visualizzata una finestra di dialogo che ti informa delle conseguenze dell’eliminazione. Per confermare l’eliminazione della versione precedente, immetti **delete** nel campo di immissione e scegli **Elimina**. 1. Viene visualizzato un banner blu per informarti che la versione sta per essere eliminata. Al termine dell’eliminazione, viene visualizzato un banner che notifica la riuscita dell’operazione. ------ #### [ API ] Per eliminare una versione di un agente, invia una richiesta [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Per impostazione predefinita, il parametro `skipResourceInUseCheck` è `false` e l’eliminazione si arresta se la risorsa è in uso. Se imposti `skipResourceInUseCheck` su `true`, la risorsa verrà eliminata anche se è in uso. ------ # Visualizzazione di informazioni sugli alias degli agenti in Amazon Bedrock Per scoprire come visualizzare le informazioni sugli alias di un agente, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per visualizzare i dettagli di un alias** 1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**. 1. Scegli l’alias da visualizzare nella sezione **Alias**. 1. Puoi visualizzare il nome e la descrizione dell’alias e dei tag associati all’alias. ------ #### [ API ] Per ottenere informazioni su un alias dell’agente, invia una richiesta [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Specifica `agentId` e `agentAliasId`. Per elencare le informazioni sugli alias di un agente, invia una richiesta [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica l’`agentId`. È inoltre possibile specificare i parametri opzionali seguenti: **** | Campo | Breve descrizione | | --- | --- | | maxResults | Il numero massimo di risultati da restituire nella risposta. | | nextToken | Se i risultati sono superiori al numero specificato nel campo maxResults, la risposta restituisce un valore nextToken. Per visualizzare il batch di risultati successivo, invia il valore nextToken in un’altra richiesta. | Per visualizzare tutti i tag di un alias, invia una richiesta [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e includi il nome della risorsa Amazon (ARN) dell’agente. ------ # Modifica di un alias di un agente in Amazon Bedrock Per scoprire come modificare un alias di un agente, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per modificare un alias** 1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**. 1. Nella sezione **Alias**, scegli il pulsante di opzione accanto all’alias che desideri modificare. Quindi scegli **Modifica**. 1. Modifica qualsiasi campo esistente in base alle esigenze. Per ulteriori informazioni sui campi, consulta [Implementazione e utilizzo di un agente di Amazon Bedrock nell’applicazione](agents-deploy.md). 1. Seleziona **Salva**. **Per aggiungere o rimuovere tag associati a un alias** 1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**. 1. Scegli l’alias di cui desideri gestire i tag dalla sezione **Alias**. 1. Nella sezione **Tag** scegli **Gestisci tag**. 1. Per aggiungere un tag, scegliere **Add new tag**(Aggiungi un nuovo tag). Quindi inserisci una **Chiave** e, facoltativamente, un **Valore**. Per rimuovere un tag, scegli **Remove** (Rimuovi). Per ulteriori informazioni, consulta [Assegnazione di tag alle risorse Amazon Bedrock](tagging.md). 1. Una volta completata la modifica dei tag, scegli **Invia**. ------ #### [ API ] Per modificare un alias di un agente, invia una richiesta [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Poiché tutti i campi verranno sovrascritti, includi sia i campi che vuoi aggiornare sia quelli che vuoi mantenere invariati. Per aggiungere tag a un alias, invia una richiesta [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e includi il nome della risorsa Amazon (ARN) dell’agente. Il corpo della richiesta contiene un campo `tags`, che consiste in un oggetto contenente una coppia chiave-valore che hai specificato per ogni tag. Per rimuovere tag da un alias, invia una richiesta [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e includi il nome della risorsa Amazon (ARN) dell’agente. Il parametro di richiesta `tagKeys` è un elenco contenente le chiavi relative ai tag che desideri rimuovere. ------ # Eliminazione di un alias di un agente in Amazon Bedrock Per scoprire come eliminare un alias di un agente, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per eliminare un alias** 1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**. 1. Per scegliere l’alias da eliminare, nella sezione **Alias**, scegli il pulsante di opzione accanto all’alias che desideri eliminare. 1. Scegli **Elimina**. 1. Viene visualizzata una finestra di dialogo che ti informa delle conseguenze dell’eliminazione. Per confermare che desideri eliminare l’alias, immetti **delete** nel campo di input, quindi scegli **Elimina**. 1. Viene visualizzato un banner per informarti che l’alias sta per essere eliminato. Al termine dell’eliminazione, viene visualizzato un banner che notifica la riuscita dell’operazione. ------ #### [ API ] Per eliminare un alias di un agente, invia una richiesta [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.html) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Per impostazione predefinita, il parametro `skipResourceInUseCheck` è `false` e l’eliminazione si arresta se la risorsa è in uso. Se imposti `skipResourceInUseCheck` su `true`, la risorsa verrà eliminata anche se è in uso. ``` def delete_agent_alias(self, agent_id, agent_alias_id): """ Deletes an alias of an Amazon Bedrock agent. :param agent_id: The unique identifier of the agent that the alias belongs to. :param agent_alias_id: The unique identifier of the alias to delete. :return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception. """ try: response = self.client.delete_agent_alias( agentId=agent_id, agentAliasId=agent_alias_id ) except ClientError as e: logger.error(f"Couldn't delete agent alias. {e}") raise else: return response ``` Per ulteriori informazioni, consulta [Agent per Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md). ------ # Invocazione di un agente dalla propria applicazione Utilizza l’agente in un’applicazione effettuando una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) con un [endpoint di runtime Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Per impostazione predefinita, la risposta di `InvokeAgent` include un blocco che contiene la risposta completa dell’agente, il cui completamento può richiedere un po’ di tempo. In alternativa, puoi configurare `InvokeAgent` in modo che esegua lo streaming della risposta in più blocchi di minori dimensioni. Questo riduce la latenza della risposta iniziale dell’agente. **Streaming delle risposte** Facoltativamente, è possibile abilitare lo streaming della risposta impostando `streamFinalResponse` su `true` nelle configurazioni per lo streaming ([StreamingConfigurations](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StreamingConfigurations.html)). Il flusso di risposta contiene più eventi con blocchi per ogni parte della risposta in ordine. Per lo streaming delle risposte, assicurati che il ruolo di esecuzione dell’agente includa l’autorizzazione `bedrock:InvokeModelWithResponseStream` per il modello di agente configurato. Per ulteriori informazioni, consulta [Autorizzazioni basate sull’identità per il ruolo di servizio degli agenti.](agents-permissions.md#agents-permissions-identity). Se l’agente è configurato con un guardrail, puoi anche specificare `applyGuardrailInterval` nel campo `StreamingConfigurations`, per controllare con quale frequenza viene effettuata una chiamata `ApplyGuardrail` sui caratteri di risposta in uscita (ad esempio, ogni 50 caratteri). Per impostazione predefinita, l’intervallo del guardrail è impostato su 50 caratteri. Se specifichi un intervallo maggiore, la risposta verrà generata in blocchi più grandi con un minor numero di chiamate `ApplyGuardrail`. Gli esempi seguenti mostrano la risposta generata per la stringa di input *Hello, I am an agent*. **Esempio di risposta in blocchi: intervallo impostato su 3 caratteri** ``` 'Hel', 'lo, ', 'I am', ' an', ' Age', 'nt' ``` Ogni blocco, tranne l’ultimo, contiene almeno 3 caratteri. **Esempio di risposta in blocchi: intervallo impostato su 20 o più caratteri** ``` 'Hello, I am an Agent' ``` ## Invocazione di un agente L’esempio seguente Python mostra come chiamare l’operazione [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) e visualizzare l’output dell’agente, nonché tutte le informazioni di [traccia](trace-events.md) generate dalla chiamata. **Per invocare un agente** 1. Crea un agente seguendo le istruzioni fornite in [Creazione e configurazione manuale dell’agente](agents-create.md). Prendi nota dell’ID dell’agente. Se necessario, puoi ottenere l’ID in un secondo momento. Per ulteriori informazioni, consulta [Visualizzazione di informazioni su un agente](agents-view.md). 1. Crea un alias per l’agente seguendo le istruzioni fornite in [Creazione di un alias per l’agente](deploy-agent-proc.md). Prendi nota dell’ID dell’alias. Se necessario, puoi ottenere l’ID in un secondo momento. Per ulteriori informazioni, consulta [Visualizzazione di informazioni sugli alias degli agenti in Amazon Bedrock](agents-alias-view.md). 1. Eseguire il seguente codice. Aggiorna il valore di `agent_id` all’ID dell’agente e il valore di `alias_id` all’ID dell’alias dell’agente. Per trasmettere in streaming la risposta dell’agente, modifica il valore di `streamFinalResponse` in `True`. Puoi inoltre modificare l’intervallo del guardrail modificando il valore di `applyGuardrailInterval`. ``` import boto3 import logging from botocore.exceptions import ClientError logging.basicConfig(level=logging.INFO) logger = logging.getLogger(__name__) def invoke_agent(client, agent_id, alias_id, prompt, session_id): response = client.invoke_agent( agentId=agent_id, agentAliasId=alias_id, enableTrace=True, sessionId = session_id, inputText=prompt, streamingConfigurations = { "applyGuardrailInterval" : 20, "streamFinalResponse" : False } ) completion = "" for event in response.get("completion"): #Collect agent output. if 'chunk' in event: chunk = event["chunk"] completion += chunk["bytes"].decode() # Log trace output. if 'trace' in event: trace_event = event.get("trace") trace = trace_event['trace'] for key, value in trace.items(): logging.info("%s: %s",key,value) print(f"Agent response: {completion}") if __name__ == "__main__": client=boto3.client( service_name="bedrock-agent-runtime" ) agent_id = "AGENT_ID" alias_id = "ALIAS_ID" session_id = "MY_SESSION_ID" prompt = "Prompt to send to agent" try: invoke_agent(client, agent_id, alias_id, prompt, session_id) except ClientError as e: print(f"Client error: {str(e)}") logger.error("Client error: %s", {str(e)}) ```