Creazione di un AgentCore browser Strumento Get AgentCore Browser Elenco degli strumenti AgentCore del browser Eliminazione di un browser AgentCore

Utilizzo dello strumento browser

Creazione di un AgentCore browser

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

Esempio

Console

Per creare uno strumento browser utilizzando la console
Apri la AgentCore console all'indirizzo https://console.aws.amazon.com/bedrock-agentcore/home #.
Nel pannello di navigazione, scegli Built-in Strumenti.
Scegli lo strumento Crea browser.
Fornisci un nome univoco per lo strumento e una descrizione opzionale.
In Impostazioni di rete, scegli Rete pubblica che consente l'accesso alle risorse Internet pubbliche.
In Registrazione della sessione, puoi abilitare la registrazione delle sessioni del browser su un bucket S3 per una revisione successiva.
In Autorizzazioni, specifica un ruolo di esecuzione IAM che definisca a quali AWS risorse può accedere il Browser Tool.
Scegli Crea.

AWS CLI

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"

Boto3

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"
      }
    }
)

API

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

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

Esempio

Console

Per ottenere informazioni sullo strumento Browser utilizzando la console
Apri la AgentCore console all'indirizzo https://console.aws.amazon.com/bedrock-agentcore/home #.
Nel pannello di navigazione, scegli Built-in Strumenti.
Gli strumenti del browser sono elencati nella sezione Strumenti del browser.
Puoi scegliere uno strumento che hai creato per visualizzarne i dettagli come nome, ID, stato e data di creazione di ogni strumento del browser.

AWS CLI

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>"

Boto3

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>"
)
```

API

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

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

Esempio

Console

Per elencare gli strumenti del browser utilizzando la console
Apri la AgentCore console all'indirizzo https://console.aws.amazon.com/bedrock-agentcore/home #.
Nel pannello di navigazione, scegli Built-in Strumenti.
Gli strumenti del browser sono elencati nella sezione Strumenti del browser.
È possibile visualizzare dettagli come nome, ID, stato e data di creazione per ogni strumento del browser.

AWS CLI

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>"

Boto3

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")
```

API

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

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.

Esempio

Console

Per eliminare uno strumento Browser utilizzando la console
Apri la AgentCore console all'indirizzo https://console.aws.amazon.com/bedrock-agentcore/home #.
Vai agli Built-in strumenti e seleziona lo strumento del tuo browser.
Nel menu Azioni seleziona Elimina.
Conferma l'eliminazione digitando il nome dello strumento del browser nella finestra di dialogo di conferma.
Scegliere Elimina.

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

AWS CLI

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>"

Boto3

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>"
    )
```

API

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>

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Fondamenti

Gestione delle sessioni del browser

Utilizzo dello strumento browser

Creazione di un AgentCore browser

Esempio

Strumento Get AgentCore Browser

Esempio

Elenco degli strumenti AgentCore del browser

Esempio

Eliminazione di un browser AgentCore

Esempio

Nota