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à. # Generazione, esecuzione e test del codice per l’applicazione abilitando l’interpretazione del codice L’interpretazione del codice consente all’agente di generare, eseguire e risolvere i problemi del codice dell’applicazione in un ambiente di test sicuro. Con l’interpretazione del codice puoi utilizzare il modello di fondazione dell’agente per generare codice per l’implementazione di funzionalità di base, mentre ti concentri sulla creazione di applicazioni di IA generativa. Puoi eseguire le seguenti attività con l’interpretazione del codice in Amazon Bedrock: + Comprendere le richieste degli utenti relative ad attività specifiche, generare codice in grado di eseguire le attività richieste dall’utente, eseguire il codice e fornire il risultato dell’esecuzione del codice. + Comprendere le query generiche dell’utente, generare ed eseguire codice per fornire una risposta all’utente. + Generare codice per eseguire analisi, visualizzazione e valutazione dei dati. + Estrarre le informazioni dai file caricati dall’utente, elaborale e rispondere alle query dell’utente. + Generare codice basato sulle conversazioni interattive con l’utente per la prototipazione rapida. Per impostazione predefinita, il numero massimo di interpretazioni di codice attive contemporaneamente per sessione per Account AWS è 25. Ciò significa che ogni Account AWS può avere fino a 25 conversazioni simultanee con gli agenti utilizzando l’interprete di codice. Di seguito sono riportati alcuni casi d’uso in cui l’interpretazione del codice può essere d’aiuto generando ed eseguendo il codice all’interno di Amazon Bedrock. 1. Analisi delle transazioni finanziarie da un file di dati come .csv per determinare se hanno generato un profitto o una perdita. 1. Conversione del formato della data, ad esempio *14 marzo 2020*, in un formato API standard `YYYY-MM-DD` per formati di file come .txt o.csv 1. Esecuzione dell’analisi dei dati su un foglio di calcolo (XLS) per calcolare metriche quali i ricavi trimestrali/annuali dell’azienda o il tasso di crescita della popolazione. Per utilizzare l’interpretazione del codice in Amazon Bedrock, esegui le fasi seguenti: + Abilita l’interpretazione del codice quando crei il tuo agente. Una volta abilitata l’interpretazione del codice, puoi iniziare a utilizzarla. + Inizia a utilizzare l’interpretazione del codice in Amazon Bedrock fornendo dei prompt. Ad esempio, puoi chiedere “calcola la radice quadrata di pi greco con 127 cifre”. L’interpretazione del codice genererà ed eseguirà il codice Python per fornire una risposta. + Puoi anche allegare file. Puoi utilizzare le informazioni contenute nei file per porre domande e riassumere o analizzare i dati. Puoi allegare i file dal computer o dal bucket Amazon S3. **Regioni supportate** L’interpretazione del codice per Agent per Amazon Bedrock è supportata nelle seguenti Regioni: **** | Regione | | --- | | Stati Uniti orientali (Virginia settentrionale) | | Stati Uniti occidentali (Oregon) | | Europa (Francoforte) | **Supporto file** Con l’interpretazione del codice, puoi allegare file e quindi utilizzare i file allegati per porre domande e riassumere o analizzare i dati in base al contenuto dei file allegati. Puoi allegare un massimo di 5 file. La dimensione totale di tutti i file può essere di 10 MB. + **Tipi di file di input supportati**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT e PDF + **Tipi di file di output supportati**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT, PDF e PNG # Abilitazione dell’interpretazione del codice in Amazon Bedrock Puoi abilitare l’interpretazione del codice nella console Amazon Bedrock quando [crei](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html) o [aggiorni](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit) il tuo agente. Se si utilizza l'API o SDKs, è possibile abilitare l'interpretazione del codice quando si [crea](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) o si [aggiorna](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html) il gruppo di azioni. Per scoprire come abilitare l’interpretazione del codice in Amazon Bedrock, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per abilitare l’interpretazione del codice per 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. Accedi alla sezione **Impostazioni aggiuntive** ed espandila. 1. Per **Interprete di codice**, seleziona **Abilita**. 1. Assicurati innanzitutto di **salvare** e quindi di **preparare** per l’applicazione delle modifiche apportate all’agente prima di passare al relativo test. ------ #### [ API ] Per abilitare l'interpretazione del codice per il tuo agente, invia una [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)richiesta (consulta il link per i formati di richiesta e risposta e i dettagli dei campi) con un [endpoint di build Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica i seguenti campi: **** | Campo | Breve descrizione | | --- | --- | | actionGroupName | Nome del gruppo di operazioni | | parentActionGroupFirma | Specifica AMAZON.CodeInterpreter per consentire all’agente di generare e testare il codice | | actionGroupState | Specifica ENABLED per consentire all’agente di invocare l’interpretazione del codice | Di seguito viene illustrato il formato generale dei campi obbligatori per abilitare l'interpretazione del codice con una [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)richiesta. ``` CreateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "ENABLED" } ``` ------ # Test dell’interpretazione del codice in Amazon Bedrock Prima di testare l’interpretazione del codice in Amazon Bedrock, assicurati di preparare il tuo agente ad applicare le modifiche appena apportate. Quando inizi a testare il tuo agente con l’interpretazione del codice abilitata, puoi facoltativamente allegare file e scegliere come devono essere utilizzati per l’interpretazione del codice. A seconda del caso d’uso, puoi chiedere all’interpretazione del codice di utilizzare le informazioni presenti nei file allegati per riepilogare i contenuti del file e rispondere a domande relative a tali contenuti in una conversazione interattiva in chat. In alternativa, puoi chiedere all’interpretazione del codice di analizzare il contenuto dei file allegati e fornire metriche e report di visualizzazione dei dati. **Aggiunta di file allegati** Per scoprire come allegare file per l’interpretazione del codice, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per allegare file per l’interpretazione del codice** 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. Espandi **Impostazioni aggiuntive** e verifica che **Interprete di codice** sia abilitato. 1. Assicurati che l’agente sia pronto. 1. Se la finestra di test non è aperta, scegli **Test**. 1. Nella parte inferiore della finestra di test, seleziona l’icona della graffetta per allegare i file. 1. Nella pagina **Allega file** 1. **Per **Scegli la funzione**, specifica quanto segue:** + Se alleghi file che l’agente può utilizzare per rispondere alle tue query e riepilogare il contenuto, scegli **Allega file alla chat (più veloce)**. + Se alleghi file per l’interpretazione del codice, in modo da analizzare il contenuto e fornire metriche, scegli **Allega file all’interprete di codice**. 1. **Per **Scegli il metodo di caricamento**, scegli da dove vuoi caricare i tuoi file:** + Per caricarli dal tuo computer, seleziona **Scegli file** e seleziona i file da allegare. + Per caricarli dal Amazon S3, seleziona **Sfoglia S3**, quindi seleziona i file, seleziona **Scegli**, e quindi **Aggiungi**. 1. Scegli **Collega**. ------ #### [ API ] Per testare l'interpretazione del codice, invia una [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html)richiesta (consulta il link per i formati di richiesta e risposta e i dettagli sui campi) con un endpoint di [build Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). **Per allegare file che l’agente possa utilizzare per rispondere alle query e riepilogare il contenuto, specifica i seguenti campi:** **** | Campo | Breve descrizione | | --- | --- | | nome | Nome del file allegato. | | sourceType | Posizione del file da allegare. Specifica s3 se il file si trova nel bucket Amazon S3. Specifica byte\$1content se il file si trova sul computer. | | S3Location | Percorso S3 in cui si trova il file. Obbligatorio se sourceType è S3. | | mediaType | Tipo di file del file allegato. **Tipi di file di input supportati**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT e PDF | | data | Stringa con codifica Base64. La dimensione massima del file è 10 MB. Se utilizzi SDK, devi solo fornire il contenuto dei file in byte. AWS SDK codifica automaticamente le stringhe in base64. | | useCase | Modalità di utilizzo dei file allegati desiderata. Valori validi: CHAT \$1 CODE\$1INTERPRETER | L’esempio seguente mostra il formato generale per specificare i campi obbligatori per allegare i file alla chat. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": "uri": "s3Uri" } }, "useCase": "CHAT" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CHAT" } ] } ``` L’esempio seguente mostra il formato generale per specificare i campi obbligatori per allegare file per l’interpretazione del codice. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": { "uri": "s3Uri" } }, "useCase": "CODE_INTERPRETER" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CODE_INTERPRETER" } ] } ``` ------ # Disabilitazione dell’interpretazione del codice in Amazon Bedrock Puoi disabilitare l’interpretazione del codice in Amazon Bedrock in qualsiasi momento. Per scoprire come disabilitare l’interpretazione del codice, scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi sotto indicati. ------ #### [ Console ] **Per disabilitare l’interpretazione del codice** 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. Espandi la sezione **Impostazioni aggiuntive** e scegli **Disabilita** per **Interprete di codice**. 1. Nella parte superiore della pagina, seleziona **Prepara**, quindi seleziona **Salva** per salvare le modifiche all’agente. ------ #### [ API ] Per disabilitare l'interpretazione del codice, invia una [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)richiesta (consulta il link per i formati di richiesta e risposta e i dettagli dei campi) con un [endpoint di build Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica i seguenti campi: **** | Campo | Breve descrizione | | --- | --- | | actionGroupName | Nome del gruppo di operazioni | | parentActionGroupFirma | Specifica AMAZON.CodeInterpreter per disabilitare l’interprete di codice | | actionGroupState | Specifica DISABLED per disabilitare l’interprete di codice | L’esempio seguente mostra il formato generale per specificare i campi obbligatori per disabilitare l’interpretazione del codice. ``` UpdateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "DISABLED" } ``` ------ Dopo aver disabilitato l'interpretazione del codice per il tuo agente, assicurati di inviare una [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html)richiesta (consulta il link per i formati di richiesta e risposta e i dettagli dei campi) con un endpoint di [build Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).