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 della soluzione
<a name="deploy-the-solution"></a>

Questa soluzione utilizza [ CloudFormation modelli e stack AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-whatis-concepts.html) per automatizzarne l'implementazione. Il CloudFormation modello specifica le risorse AWS incluse in questa soluzione e le relative proprietà. Lo CloudFormation stack fornisce le risorse descritte nel modello.

## Panoramica del processo di distribuzione
<a name="deployment-process-overview"></a>

Prima di lanciare la soluzione, esaminate i [costi](cost.md), l'[architettura](architecture-overview.md), [la sicurezza](security-1.md) e altre considerazioni discusse in questa guida.

**Importante**  
Se prevedi di utilizzare Amazon Bedrock, devi richiedere l'accesso ai modelli prima che siano disponibili per l'uso. Per ulteriori dettagli, consulta [Model access](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) nella *Amazon Bedrock User Guide*.

 **Tempo di implementazione: circa 10** minuti

 [Fase 1: Avviare lo stack di dashboard di distribuzione](step-1-launch-the-deployment-dashboard-stack.md) 

 [Fase 2: Implementazione di un caso d'uso](step-2-deploy-use-case.md) 

 [Fase 3: Implementazione di un caso d'uso utilizzando la procedura guidata del dashboard di distribuzione](step-3-deploy-a-use-case-using-deployment-dashboard-wizard.md) 

 [Fase 4: Configurazione post-implementazione](step-4-post-deployment-configuration.md) 

Facoltativamente, puoi distribuire i casi d'uso separatamente dalla soluzione, se preferisci non avere l'interfaccia utente del dashboard di Deployment o. APIs
+  [Implementazione di un caso d'uso Text autonomo](deploying-the-text-use-case-stack-separately.md) 
+  [Implementazione di un caso d'uso autonomo di Bedrock Agent](deploying-a-standalone-agent-use-case.md) 

Puoi anche [fornire una configurazione di chat DynamoDB](#supplying-a-dynamo-db-chat-configuration).

**Importante**  
Questa soluzione invia metriche operative ad AWS (i «Dati») sull'utilizzo di questa soluzione. Utilizziamo questi dati per comprendere meglio come i clienti utilizzano questa soluzione e i servizi e i prodotti correlati. La raccolta di questi dati da parte di AWS è soggetta alla [politica sulla privacy di AWS](https://aws.amazon.com/privacy/).

## Fornire una configurazione di chat DynamoDB
<a name="supplying-a-dynamo-db-chat-configuration"></a>

Quando si implementa un caso d'uso, **UseCaseConfigRecordKey**sono CloudFormation parametri obbligatori che normalmente **UseCaseConfigTableName**vengono compilati dal pannello di controllo Deployment. Lo stack dei dashboard di distribuzione gestisce la creazione e la configurazione di questa tabella, mentre le chiamate all'API di distribuzione attivano la compilazione dei parametri.

Quando si esegue una distribuzione autonoma, è necessario effettuare le seguenti operazioni:

1. **Crea una tabella DynamoDB con una chiave hash o chiave.**

1. Crea un record nella tabella contenente la configurazione per lo use case come record del formato: `{key: some_use_case_key, config: {your_configuration}.` 

1. Passa i parametri scelti **UseCaseConfigTableName**e **UseCaseConfigRecordKey**(`some_use_case_key`in questo esempio) allo stack di use case durante la distribuzione.

Per creare una configurazione adatta per una distribuzione autonoma, puoi creare uno use case richiesto dalla dashboard di Deployment e copiare il record dalla tabella di configurazione. Altrimenti, puoi creare la tua configurazione sulla base del seguente esempio per una distribuzione di Bedrock:

```
{
 "UseCaseName": "SampleUseCase",
 "ConversationMemoryParams": {
 "ConversationMemoryType": "DynamoDB",
 "HumanPrefix": "H",
 "AiPrefix": "A",
 "ChatHistoryLength": 20
 },
 "KnowledgeBaseParams": {
 "KnowledgeBaseType": "Bedrock",
 "NumberOfDocs": 2,
 "ScoreThreshold": 0,
 "ReturnSourceDocs": false,
 "BedrockKnowledgeBaseParams": {
 "BedrockKnowledgeBaseId": "SOME_ID",
 "OverrideSearchType": null
 }
 },
 "LlmParams": {
 "ModelProvider": "Bedrock",
 "BedrockLlmParams": { "ModelId": "anthropic.claude-v2" },
 "PromptParams": {
 "PromptTemplate": "some prompt",
 "MaxPromptTemplateLength": 187500,
 "MaxInputTextLength": 187500,
 "UserPromptEditingEnabled": true,
 "DisambiguationEnabled": true,
 "DisambiguationPromptTemplate": "some prompt"
 },
 "ModelParams": {},
 "Temperature": 1,
 "RAGEnabled": true,
 "Streaming": true,
 "Verbose": false
 }
}
```