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

# Utilizzo dello strumento browser
<a name="browser-using-tool"></a>

## Creazione di un AgentCore browser
<a name="browser-create"></a>

Puoi creare uno strumento per il browser utilizzando la AgentCore console Amazon Bedrock, la AWS CLI o AWS l'SDK.

**Example**  

1.  **Per creare uno strumento browser utilizzando la console ** 

1. Apri la AgentCore console all'indirizzo [ https://console.aws.amazon.com/bedrock-agentcore/home \#](https://console.aws.amazon.com/bedrock-agentcore/home#).

1. Nel pannello di navigazione, scegli ** Built-in Strumenti**.

1. Scegli lo strumento ** Crea browser**.

1. Fornisci un nome univoco ** per lo strumento ** e una ** descrizione opzionale**.

1. In Impostazioni ** di rete**, scegli Rete ** pubblica ** che consente l'accesso alle risorse Internet pubbliche.

1. In Registrazione ** della sessione**, puoi abilitare la registrazione delle sessioni del browser su un bucket S3 per una revisione successiva.

1. In ** Autorizzazioni**, specifica un ruolo di esecuzione IAM che definisca a quali AWS risorse può accedere il Browser Tool.

1. Scegli **Crea**.

1. Per creare un Browser Tool utilizzando la AWS CLI, usa il `create-browser` comando:

   ```
   aws bedrock-agentcore-control create-browser \
     --region <Region> \
     --name "my-browser" \
     --description "My browser for web interaction" \
     --network-configuration '{
       "networkMode": "PUBLIC"
     }' \
     --recording '{
       "enabled": true,
       "s3Location": {
         "bucket": "my-bucket-name",
         "prefix": "sessionreplay"
       }
     }' \
     --execution-role-arn "arn:aws:iam::123456789012:role/my-execution-role"
   ```

1. Per creare uno strumento browser utilizzando l' AWS SDK per Python (Boto3), usa il metodo: `create_browser`

    **Sintassi della richiesta** 

   Quanto segue mostra la sintassi della richiesta:

   ```
   response = cp_client.create_browser(
       name="my_custom_browser",
       description="Test browser for development",
       networkConfiguration={
           "networkMode": "PUBLIC"
       },
       executionRoleArn="arn:aws:iam::123456789012:role/Sessionreplay",
       clientToken=str(uuid.uuid4()),
       recording={
       "enabled": True,
       "s3Location": {
           "bucket": "session-record-123456789012",
           "prefix": "replay-data"
         }
       }
   )
   ```

1. Per creare una nuova istanza del browser utilizzando l'API, utilizzate la seguente chiamata:

   ```
   # Using awscurl
   awscurl -X PUT \
     "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     --service bedrock-agentcore \
     --region <Region> \
     -d '{
       "name": "test_browser_1",
       "description": "Test sandbox for development",
       "networkConfiguration": {
         "networkMode": "PUBLIC"
       },
       "recording": {
         "enabled": true,
         "s3Location": {
           "bucket": "<your-bucket-name>",
           "prefix": "sessionreplay"
         }
       },
       "executionRoleArn": "arn:aws:iam::123456789012:role/my-execution-role"
     }'
   ```

## Strumento Get AgentCore Browser
<a name="browser-get"></a>

Puoi ottenere informazioni sullo strumento Browser nel tuo account e visualizzarne i dettagli, lo stato e le configurazioni.

**Example**  

1.  **Per ottenere informazioni sullo strumento Browser utilizzando la console ** 

1. Apri la AgentCore console all'indirizzo [ https://console.aws.amazon.com/bedrock-agentcore/home \#](https://console.aws.amazon.com/bedrock-agentcore/home#).

1. Nel pannello di navigazione, scegli ** Built-in Strumenti**.

1. Gli strumenti del browser sono elencati nella ** sezione Strumenti ** del browser.

1. Puoi scegliere uno strumento che hai creato per visualizzarne i dettagli come nome, ID, stato e data di creazione di ogni strumento del browser.

1. Per ottenere informazioni su uno strumento Browser utilizzando la AWS CLI, usa il `get-browser` comando:

   ```
   aws bedrock-agentcore-control get-browser \
     --region <Region> \
     --browser-id "<your-browser-id>"
   ```

1. Per ottenere informazioni sullo strumento Browser utilizzando l' AWS SDK per Python (Boto3), usa il metodo: `get_browser`

    **Sintassi della richiesta** 

   Quanto segue mostra la sintassi della richiesta:

   ```
   response = cp_client.get_browser(
       browserId="<your-browser-id>"
   )
   ```

