Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Generieren, Ausführen und Testen von Code für Ihre Anwendung durch Aktivierung der Codeinterpretation Die Codeinterpretation ermöglicht es Ihrem Agenten, Ihren Anwendungscode in einer sicheren Testumgebung zu generieren, auszuführen und damit einhergehende Fehler zu beheben. Mit der Codeinterpretation können Sie das Basismodell des Agenten verwenden, um Code für die Implementierung grundlegender Funktionen zu generieren, während Sie sich auf die Entwicklung von Anwendungen mit generativer KI konzentrieren können. Mit der Codeinterpretation in Amazon Bedrock können Sie die folgenden Aufgaben ausführen: + Machen Sie sich mit den Benutzeranforderungen für bestimmte Aufgaben vertraut, generieren Sie Code, der die vom Benutzer angeforderten Aufgaben ausführen kann, führen Sie den Code aus und stellen Sie das Ergebnis der Codeausführung bereit. + Machen Sie sich mit den generischen Abfragen des Benutzers vertraut, generieren Sie Code und führen Sie ihn aus, um dem Benutzer eine Antwort zu geben. + Generieren Sie Code für die Analyse, Visualisierung und Bewertung der Daten. + Extrahieren Sie Informationen aus den vom Benutzer hochgeladenen Dateien, verarbeiten Sie die Informationen und beantworten Sie Benutzeranfragen. + Generieren Sie Code basierend auf den interaktiven Konversationen mit dem Benutzer zur schnellen Erstellung von Prototypen. Standardmäßig beträgt die maximale Anzahl gleichzeitig aktiver Codeinterpretationen pro Sitzung pro AWS-Konto 25. Das bedeutet, dass jedes AWS-Konto mithilfe des Codeinterpreters bis zu 25 laufende Konversationen mit den Agenten gleichzeitig führen kann. Im Folgenden sind einige Anwendungsfälle aufgeführt, in denen die Codeinterpretation durch die Generierung und Ausführung des Codes innerhalb von Amazon Bedrock hilfreich sein kann. 1. Analyse von Finanztransaktionen aus einer Datendatei wie einer CSV-Datei, um festzustellen, ob sie zu einem Gewinn oder Verlust geführt haben. 1. Konvertierung des Datumsformats, z. B. *14. März 2020*, in das API-Standardformat `YYYY-MM-DD` für Dateiformate wie .txt oder .csv 1. Durchführung von Datenanalysen in einer Tabelle (XLS) zur Berechnung von Metriken wie vierteljährlichen/jährlichen Unternehmensumsätzen oder der Bevölkerungswachstumsrate. So verwenden Sie die Codeinterpretation in Amazon Bedrock + Aktivieren Sie die Codeinterpretation, wenn Sie Ihren Agenten erstellen. Sobald Sie die Codeinterpretation aktiviert haben, können Sie sie verwenden. + Beginnen Sie mit der Verwendung der Codeinterpretation in Amazon Bedrock, indem Sie Prompts bereitstellen. Sie können zum Beispiel fragen: „Berechne die Quadratwurzel von Pi auf 127 Stellen“. Bei der Codeinterpretation wird Python-Code generiert und ausgeführt, um eine Antwort bereitzustellen. + Sie können auch Dateien anfügen. Sie können die Informationen in den Dateien heranziehen, um Fragen zu stellen und Daten zusammenzufassen oder zu analysieren. Sie können die Dateien entweder von Ihrem Computer oder aus dem Amazon-S3-Bucket anfügen. **Unterstützte Regionen** Die Codeinterpretation für Agenten für Amazon Bedrock wird in den folgenden Regionen unterstützt: **** | Region | | --- | | USA Ost (Nord-Virginia) | | USA West (Oregon) | | Europa (Frankfurt) | **Datei-Unterstützung** Mithilfe der Codeinterpretation können Sie Dateien anfügen und diese anschließend verwenden, um Fragen zu stellen und Daten, die auf dem Inhalt der angehängten Dateien basieren, zusammenzufassen oder zu analysieren. Sie können maximal fünf Dateien anfügen. Die Gesamtgröße aller Dateien darf maximal 10 MB betragen. + **Unterstützte Eingabedateitypen**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT und PDF + **Unterstützte Ausgabedateitypen**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT, PDF und PNG # Aktivieren der Codeinterpretation in Amazon Bedrock Sie können die Codeinterpretation in der Amazon-Bedrock-Konsole aktivieren, wenn Sie Ihren Agenten [erstellen](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html) oder [aktualisieren](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit). Wenn Sie API oder verwenden SDKs, können Sie die Codeinterpretation aktivieren, wenn Sie [eine Aktionsgruppe erstellen](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) oder [aktualisieren](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html). Um zu erfahren, wie Sie Dateien zur Codeinterpretation in Amazon Bedrock anhängen können, wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und führen Sie die folgenden Schritte aus: ------ #### [ Console ] **So aktivieren Sie die Codeinterpretation für Ihren Agenten** 1. Wenn Sie sich nicht bereits im Agent Builder befinden, gehen Sie wie folgt vor: 1. Melden Sie sich bei der AWS-Managementkonsole mit einer IAM-Identität an, die berechtigt ist, die Amazon Bedrock-Konsole zu verwenden. Öffnen Sie dann die Amazon Bedrock-Konsole unter [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Wählen Sie im linken Navigationsbereich die Option **Agenten** aus. Wählen Sie dann im Abschnitt **Agenten** einen Agenten aus. 1. Wählen Sie **In Agent Builder bearbeiten** aus. 1. Wechseln Sie zu **Erweiterte Einstellungen** und erweitern Sie den Abschnitt. 1. Wählen Sie für **Code Interpreter** die Option **Aktivieren** aus. 1. Vergewissern Sie sich, dass Sie zunächst den Vorgang **Speichern** und dann **Vorbereiten** durchführen, um die am Agenten vorgenommenen Änderungen zu übernehmen, bevor Sie den Agenten testen. ------ #### [ API ] Um die Codeinterpretation für Ihren Agenten zu aktivieren, senden Sie eine [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)Anfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem [Build-Time-Endpunkt für Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) und geben Sie die folgenden Felder an: **** | Feld | Kurzbeschreibung | | --- | --- | | actionGroupName | Der Name der Aktionsgruppe | | parentActionGroupSignatur | Geben Sie AMAZON.CodeInterpreter an, um zuzulassen, dass der Agent Code generieren und testen kann. | | actionGroupState | Geben Sie ENABLED an, dass der Agent die Codeinterpretation aufrufen kann. | Im Folgenden wird das allgemeine Format der erforderlichen Felder für die Aktivierung der Codeinterpretation bei einer [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)Anfrage dargestellt. ``` CreateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "ENABLED" } ``` ------ # Testen von Code-Interpretation in Amazon Bedrock Bevor Sie die Code-Interpretation in Amazon Bedrock testen, sollten Sie Ihren Agenten darauf vorbereiten, die soeben vorgenommenen Änderungen zu übernehmen. Wenn die Code-Interpretation aktiviert ist, können Sie, wenn Sie mit dem Testen Ihres Agenten beginnen, optional Dateien anhängen und auswählen, wie die angehängten Dateien für die Code-Interpretation verwendet werden sollen. Je nach Anwendungsfall können Sie die Code-Interpretation auffordern, die Informationen in den angehängten Dateien zu verwenden, um den Inhalt der Datei zusammenzufassen und Fragen zum Dateiinhalt während einer interaktiven Chat-Konversation zu beantworten. Alternativ können Sie die Code-Interpretation damit beauftragen, den Inhalt der angehängten Dateien zu analysieren und Metriken sowie Datenvisualisierungsberichte bereitzustellen. **Dateien anhängen** Um zu erfahren, wie Sie Dateien zur Code-Interpretation anhängen können, wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und befolgen Sie die angegebenen Schritte: ------ #### [ Console ] **Hängen Sie Dateien für die Code-Interpretation wie folgt an:** 1. Wenn Sie sich nicht bereits im Agent Builder befinden, gehen Sie wie folgt vor: 1. Melden Sie sich bei der AWS-Managementkonsole mit einer IAM-Identität an, die berechtigt ist, die Amazon Bedrock-Konsole zu verwenden. Öffnen Sie dann die Amazon Bedrock-Konsole unter [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Wählen Sie im linken Navigationsbereich die Option **Agenten** aus. Wählen Sie dann im Abschnitt **Agenten** einen Agenten aus. 1. Wählen Sie **In Agent Builder bearbeiten** aus. 1. Erweitern Sie **Zusätzliche Einstellungen** und vergewissern Sie sich, dass der **Code Interpreter** aktiviert ist. 1. Stellen Sie sicher, dass der Agent vorbereitet ist. 1. Wenn das Testfenster nicht geöffnet ist, wählen Sie **Testen** aus. 1. Wählen Sie unten im Testfenster das Büroklammersymbol aus, um Dateien anzuhängen. 1. Auf der Seite **Dateien anhängen**: 1. **Geben Sie bei **Funktion auswählen** Folgendes an:** + Wenn Sie Dateien anhängen, die der Agent verwenden kann, um Ihre Fragen zu beantworten und Inhalte zusammenzufassen, wählen Sie **Dateien an Chat anhängen (schneller)** aus. + Wenn Sie Dateien zur Code-Interpretation anhängen, um den Inhalt zu analysieren und Metriken bereitzustellen, wählen Sie **Dateien an den Code-Interpreter anhängen** aus. 1. **Wählen Sie unter **Upload-Methode auswählen** aus, wohin Sie Ihre Dateien hochladen möchten:** + Wenn Sie die Dateien von Ihrem Computer hochladen, wählen Sie **Dateien auswählen** aus und geben Sie an, welche Dateien angehängt werden sollen. + Wenn Sie Dateien von Amazon S3 hochladen, klicken Sie auf **S3 durchsuchen**, wählen Sie Dateien aus, klicken Sie dann auf **Auswählen** und anschließend auf **Hinzufügen**. 1. Wählen Sie **Anfügen** aus. ------ #### [ API ] Um die Codeinterpretation zu testen, senden Sie eine [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html)Anfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem [Build-Time-Endpunkt für Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). **Um Dateien anzuhängen, die der Agent zur Beantwortung Ihrer Anfragen und zur Zusammenfassung des Inhalts verwenden kann, geben Sie die folgenden Felder an:** **** | Feld | Kurzbeschreibung | | --- | --- | | Name | Name der angehängten Datei. | | sourceType | Speicherort der Datei, die angehängt werden soll. Geben Sie s3 an, wenn sich die Datei in einem Amazon-S3-Bucket befindet. Geben Sie byte\$1content an, wenn sich die Datei auf Ihrem Computer befindet. | | S3Location | Der S3-Pfad für den Speicherort ihrer Datei. Erforderlich, wenn es sich beim sourceType um S3 handelt. | | mediaType | Dateityp der angefügten Datei. **Unterstützte Eingabedateitypen**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT und PDF | | data | Base64-kodierte Zeichenfolge. Max. Dateigröße: 10 MB. Wenn Sie das SDK verwenden, müssen Sie nur den Datei-Byte-Inhalt angeben. AWS Das SDK codiert Zeichenketten automatisch nach Base64. | | useCase | Hierbei handelt es sich um die von Ihnen gewünschte Verwendung der angehängten Dateien. Zulässige Werte: CHAT \$1 CODE\$1INTERPRETER | Das folgende Beispiel zeigt das allgemeine Format für die Angabe der erforderlichen Felder zum Anhängen von Dateien an den 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" } ] } ``` Das folgende Beispiel zeigt das allgemeine Format für die Angabe der erforderlichen Felder zum Anhängen von Dateien für die Code-Interpretation. ``` "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" } ] } ``` ------ # Deaktivieren der Codeinterpretation in Amazon Bedrock Sie können die Codeinterpretation in Amazon Bedrock jederzeit deaktivieren. Um zu erfahren, wie Sie Dateien zur Codeinterpretation anhängen können, wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und führen Sie die folgenden Schritte aus: ------ #### [ Console ] **So deaktivieren Sie die Codeinterpretation** 1. Melden Sie sich bei der AWS-Managementkonsole mit einer IAM-Identität an, die berechtigt ist, die Amazon Bedrock-Konsole zu verwenden. Öffnen Sie dann die Amazon Bedrock-Konsole unter [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Wählen Sie im linken Navigationsbereich die Option **Agenten** aus. Wählen Sie dann im Abschnitt **Agenten** einen Agenten aus. 1. Wählen Sie **In Agent Builder bearbeiten** aus. 1. Erweitern Sie den Bereich **Zusätzliche Einstellungen** und wählen Sie **Deaktivieren** für **Code Interpreter** aus. 1. Wählen Sie oben auf der Seite die Option **Vorbereiten** aus. Wählen Sie anschließend **Speichern** aus, um die Änderungen in Ihrem Agenten zu speichern. ------ #### [ API ] Um die Codeinterpretation zu deaktivieren, senden Sie eine [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)Anfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem [Build-Time-Endpunkt für Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) und geben Sie die folgenden Felder an: **** | Feld | Kurzbeschreibung | | --- | --- | | actionGroupName | Der Name der Aktionsgruppe | | parentActionGroupSignatur | Geben Sie AMAZON.CodeInterpreter an, um den Codeinterpreter zu deaktivieren. | | actionGroupState | Geben Sie DISABLED an, um den Codeinterpreter zu deaktivieren. | Das folgende Beispiel zeigt das allgemeine Format für die Angabe der erforderlichen Felder zum Anhängen von Dateien für die Codeinterpretation. ``` UpdateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "DISABLED" } ``` ------ Nachdem Sie die Codeinterpretation für Ihren Agenten deaktiviert haben, stellen Sie sicher, dass Sie eine [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html)Anfrage (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem [Build-Time-Endpunkt für Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) senden.