Configurazione di un agente di Amazon Bedrock per completare attività con strumenti di utilizzo del computer
L’utilizzo del computer è una funzionalità del modello Anthropic Claude (in versione beta) disponibile solo con Anthropic Claude 3.7 Sonnet e Claude 3.5 Sonnet v2.
avvertimento
La funzionalità di utilizzo del computer è resa disponibile come “Servizio Beta”, come definito nei Termini di servizio di AWS. È soggetto al Contratto con AWS e ai Termini di servizio di AWS e all’EULA del modello applicabile. L’utilizzo del computer comporta rischi unici che sono diversi da quelli legati alle funzionalità API standard o alle interfacce di chat. Questi rischi aumentano quando si ricorre a uno strumento di utilizzo del computer per interagire con Internet. Per ridurre al minimo i rischi, puoi prendere alcune precauzioni, ad esempio:
Esegui la funzionalità di utilizzo del computer in una macchina virtuale o in un container dedicato con privilegi minimi per prevenire attacchi diretti al sistema o incidenti.
Per prevenire il furto di informazioni, evita di concedere all’API di utilizzo del computer l’accesso ad account o dati sensibili.
Limita l’accesso a Internet delle API di utilizzo del computer ai soli domini necessari, per ridurre l’esposizione a contenuti dannosi.
Per garantire un’adeguata supervisione, mantieni un intervento di tipo HITL per le attività sensibili (come prendere decisioni che potrebbero avere conseguenze significative nel mondo reale) e per qualsiasi attività che richieda un consenso esplicito (come accettare i cookie, eseguire transazioni finanziarie o accettare i termini di servizio).
Qualsiasi contenuto reso disponibile a Claude per la visualizzazione o l’accesso può interferire con le istruzioni oppure causare errori o l’esecuzione di azioni indesiderate da parte di Claude. Adottare le dovute precauzioni, ad esempio isolare Claude dalle superfici sensibili, è essenziale, anche per evitare i rischi legati all’iniezione di prompt. Prima di abilitare o richiedere le autorizzazioni necessarie per attivare le funzionalità di utilizzo del computer nei tuoi prodotti, informa gli utenti finali di eventuali rischi pertinenti e ottieni il loro consenso, se appropriato.
L’utilizzo del computer permette a un agente di Amazon Bedrock di ricorrere a Claude per automatizzare le attività tramite azioni GUI di base ed eseguire i comandi linux implementati dall’utente. Ad esempio, se abilitato, l’agente può acquisire schermate, creare e modificare file di testo o eseguire comandi linux. Claude aiuta l’agente a prevedere quali strumenti e relative azioni utilizzare, in modo che l’agente possa implementare lo strumento giusto per completare l’attività. Per abilitare l’utilizzo del computer da parte di un agente, crea un gruppo di operazioni per l’agente e specifica uno strumento per l’utilizzo del computer. Per ulteriori informazioni sul flusso di lavoro, consulta Flusso di lavoro.
L’agente può utilizzare i seguenti strumenti definiti da Anthropic:
-
Computer: le azioni includono l’utilizzo di mouse e tastiera e l’acquisizione di schermate.
-
TextEditor: le azioni includono la visualizzazione, la creazione e la modifica di file.
-
Bash: le azioni includono l’esecuzione di comandi in una shell Bash.
Per ulteriori informazioni sugli strumenti per l’utilizzo del computer, inclusi esempi di implementazione e descrizioni degli strumenti, consulta Utilizzo del computer (beta)
Argomenti
Considerazioni sui guardrail
Di seguito sono riportate alcune considerazioni sui guardrail relative agli agenti e agli strumenti di utilizzo del computer:
-
È consigliabile implementare misure di sicurezza per la tua applicazione associando un guardrail all’agente. Per ulteriori informazioni, consulta Implementazione di misure di sicurezza per l’applicazione associando un guardrail al proprio agente.
-
A causa delle limitazioni dei guardrail di immagini, se l’applicazione estrae testo da immagini, utilizza l’API ApplyGuardrail per limitare il contenuto prima dell’estrazione. Per ulteriori informazioni sui guardrail in Amazon Bedrock, consulta Rilevare e filtrare contenuti dannosi utilizzando Guardrail per Amazon Bedrock.
Flusso di lavoro
Per ricorrere agli strumenti di utilizzo del computer con Agent per Amazon Bedrock, procedi come segue:
-
Crea un gruppo di operazioni e specifica uno strumento per l’utilizzo del computer. Specifica gli strumenti disponibili per l’agente nell’operazione API CreateAgentActionGroup o UpdateAgentActionGroup. Per gli agenti in linea, specifica lo strumento nell’operazione dell’API InvokeInlineAgent.
-
Implementa le funzioni di utilizzo del computer nella tua applicazione. Per esempi di implementazioni degli strumenti, consulta anthropic-quickstarts/computer-use-demo/tools
nel repository GitHub anthropic-quickstarts . -
Gestisci le richieste di strumenti per l’utilizzo del computer da parte degli agenti durante le conversazioni. Dopo aver utilizzato l’operazione API InvokeAgent, estrai lo strumento e la scelta dell’azione dalla risposta, quindi esegui l’implementazione dell’azione dello strumento.