1. Per ottenere lo strumento browser utilizzando l'API, utilizzate la seguente chiamata:

   ```
   # Using awscurl
   awscurl -X GET \
     "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     --service bedrock-agentcore \
     --region <Region>
   ```

## Elenco degli strumenti AgentCore del browser
<a name="browser-list"></a>

Puoi elencare tutti gli strumenti del browser nel tuo account per visualizzarne i dettagli, lo stato e le configurazioni.

**Example**  

1.  **Per elencare gli strumenti del browser utilizzando la console ** 

1. Apri la AgentCore console all'indirizzo [ https://console.aws.amazon.com/bedrock-agentcore/home \#](https://console.aws.amazon.com/bedrock-agentcore/home#).

1. Nel pannello di navigazione, scegli ** Built-in Strumenti**.

1. Gli strumenti del browser sono elencati nella ** sezione Strumenti ** del browser.

1. È possibile visualizzare dettagli come nome, ID, stato e data di creazione per ogni strumento del browser.

1. Per elencare gli strumenti del browser utilizzando la AWS CLI, utilizzate il `list-browsers` comando:

   ```
   aws bedrock-agentcore-control list-browsers \
     --region <Region>
   ```

   Puoi filtrare i risultati per tipo:

   ```
   aws bedrock-agentcore-control list-browsers \
     --region <Region> \
     --type SYSTEM
   ```

   Puoi anche limitare il numero di risultati e utilizzare la paginazione:

   ```
   aws bedrock-agentcore-control list-browsers \
     --region <Region> \
     --max-results 10 \
     --next-token "<your-pagination-token>"
   ```

1. Per elencare gli strumenti del browser utilizzando l' AWS SDK per Python (Boto3), usa il metodo: `list_browsers`

    **Sintassi della richiesta** 

   Quanto segue mostra la sintassi della richiesta:

   ```
   response = cp_client.list_browsers(type="CUSTOM")
   ```

1. Per elencare gli strumenti del browser che utilizzano l'API, usa la seguente chiamata:

   ```
   # Using awscurl
   awscurl -X POST \
     "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     --service bedrock-agentcore \
     --region <Region>
   ```

   Puoi filtrare i risultati per tipo:

   ```
   awscurl -X POST \
     "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?type=SYSTEM" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     --service bedrock-agentcore \
     --region <Region>
   ```

   Puoi anche limitare il numero di risultati e utilizzare la paginazione:

   ```
   awscurl -X POST \
     "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?maxResults=1&nextToken=<your-pagination-token>" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     --service bedrock-agentcore \
     --region <Region>
   ```

## Eliminazione di un browser AgentCore
<a name="browser-delete"></a>

Quando non hai più bisogno di uno strumento del browser, puoi eliminarlo per liberare risorse. Prima di eliminare uno strumento del browser, assicurati di interrompere tutte le sessioni attive ad esso associate.

**Example**  

1.  **Per eliminare uno strumento Browser utilizzando la console ** 

1. Apri la AgentCore console all'indirizzo [ https://console.aws.amazon.com/bedrock-agentcore/home \#](https://console.aws.amazon.com/bedrock-agentcore/home#).

1. Vai agli ** Built-in strumenti ** e seleziona lo strumento del tuo browser.

1. Nel menu **Azioni** seleziona **Elimina**.

1. Conferma l'eliminazione digitando il nome dello strumento del browser nella finestra di dialogo di conferma.

1. Scegliere **Elimina**.
**Nota**  
Non è possibile eliminare uno strumento del browser con sessioni attive. Interrompi tutte le sessioni prima di tentare di eliminare lo strumento.

1. Per eliminare uno strumento Browser utilizzando la AWS CLI, utilizzate il `delete-browser` comando:

   ```
   aws bedrock-agentcore-control delete-browser \
     --region <Region> \
     --browser-id "<your-browser-id>"
   ```

1. Per eliminare uno strumento Browser usando l' AWS SDK per Python (Boto3), usa il metodo: `delete_browser`

    **Sintassi della richiesta** 

   Quanto segue mostra la sintassi della richiesta:

   ```
   response = cp_client.delete_browser(
       browserId="<your-browser-id>"
       )
   ```

1. Per eliminare uno strumento del browser utilizzando l'API, utilizzate la seguente chiamata:

   ```
   # Using awscurl
   awscurl -X DELETE \
     "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     --service bedrock-agentcore-control \
     --region <Region>
   ```