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.
# Amazon Q Developer
Amazon Q Developer ist ein generativer KI-Konversationsassistent, der Ihnen hilft, besseren Code zu schreiben. Amazon Q Developer ist in Amazon SageMaker Studio in den folgenden IDEs Versionen verfügbar:
+ JupyterLab
+ Code Editor, basierend auf Code-OSS, Visual Studio Code – Open Source
In den folgenden Abschnitten können Sie Amazon Q Developer einrichten und in Ihrer Umgebung verwenden.
**Topics**
+ [Amazon Q Developer für Ihre Benutzer einrichten](studio-updated-amazon-q-admin-guide-set-up.md)
+ [Verwenden von Amazon Q, um Ihre Machine-Learning-Workflows zu beschleunigen](studio-updated-user-guide-use-amazon-q.md)
+ [Passen Sie Amazon Q Developer in Amazon SageMaker Studio-Anwendungen an](q-customizations.md)
# Amazon Q Developer für Ihre Benutzer einrichten
Amazon Q Developer ist ein generativer KI-Konversationsassistent. Sie können Amazon Q Developer innerhalb einer neuen Domain oder einer bestehenden Domain einrichten. Verwenden Sie die folgenden Informationen, um Amazon Q Developer einzurichten.
Mit Amazon Q Developer können Ihre Benutzer:
+ Lassen Sie sich step-by-step beraten, wie Sie SageMaker KI-Funktionen unabhängig oder in Kombination mit anderen AWS Diensten nutzen können.
+ Holen Sie sich Beispielcode, um mit Ihren ML-Aufgaben wie Datenaufbereitung, Training, Inferenz und MLOps zu beginnen.
+ Sie erhalten Unterstützung bei der Fehlerbehebung, um Fehler zu debuggen und zu beseitigen, die beim Ausführen von Code aufgetreten sind.
**Anmerkung**
Amazon Q Developer in Studio verwendet keine Benutzerinhalte, um den Service zu verbessern, unabhängig davon, ob Sie das Free-Tier- oder das Pro-Abonnement verwenden. Für die Weitergabe von Telemetriedaten auf IDE-Ebene kann Amazon Q die Nutzung Ihrer Benutzer verfolgen, beispielsweise die Anzahl der gestellten Fragen und ob Empfehlungen angenommen oder abgelehnt wurden. Diese Telemetriedaten enthalten keine persönlich identifizierbaren Informationen wie die IP-Adresse der Benutzer. Weitere Informationen zum Datenschutz und Anweisungen zur Deaktivierung finden Sie unter [Deaktivierung der Datenfreigabe in der IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html).
Sie können Amazon Q Developer entweder mit einem Pro- oder Free-Abonnement einrichten. Bei der Pro-Stufe handelt es sich um einen kostenpflichtigen Abonnementdienst mit höheren Nutzungslimits und anderen Funktionen. Weitere Informationen zu den Unterschieden zwischen den Stufen finden Sie unter [Grundlegendes zu den Servicestufen für Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html).
Informationen zum Abonnieren von Amazon Q Developer Pro finden Sie unter [Amazon Q Developer Pro abonnieren](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html).
## Anweisungen zur Einrichtung des kostenlosen Kontingents für Amazon Q Developer:
Gehen Sie wie folgt vor, um das kostenlose Kontingent von Amazon Q Developer einzurichten:
**So richten Sie das kostenlose Kontingent für Amazon Q Developer ein**
1. Fügen Sie der IAM-Rolle, mit der Sie Ihren Bereich JupyterLab oder den Code-Editor erstellt haben, die folgende Richtlinie hinzu:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"q:SendMessage"
],
"Resource": [
"*"
]
},
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Navigieren Sie zu Amazon SageMaker Studio.
1. Öffnen Sie Ihren Bereich JupyterLab oder den Code-Editor.
1. **Navigiere zum **Launcher und wähle Terminal**.**
1. Gehen Sie in JupyterLab wie folgt vor:
1. Geben Sie an `restart-jupyter-server`.
1. Starten Sie Ihren Browser neu und navigieren Sie zurück zu Amazon SageMaker Studio.
## Anweisungen zur Einrichtung der Amazon Q Developer Pro-Stufe:
**Voraussetzungen**
Um Amazon Q Pro einzurichten, benötigen Sie:
Eine für Ihre Organisation eingerichtete Amazon SageMaker AI-Domain mit konfiguriertem IAM Identity Center als Zugriffsmittel.
Ein Amazon Q Developer Pro-Abonnement.
Wenn Sie eine Domain aktualisieren, die Sie bereits für Ihre Organisation eingerichtet haben, müssen Sie sie aktualisieren, um Amazon Q Developer verwenden zu können. Sie können entweder die AWS-Managementkonsole oder die verwenden AWS Command Line Interface , um eine Domain zu aktualisieren.
Sie müssen den ARN Ihres Amazon Q Developer-Profils verwenden. Sie finden den Q Profile ARN auf der Seite [Q Developer Settings](https://console.aws.amazon.com/amazonq/developer/settings).
Sie können den folgenden AWS Command Line Interface Befehl verwenden, um Ihre Domain zu aktualisieren:
```
aws --region AWS-Region sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}"
```
Sie können auch das folgende Verfahren verwenden, um die Domain innerhalb des zu aktualisieren AWS-Managementkonsole.
1. Navigieren Sie zur [Amazon SageMaker AI-Konsole](https://console.aws.amazon.com/sagemaker).
1. Wählen Sie Domains aus.
1. Wählen Sie **App-Konfigurationen** aus.
1. Wählen Sie für **Amazon Q Developer for SageMaker AI Applications** die Option **Bearbeiten** aus.
1. Wählen Sie **Amazon Q Developer auf dieser Domain aktivieren** aus.
1. Geben Sie die Q-Profil-ARN an.
1. Wählen Sie **Absenden** aus.
Sie müssen den ARN Ihres Amazon Q Developer-Profils verwenden. Sie finden den ARN des Q-Profils auf der Seite mit den **Amazon Q-Kontodetails** der [Amazon Q Developer](https://console.aws.amazon.com/amazonq/developer) Console.
Die **Einrichtung für Organisationen** ist eine erweiterte Einrichtung für die Amazon SageMaker AI-Domain, mit der Sie IAM Identity Center verwenden können. Weitere Informationen zum Einrichten der Domain und zum Einrichten des vertrauenswürdigen Zugriffs für IAM Identity Center finden Sie unter [Benutzerdefiniertes Setup für Amazon SageMaker AI verwenden](onboard-custom.md).
Wenn Sie Amazon Q Developer in einer neuen Domain einrichten, können Sie entweder den AWS-Managementkonsole oder den folgenden AWS Command Line Interface Befehl von Ihrem lokalen Computer aus verwenden:
```
aws --region AWS-Region sagemaker create-domain --domain-id domain-id --domain-name "example-domain-name" --vpc-id example-vpc-id --subnet-ids example-subnet-ids --auth-mode SSO --default-user-settings "ExecutionRole=arn:aws:iam::111122223333:role/IAM-role",--domain-settings "AmazonQSettings={status=ENABLED,qProfileArn=Q-profile-ARN" --query example-domain-ARN--output text
```
Sie können den folgenden AWS CLI Befehl verwenden, um Amazon Q Developer zu deaktivieren:
```
aws --region AWS-Region sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}"
```
Wir empfehlen, die neueste Version von AWS Command Line Interface zu verwenden. Informationen zur Aktualisierung von finden [Sie unter Installation oder Aktualisierung auf die neueste Version von AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). AWS CLI
Wenn Sie eine Verbindung zwischen Amazon Q Developer und Ihrer VPC herstellen müssen, finden Sie weitere Informationen unter [Erstellen eines VPC-Schnittstellen-Endpunkts für Amazon](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create) Q.
**Anmerkung**
Für Amazon Q Developer gelten folgende Einschränkungen:
Shared Bereiche werden nicht unterstützt.
Amazon Q Developer erkennt, ob ein Codevorschlag dem öffentlich verfügbaren Code möglicherweise zu ähnlich ist. Der Referenz-Tracker kann Vorschläge mit Repository URLs und Lizenzen kennzeichnen oder herausfiltern. Auf diese Weise können Sie den referenzierten Code und seine Verwendung überprüfen, bevor Sie ihn übernehmen. Alle Verweise werden protokolliert, sodass Sie sie später überprüfen können, um sicherzustellen, dass Ihr Codefluss nicht gestört wird und Sie ohne Unterbrechung weiterprogrammieren können.
Weitere Informationen zu Codereferenzen finden Sie unter [Verwenden von Codereferenzen — Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html) and [AI Coding Assistant — Amazon Q Developer FAQs](https://aws.amazon.com/q/developer/faqs/?refid=255ccf7b-4a76-4dcb-9b07-68709e2b636b#:~:text=Can%20I%20prevent%20Amazon%20Q%20Developer%20from%20recommending%20code%20with%20code%20references%3F).
Amazon Q verarbeitet alle Benutzerinteraktionsdaten in der AWS-Region USA Ost (Nord-Virginia). Weitere Informationen darüber, wie Amazon Q Daten verarbeitet und welche AWS-Regionen es unterstützt, finden Sie unter [Unterstützte Regionen für Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html).
Amazon Q funktioniert nur in Amazon SageMaker Studio. Es wird in Amazon SageMaker Studio Classic nicht unterstützt.
On JupyterLab funktioniert Amazon Q innerhalb von SageMaker AI Distribution Images Version 2.0 und höher. Im Code-Editor funktioniert Amazon Q mit SageMaker AI Distribution Images Version 2.2.1 und höher.
Amazon Q Developer JupyterLab funktioniert innerhalb der Jupyter AI-Erweiterung. Sie können keine anderen 3P-Modelle innerhalb der Erweiterung verwenden, während Sie Amazon Q verwenden.
## Amazon Q-Anpassungen in Amazon SageMaker AI
Wenn Sie Amazon Q Developer Pro verwenden, haben Sie die Möglichkeit, *Anpassungen* zu erstellen. Mit Anpassungen bietet Amazon Q Developer Vorschläge, die auf der Codebasis Ihres Unternehmens basieren. Wenn Sie Anpassungen in Amazon Q Developer erstellen, können Sie diese in Amazon SageMaker Studio JupyterLab und im Code-Editor verwenden. Weitere Informationen zum Einrichten von Anpassungen finden Sie unter [Anpassungsvorschläge](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) im *Amazon Q Developer User Guide*.
# Verwenden von Amazon Q, um Ihre Machine-Learning-Workflows zu beschleunigen
Amazon Q Developer ist Ihr KI-gestütztes Begleittool für die Entwicklung von Machine Learning. Mit Amazon Q Developer können Sie:
+ Lassen Sie sich step-by-step beraten, wie Sie SageMaker KI-Funktionen unabhängig oder in Kombination mit anderen AWS Diensten nutzen können.
+ Holen Sie sich Beispielcode, um mit Ihren ML-Aufgaben wie Datenaufbereitung, Training, Inferenz und MLOps zu beginnen.
Um Amazon Q Developer zu verwenden, wählen Sie **Q** in der linken Navigationsleiste Ihrer JupyterLab oder Code Editor-Umgebung aus.
Wenn Sie das **Q**-Symbol nicht sehen, muss Ihr Administrator es für Sie einrichten. Weitere Informationen über die Einrichtung von Amazon Q Developer finden Sie unter [Amazon Q Developer für Ihre Benutzer einrichten](studio-updated-amazon-q-admin-guide-set-up.md).
Amazon Q bietet automatisch Vorschläge, die Ihnen beim Schreiben Ihres Codes helfen. Sie können auch über die Chat-Oberfläche nach Vorschlägen fragen.
# Passen Sie Amazon Q Developer in Amazon SageMaker Studio-Anwendungen an
Sie können Amazon Q Developer in den Anwendungen JupyterLab und Code Editor in Amazon SageMaker Studio anpassen. Wenn Sie Q Developer anpassen, erhalten Sie Vorschläge und Antworten, die auf Beispielen aus Ihrer Codebasis basieren. Wenn Sie Amazon Q Developer Pro verwenden, können Sie alle Anpassungen laden, die Sie mit diesem Service erstellt haben.
## Anpassen in JupyterLab
In JupyterLab können Sie alle Anpassungen laden, die Sie mit Amazon Q Developer Pro erstellt haben. Oder Sie können Q Developer in Ihrem JupyterLab Bereich lokal mit Dateien anpassen, die Sie in den Space hochladen.
### So verwenden Sie Anpassungen, die Sie in Amazon Q Developer Pro erstellt haben
Wenn Sie eine Anpassung laden, bietet Q Developer Vorschläge, die auf der Codebasis basieren, mit der Sie die Anpassung erstellt haben. Wenn Sie den Chat im **Amazon Q-Panel** verwenden, interagieren Sie außerdem mit Ihrer Anpassung.
Weitere Informationen zum Einrichten von Anpassungen finden Sie unter [Anpassungsvorschläge](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) im *Amazon Q Developer User Guide*.
**Um Ihre Anpassung zu laden**
Öffnen Sie Ihren JupyterLab Bereich und führen Sie die folgenden Schritte aus.
1. Wählen Sie in der Statusleiste am unteren JupyterLab Rand **Amazon Q** aus. Ein Menü wird geöffnet.
1. Wählen Sie im Menü „**Andere Funktionen**“. Die Registerkarte **Amazon-Q-Features** wird im Hauptarbeitsbereich geöffnet.
1. Wählen Sie auf der Registerkarte **Amazon Q-Funktionen** unter **Select Customization** Ihre Q Developer-Anpassung aus.
1. Interagieren Sie mit Ihrer Anpassung mit einer der folgenden Methoden:
+ Erstelle ein Notebook und schreibe Code hinein. Dabei bietet Q Developer automatisch maßgeschneiderte Inline-Vorschläge, die auf Ihren Anpassungen basieren.
+ Chatten Sie mit Q Developer im **Amazon Q-Panel**, indem Sie diesen Schritten folgen:
1. Wählen Sie in der linken Seitenleiste das **Jupyter** AI Chat-Symbol aus. JupyterLab Das **Amazon Q-Panel** wird geöffnet.
1. Verwenden Sie das Chatfeld „**Frag Amazon Q**“, um mit Ihrer Anpassung zu interagieren.
### So passen Sie Amazon Q Developer mit Dateien in Ihrem JupyterLab Bereich an
JupyterLabIn können Sie Q Developer mit Dateien anpassen, die Sie in Ihren Bereich hochladen. Anschließend können Sie im Chat im **Amazon Q-Bereich** einen Befehl verwenden, um Q Developer nach diesen Dateien zu fragen.
Wenn Sie Q Developer mit Dateien in Ihrem Bereich anpassen, ist die Anpassung nur in Ihrem Bereich verfügbar. Sie können die Anpassung nicht an anderer Stelle laden, beispielsweise in anderen Bereichen oder in der Konsole Amazon Q Developer.
Sie können Q Developer mit Dateien anpassen, JupyterLab wenn Sie entweder Amazon Q Developer Pro oder Amazon Q Developer im Rahmen des kostenlosen Kontingents verwenden.
**Zur Anpassung mit Ihren Dateien**
Öffnen Sie Ihren JupyterLab Bereich und führen Sie die folgenden Schritte aus.
1. Prüfen Sie, ob Ihr Space mit dem erforderlichen Einbettungsmodell konfiguriert ist. Sie können Q Developer JupyterLab nur anpassen, wenn Sie das Standard-Einbettungsmodell verwenden, nämlich **CodeSage : codesage-small**. Zur Überprüfung gehen Sie folgendermaßen vor:
1. **Wählen Sie in der linken Seitenleiste das Jupyter JupyterLab AI Chat-Symbol aus.** Das **Amazon Q-Panel** wird geöffnet.
1. Wählen Sie das Symbol für Einstellungen in der oberen rechten Ecke des Fensters.
1. **Wählen **Sie bei Bedarf unter Modell einbetten** die Option **CodeSage : codesage-small** und dann Änderungen speichern aus.**
1. Wählen Sie in der oberen rechten Ecke des Fensters das Zurück-Symbol.
1. **Um Dateien hochzuladen, mit denen Sie Q Developer personalisieren möchten, wählen Sie im **Dateibrowser-Bereich das Symbol** „Dateien hochladen“.**
1. Nachdem Sie Ihre Dateien hochgeladen haben, geben Sie in das Chatfeld **Ask Amazon Q** den Text ein`/learn file path/`. Ersetzen Sie *file path/* durch den Pfad zu Ihren Dateien in Ihrem Space. JupyterLab Wenn Amazon Q die Verarbeitung Ihrer Dateien abgeschlossen hat, wird dies mit einer Chat-Nachricht im Amazon Q-Panel bestätigt.
1. Um Q Developer eine Frage zu Ihren Dateien zu stellen, geben Sie den `/ask` Text in das Chat-Feld ein und folgen Sie dem Befehl mit Ihrer Frage. Amazon Q generiert eine Antwort auf der Grundlage Ihrer Dateien und antwortet im Chat.
Weitere Informationen zu den Befehlen `/learn` und `/ask` ihren Optionen sowie den unterstützten Argumenten finden Sie im Abschnitt [Informationen zu lokalen Daten](https://jupyter-ai.readthedocs.io/en/latest/users/index.html#learning-about-local-data) in der Jupyter-AI-Benutzerdokumentation. Auf dieser Seite wird erklärt, wie Sie die Befehle mit dem Jupyternaut AI-Chatbot verwenden. JupyterLabin Amazon SageMaker Studio unterstützt dieselbe Befehlssyntax.
## Im Code-Editor anpassen
Wenn Sie eine Anpassung in Amazon Q Developer Pro erstellt haben, können Sie sie im Code-Editor laden. Wenn Q Developer dann Vorschläge für Ihren Code macht, basieren diese auf der Codebasis, mit der Sie die Anpassung erstellt haben. Wenn Sie den Chat im **Amazon Q: Chat-Panel** verwenden, interagieren Sie außerdem mit Ihrer Anpassung.
**So verwenden Sie Anpassungen, die Sie in Amazon Q Developer Pro erstellt haben**
Öffnen Sie Ihren Code-Editor-Bereich und führen Sie die folgenden Schritte aus.
1. Wählen Sie im Code-Editor-Menü „**Ansicht**“ und anschließend „**Befehlspalette“**.
1. Beginnen Sie in der Befehlspalette mit der Eingabe **>Amazon Q: Select Customization** und wählen Sie diese Option in der gefilterten Befehlsliste aus, sobald sie angezeigt wird. In der Befehlspalette werden Ihre Q Developer-Anpassungen angezeigt.
1. Wählen Sie Ihre Anpassung.
1. Interagieren Sie mit Ihrer Anpassung mit einer der folgenden Methoden:
+ Erstellen Sie eine Python-Datei oder ein Jupyter-Notebook und schreiben Sie Code hinein. Dabei bietet Q Developer automatisch maßgeschneiderte Inline-Vorschläge, die auf Ihren Anpassungen basieren.
+ Chatten Sie mit Q Developer im **Amazon Q-Panel**, indem Sie diesen Schritten folgen:
1. Wählen Sie in der linken Seitenleiste des Code-Editors das **Amazon Q-Symbol** aus. Das **Amazon Q: Chat-Panel** wird geöffnet.
1. Verwenden Sie das Chat-Feld, um mit Ihrer Anpassung zu interagieren.
Weitere Informationen zu den Funktionen von Q Developer finden Sie unter [Using Amazon Q Developer in the IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE.html) im *Amazon Q Developer User Guide*.