

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à.

# Ottimizzazione delle prestazioni per gli agenti di Amazon Bedrock che utilizzano un’unica knowledge base
Ottimizzazione delle prestazioni per gli agenti che utilizzano un’unica knowledge base

Agent per Amazon Bedrock offre opzioni per scegliere diversi flussi in grado di ottimizzare la latenza per i casi d’uso più semplici, in cui gli agenti dispongono di un’unica knowledge base. Per assicurarti che l’agente sia in grado di sfruttare questa ottimizzazione, verifica che le seguenti condizioni si applichino alla versione pertinente dell’agente:
+ Il tuo agente contiene una sola knowledge base.
+ Il tuo agente non contiene gruppi di operazioni o questi sono tutti disabilitati.
+ Il tuo agente non chiede ulteriori informazioni all’utente se non dispone di informazioni sufficienti.
+ Il tuo agente utilizza il modello di prompt di orchestrazione predefinito.

Per scoprire come verificare queste condizioni, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati.

------
#### [ Console ]

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 **Panoramica degli agenti**, verifica che il campo **Input dell’utente** sia **DISABILITATO**.

1. Per controllare se l’ottimizzazione viene applicata alla bozza di lavoro dell’agente, seleziona la **bozza di lavoro** desiderata nella sezione **Bozza di lavoro**. Per controllare se l’ottimizzazione viene applicata a una versione dell’agente, seleziona la versione desiderata nella sezione **Versioni**.

1. Verifica che la sezione **Knowledge base** contenga una sola knowledge base. Se esiste più di una knowledge base, disabilitale tutte tranne una. Per informazioni su come disabilitare le knowledge base, consulta [Dissociazione di una knowledge base da un agente](agents-kb-delete.md).

1. Verifica che la sezione **Gruppi di operazioni** non contenga gruppi di operazioni. Se sono presenti gruppi di operazioni, disabilitali tutti. Per informazioni su come disabilitare i gruppi di operazioni, consulta [Modifica di un gruppo di operazioni](agents-action-edit.md).

1. Nella sezione **Prompt avanzati**, verifica che il valore del campo **Orchestrazione** sia **Predefinito**. Se è **Sostituito**, scegli **Modifica** (se stai visualizzando una versione dell’agente, devi prima passare alla bozza di lavoro) ed effettua le seguenti operazioni:

   1. Nella sezione **Prompt avanzati**, seleziona la scheda **Orchestrazione**.

   1. Se ripristini le impostazioni predefinite del modello, il modello di prompt personalizzato verrà eliminato. Assicurati di salvare il modello qualora ne avessi bisogno in seguito.

   1. Deseleziona **Sostituisci i valori predefiniti del modello di orchestrazione**. Conferma il messaggio che viene visualizzato.

1. Per applicare le modifiche apportate, seleziona **Prepara** nella parte superiore della pagina **Dettagli dell’agente** o nella finestra di test. Quindi, testa le prestazioni ottimizzate dell’agente inviando un messaggio nella finestra di test.

1. (Facoltativo) Se necessario, crea una nuova versione dell’agente seguendo le fasi indicate in [Implementazione e utilizzo di un agente di Amazon Bedrock nell’applicazione](agents-deploy.md).

------
#### [ API ]

1. Invia una richiesta [ListAgentKnowledgeBases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentKnowledgeBases.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’ID dell’agente. Per `agentVersion`, utilizza `DRAFT` per la bozza di lavoro o specifica la versione pertinente. Nella risposta, verificate che `agentKnowledgeBaseSummaries` contenga un solo oggetto (corrispondente a una knowledge base). Se esiste più di una knowledge base, disabilitale tutte tranne una. Per informazioni su come disabilitare le knowledge base, consulta [Dissociazione di una knowledge base da un agente](agents-kb-delete.md).

1. Invia una richiesta [ListAgentActionGroups](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentActionGroups.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’ID dell’agente. Per `agentVersion`, utilizza `DRAFT` per la bozza di lavoro o specifica la versione pertinente. Nella risposta, controlla che l’elenco `actionGroupSummaries` sia vuoto. Se sono presenti gruppi di operazioni, disabilitali tutti. Per informazioni su come disabilitare i gruppi di operazioni, consulta [Modifica di un gruppo di operazioni](agents-action-edit.md).

1. Invia una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.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’ID dell’agente. Nella risposta, all’interno dell’elenco `promptConfigurations` nel campo `promptOverrideConfiguration`, cerca l’oggetto [PromptConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptConfiguration.html) il cui valore `promptType` è `ORCHESTRATION`. Se il valore `promptCreationMode` è `DEFAULT`, non è necessario eseguire alcuna operazione. Se è `OVERRIDDEN`, ripristina le impostazioni predefinite del modello procedendo come segue:

   1. Se ripristini le impostazioni predefinite del modello, il modello di prompt personalizzato verrà eliminato. Assicurati di salvare il modello dal campo `basePromptTemplate` qualora ne avessi bisogno in seguito.

   1. Invia una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.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 l’oggetto [PromptConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptConfiguration.html) corrispondente al modello di orchestrazione, imposta il valore di `promptCreationMode` su `DEFAULT`.

1. Per applicare le modifiche apportate, invia una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.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). Quindi, verifica le prestazioni ottimizzate dell’agente inviando 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), utilizzando l’alias `TSTALIASID` dell’agente.

1. (Facoltativo) Se necessario, crea una nuova versione dell’agente seguendo le fasi indicate in [Implementazione e utilizzo di un agente di Amazon Bedrock nell’applicazione](agents-deploy.md).

------