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

# Configurazione dell’agente con Conversational Builder
<a name="agents-create-cb"></a>

Conversational Builder è un assistente interattivo che ti aiuta a configurare un agente. Conversational Builder consente di utilizzare il linguaggio naturale per descrivere lo scopo dell’agente, permettendo così di creare un agente completamente testabile che soddisfa lo scopo. Conversational Builder interagisce con te per ottenere tutte le informazioni necessarie per creare o aggiornare l’agente.

**Importante**  
Conversational Builder è disponibile nella console Amazon Bedrock nelle Regioni Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Europa (Francoforte), Asia Pacifico (Sydney) ed Europa (Parigi).

Conversational Builder esegue *solo* le seguenti azioni basate sulle interazioni:
+ Aggiornamento del nome e della descrizione dell’agente
+ Generazione di un riepilogo delle istruzioni dell’agente in base alle istruzioni fornite in linguaggio naturale
+ Creazione di un gruppo di operazioni 
+ Aggiornamento del nome e della descrizione di un gruppo di operazioni
+ Definizione di una funzione del gruppo di operazioni sulla base di un riepilogo del gruppo stesso
+ Associazione, elenco e dissociazione della knowledge base
+ Elenco o eliminazione di gruppi di operazioni

Di seguito è riportato un esempio di interazione con il Conversational Builder:

```
Conversational builder: Hello, I can help you update your Agent's configurations.

What configurations would you like to update?
You can say something like "Associate a knowledge base"

User: Create a travel agent
Conversational builder:  What is the purpose of this travel agent? What kind of tasks or capabilities should it have?
User: Travel agent books flights and hotels for vacation
Conversational builder: The travel agent with the purpose of booking flights and hotels for vacations has been successfully created.
```

## Creazione e configurazione di un agente utilizzando Conversational Builder nella console Amazon Bedrock
<a name="create-configure-cb"></a>

**Per creare un agente**

1. Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock)

1. Seleziona **Agenti** nel riquadro di navigazione a sinistra.

1. Nella sezione **Agenti**, scegli **Crea agente**.

1. (Facoltativo) Modifica il **nome** generato automaticamente per l’agente e fornisci una **descrizione** facoltativa.

1. Scegli **Create** (Crea). Una volta creato l’agente, l’utente viene indirizzato al relativo **Agente Builder** per configurarlo.

1. Puoi continuare con la seguente procedura e configurare subito l’agente o tornare ad Agente Builder in un secondo momento.

**Per configurare l’agente**

1. Se non hai già eseguito l’accesso ad Agente builder, procedi come segue:

   1. Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [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 **Modifica in Agente Builder**.

1. In Agente Builder, scegli **Assistente**

1. Nel riquadro Agente Builder, inserisci lo scopo del tuo agente. Guarda l’esempio di interazione per iniziare a interagire con l’assistente Conversational Builder.

1. Una volta che Conversational Builder ha completato la configurazione dell’agente, seleziona una delle opzioni seguenti:
   + Per rimanere in **Agente Builder**, scegli **Salva**. Quindi **Prepara** l’agente per testarlo con le configurazioni aggiornate nella finestra di test. Per informazioni su come testare l’agente, consulta [Test e risoluzione dei problemi relativi al comportamento dell’agente](agents-test.md).
   + Per tornare alla pagina dei **Dettagli dell’agente**, scegli **Salva ed esci**.

## Aggiunta delle seguenti autorizzazioni per utilizzare Conversational Builder nella console Amazon Bedrock
<a name="permissions-cb"></a>

Se hai intenzione di procedere alla [Configurazione dell’agente con Conversational Builder](#agents-create-cb), assicurati di collegare le seguenti autorizzazioni:

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "InvokeInlineAgent",
      "Effect": "Allow",
      "Action": "bedrock:InvokeInlineAgent",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "bedrock:InlineAgentName": "AgentName-123"
        }
      }
    },
    {
      "Sid": "InvokeFoundationModel",
      "Effect": "Allow",
      "Action": "bedrock:InvokeModel",
      "Resource": "arn:aws:bedrock:us-east-1::foundation-model/{modelId}"
    },
    {
      "Sid": "S3AccessForKBAndActions",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject"
      ],
      "Resource": "arn:aws:s3:::bucket-name/*"
    },
    {
      "Sid": "S3AccessForCodeInterpreter",
      "Effect": "Allow",
      "Action": [
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAttributes",
        "s3:GetObjectAttributes"
      ],
      "Resource": "arn:aws:s3:::bucket/path/to/file"
    },
    {
      "Sid": "KnowledgeBaseAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:Retrieve",
        "bedrock:RetrieveAndGenerate"
      ],
      "Resource": "arn:aws:bedrock:us-east-1:123456789012:knowledge-base/knowledge-base-id"
    },
    {
      "Sid": "GuardrailAccess",
      "Effect": "Allow",
      "Action": "bedrock:ApplyGuardrail",
      "Resource": "arn:aws:bedrock:us-east-1:123456789012:guardrail/guardrail-id"
    },
    {
      "Sid": "LambdaInvoke",
      "Effect": "Allow",
      "Action": "lambda:InvokeFunction",
      "Resource": "arn:aws:lambda:us-east-1:123456789012:function:function-name"
    },
    {
      "Sid": "KMSAccess",
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": "arn:aws:kms:us-east-1:123456789012:key/key-id"
    }
  ]
}
```

------