Utilizzo dello strumento Browser

Per creare uno strumento per il browser utilizzando la console

Apri la AgentCore console con https://console.aws.amazon.com/bedrock-agentcore/home#.

Nel riquadro di navigazione, scegli Built-in strumenti.

Scegli lo strumento Crea browser.

Fornisci un nome univoco dello 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 definisce a quali AWS risorse può accedere il Browser Tool.

Scegli Create (Crea).

Per creare uno strumento browser 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"

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

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

Per ottenere informazioni sullo strumento Browser utilizzando la console

Apri la AgentCore console con https://console.aws.amazon.com/bedrock-agentcore/home#.

Nel riquadro 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 per ogni strumento del browser.

Per ottenere informazioni su uno strumento Browser utilizzando la AWS CLI, utilizzate il get-browser comando:

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

Per ottenere informazioni sullo strumento Browser utilizzando l' AWS SDK for Python (Boto3), utilizzate il metodo: get_browser

Sintassi della richiesta

Di seguito viene illustrata la sintassi della richiesta:

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

Per utilizzare lo strumento del browser tramite 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>

Per elencare gli strumenti del browser utilizzando la console

Apri la AgentCore console con https://console.aws.amazon.com/bedrock-agentcore/home#.

Nel riquadro 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.

Per elencare gli strumenti del browser utilizzando la AWS CLI, usa 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 l'impaginazione:

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

Per elencare gli strumenti del browser che utilizzano 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")

Per elencare gli strumenti del browser che utilizzano l'API, utilizzate 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 l'impaginazione:

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>

Per eliminare uno strumento Browser utilizzando la console

Apri la AgentCore console con https://console.aws.amazon.com/bedrock-agentcore/home#.

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

Nel menu Azioni seleziona Elimina.

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

Scegli Elimina.

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

Per eliminare uno strumento Browser utilizzando l' AWS SDK per Python (Boto3), utilizzate il metodo: delete_browser

Sintassi della richiesta

Quanto segue mostra la sintassi della richiesta:

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

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>