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.
# Manuelles Erstellen und Konfigurieren von Agenten
# Voraussetzungen für die Erstellung von Agenten für Amazon Bedrock
Stellen Sie sicher, dass Ihre IAM-Rolle über die [erforderlichen Berechtigungen](security_iam_id-based-policy-examples-agent.md#iam-agents-ex-all) verfügt, um Aktionen im Zusammenhang mit Agenten für Amazon Bedrock durchzuführen.
Lesen Sie vor der Erstellung eines Agenten die folgenden Voraussetzungen und bestimmen Sie, welche Sie erfüllen müssen:
1. Sie müssen mindestens eines der folgenden Elemente für Ihren Agenten einrichten:
+ [Aktionsgruppe](agents-action-create.md) – Definiert Aktionen, bei deren Ausführung der Agent dem Benutzer helfen kann. Jede Aktionsgruppe enthält die Parameter, die der Agent beim Endbenutzer abfragen muss. Sie können auch die APIs definieren, die aufgerufen werden können, wie mit der Aktion umgegangen und wie die Antwort zurückgegeben werden soll. Informationen zum Kontingent für Aktionsgruppen in einem Agenten finden Sie unter Kontingent für **Aktionsgruppen pro Agent** unter [Amazon-Bedrock-Endpunkte und -Kontingente](https://docs.aws.amazon.com/general/latest/gr/bedrock.html) in der Allgemeine AWS-Referenz. Sie können diese Voraussetzung überspringen, wenn Sie planen, keine Aktionsgruppen für Ihren Agenten einzurichten.
+ [Wissensdatenbanken](knowledge-base.md) – Bieten eine Sammlung von Informationen, die der Agent abfragen kann, um Kundenanfragen zu beantworten und die generierten Antworten zu verbessern. Die Verknüpfung von mindestens einer Wissensdatenbank kann dazu beitragen, die Antworten auf Kundenabfragen zu verbessern, indem private Datenquellen verwendet werden. Informationen zum Kontingent für Wissensdatenbanken, die einem Agenten zugeordnet sind, finden Sie unter Kontingent für **zugeordnete Wissensdatenbanken pro Agent** unter [Amazon-Bedrock-Endpunkte und -Kontingente](https://docs.aws.amazon.com/general/latest/gr/bedrock.html) in der Allgemeine AWS-Referenz. Sie können diese Voraussetzung überspringen, wenn Sie planen, Ihrem Agenten keine Wissensdatenbanken zuzuordnen.
1. (Optional) [Erstellen Sie eine benutzerdefinierte AWS Identity and Access Management-[-Servicerolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) (IAM) für Ihren Agenten mit den entsprechenden Berechtigungen](agents-permissions.md). Sie können diese Voraussetzung überspringen, wenn Sie die AWS-Managementkonsole verwenden möchten, um automatisch eine Servicerolle für Sie zu erstellen.
1. (Optional) Erstellen Sie einen [Integritätsschutz](guardrails.md), um Schutzmaßnahmen für Ihren Agenten zu implementieren und unerwünschtes Verhalten durch Modellantworten und Benutzernachrichten zu verhindern. Sie können ihn dann Ihrem Agenten zuordnen.
1. (Optional) Kaufen Sie [bereitgestellten Durchsatz](prov-throughput.md), um die Anzahl und Rate der Token zu erhöhen, die Ihr Agent in einem bestimmten Zeitraum verarbeiten kann. Sie können ihn dann einem Alias Ihres Agenten zuordnen, wenn Sie [eine Version Ihres Agenten erstellen und ihm einen Alias zuordnen](agents-deploy.md).
Zum Erstellen eines Agenten mit Amazon Bedrock richten Sie die folgenden Komponenten ein:
+ Die Konfiguration des Agenten, die den Zweck des Agenten und das Basismodell definiert und das Basismodell (FM) angibt, mit dem er Prompts und Antworten generiert.
+ Mindestens eine der folgenden Optionen:
+ Aktionsgruppen, die definieren, welche Aktionen der Agent ausführen soll.
+ Eine Wissensdatenbank mit Datenquellen, die die generativen Fähigkeiten des Agenten durch Such- und Abfragefunktionen erweitert.
Sie können mindestens einen Agenten erstellen, der nur einen Namen hat. Um einen Agenten so **vorzubereiten**, dass Sie ihn [testen](agents-test.md) oder [bereitstellen](agents-deploy.md) können, müssen Sie mindestens die folgenden Komponenten konfigurieren:
****
| Konfiguration | Beschreibung |
| --- | --- |
| Rolle „Agentenressource“ | Der ARN der [Servicerolle mit Berechtigungen zum Aufrufen von API-Operationen auf dem Agenten anzugeben](agents-permissions.md) |
| Basismodelle (FM) | Ein FM, das der Agent aufrufen kann, um die Orchestrierung durchzuführen |
| Anweisungen | Natürliche Sprache, die beschreibt, welche Aktionen der Agent ausführen und wie er mit Benutzern interagieren soll |
Sie sollten außerdem mindestens eine Aktionsgruppe oder Wissensdatenbank für den Agenten konfigurieren. Wenn Sie einen Agenten ohne Aktionsgruppen oder Wissensdatenbanken vorbereiten, gibt dieser nur Antworten zurück, die auf dem FM, den Anweisungen und den [Basisvorlagen für Prompts](advanced-prompts.md) basieren.
Wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und führen Sie dann die Schritte aus, um zu erfahren, wie Sie einen Agenten erstellen:
------
#### [ Console ]
**So erstellen Sie einen Agenten**
1. Melden Sie sich bei der AWS-Managementkonsole mit einer IAM-Identität an, die zur Verwendung der Amazon-Bedrock-Konsole berechtigt ist. Ö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.
1. Wählen Sie im Abschnitt **Agenten** die Option **Agent erstellen** aus.
1. (Optional) Ändern Sie den automatisch generierten **Namen** für den Agenten und geben Sie optional eine **Beschreibung** dafür ein.
1. Wählen Sie **Erstellen** aus. Ihr Agent wird erstellt und Sie werden zum **Agent Builder** für Ihren neu erstellten Agent weitergeleitet. Hier können Sie Ihren Agent konfigurieren.
1. Sie können mit dem folgenden Verfahren fortfahren, um Ihren Agent zu konfigurieren, oder später zum Agent Builder zurückkehren.
**Konfigurieren Ihres 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 zur Verwendung der Amazon-Bedrock-Konsole berechtigt ist. Ö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. Im Abschnitt **Agentendetails** können Sie die folgenden Konfigurationen einrichten:
1. Bearbeiten Sie den **Agentennamen** oder die **Agentenbeschreibung**.
1. Wählen Sie für die **Rolle „Agentenressource“** eine der folgenden Optionen aus:
+ **Eine neue Servicerolle erstellen und verwenden** – Lassen Sie Amazon Bedrock die Servicerolle erstellen und die erforderlichen Berechtigungen in Ihrem Namen einrichten.
+ **Eine vorhandene Servicerolle verwenden** – Wählen Sie eine [benutzerdefinierte Rolle](agents-permissions.md) aus, die Sie zuvor konfiguriert haben.
1. Wählen Sie für **Modell auswählen** ein FM aus, das Ihr Agent während der Orchestrierung aufrufen soll.
Standardmäßig werden für Agenten optimierte Modelle angezeigt. Um alle Modelle anzuzeigen, die von Agenten für Amazon Bedrock unterstützt werden, deaktivieren Sie **Für Bedrock-Agenten optimiert** aus.
![\[Sie können Agenten mit jedem beliebigen Basismodell erstellen. Derzeit sind einige der angebotenen Modelle mit Prompts/Parsern optimiert, die speziell auf die Integration in die Agentenarchitektur abgestimmt sind. Im Laufe der Zeit planen wir, Optimierungen für alle angebotenen Modelle anzubieten.\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/images/agents/agents-optimized-model-selection.png)
1. Geben Sie im Feld **Anweisungen für den Agenten** Details an, um dem Agenten mitzuteilen, welche Aktionen er ausführen und wie er mit Benutzern interagieren soll. Die Anweisungen ersetzen den \$1instructions\$1-Platzhalter in der [Prompt-Vorlage für die Orchestrierung](prompt-placeholders.md#placeholders-orchestration). Im Folgenden finden Sie ein Beispiel für Anweisungen:
```
You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.
```
1. Wenn Sie **Zusätzliche Einstellungen** erweitern, können Sie die folgenden Konfigurationen ändern:
+ **Codeinterpreter** – (Optional) Wählen Sie aus, ob der Agent Aufgaben ausführen kann, die das Schreiben, Ausführen, Testen und Beheben von Code beinhalten. Details hierzu finden Sie unter [Generieren, Ausführen und Testen von Code mit der Codeinterpretation](agents-code-interpretation.md).
+ **Benutzereingabe** – (Optional) Wählen Sie aus, ob der Agent weitere Informationen vom Benutzer anfordern kann, wenn er nicht über genügend Informationen verfügt. Details hierzu finden Sie unter [Konfigurieren des Agenten zum Anfordern von Informationen vom Benutzer](agents-user-input.md).
+ **KMS-Schlüsselauswahl** – (Optional) AWS verschlüsselt Agentenressourcen standardmäßig mit einemVon AWS verwalteter Schlüssel. Wählen Sie im Abschnitt „KMS-Schlüsselauswahl“ die Option **Verschlüsselungseinstellungen anpassen (erweitert)** aus, um Ihren Agent mit einem kundenseitig verwalteten Schlüssel (CMK) zu verschlüsseln. Wenn Sie einen neuen Schlüssel erstellen möchten, wählen Sie **Einen AWS KMS-Schlüssel erstellen** aus, und aktualisieren Sie dieses Fenster anschließend. Um einen vorhandenen Schlüssel zu verwenden, wählen Sie für **Einen AWS KMS-Schlüssel auswählen** einen Schlüssel aus.
+ **Timeout für inaktive Sitzungen** – Wenn ein Benutzer in einer Sitzung mit einem Amazon-Bedrock-Agenten 30 Minuten lang nicht geantwortet hat, wird der Konversationsverlauf standardmäßig nicht mehr vom Agenten beibehalten. Der Gesprächsverlauf wird sowohl zur Wiederaufnahme einer Interaktion als auch zur Ergänzung der Antworten mit dem Kontext aus dem Gespräch verwendet. Um diese Standarddauer zu ändern, geben Sie eine Zahl in das Feld **Sitzungs-Timeout** ein und wählen Sie eine Zeiteinheit aus.
1. Wählen Sie für den Abschnitt **IAM-Berechtigungen** unter **Agent-Ressourcenrolle** eine [Servicerolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) aus. Wählen Sie **Eine neue Servicerolle erstellen und verwenden** aus, um Amazon Bedrock die Servicerolle in Ihrem Namen erstellen zu lassen. Wählen Sie **Eine vorhandene Servicerolle verwenden** aus, wenn Sie eine [benutzerdefinierte Rolle](agents-permissions.md) verwenden möchten.
**Anmerkung**
Die Servicerolle, die Amazon Bedrock für Sie erstellt, unterstützt keine Berechtigungen für Features in der Vorschauversion. Um diese Features zu verwenden, [fügen Sie der Servicerolle die richtigen Berechtigungen an](agents-permissions.md).
1. (Optional) AWS verschlüsselt Agentenressourcen standardmäßig mit einem Von AWS verwalteter Schlüssel. Wählen Sie im Abschnitt **KMS-Schlüsselauswahl** die Option **Verschlüsselungseinstellungen anpassen (erweitert)** aus, um Ihren Agent mit einem kundenseitig verwalteten Schlüssel (CMK) zu verschlüsseln. Wenn Sie einen neuen Schlüssel erstellen möchten, wählen Sie **Einen AWS KMS-Schlüssel erstellen** aus, und aktualisieren Sie dieses Fenster anschließend. Um einen vorhandenen Schlüssel zu verwenden, wählen Sie für **Einen AWS KMS-Schlüssel auswählen** einen Schlüssel aus.
1. (Optional) Um diesem Agenten Tags zuzuordnen, wählen Sie im Abschnitt **Tags – optional** die Option **Neues Tag hinzufügen** aus und geben Sie ein Schlüssel-Wert-Paar an.
1. Wählen Sie **Weiter** aus, wenn Sie mit der Einrichtung der Agentenkonfiguration fertig sind.
1. Im Abschnitt **Aktionsgruppen** können Sie **Hinzufügen** auswählen, um Ihrem Agenten Aktionsgruppen hinzuzufügen. Weitere Informationen zum Einrichten von Aktionsgruppen finden Sie unter [Verwenden von Aktionsgruppen, um Aktionen zu definieren, die Ihr Agent ausführen soll](agents-action-create.md). Weitere Informationen dazu, wie Sie Ihrem Agenten Aktionsgruppen Agenten hinzufügen, finden Sie unter [Hinzufügen einer Aktionsgruppe zu Ihrem Agenten in Amazon Bedrock](agents-action-add.md).
1. Im Abschnitt **Wissensdatenbanken** können Sie **Hinzufügen** auswählen, um Ihrem Agenten Wissensgruppen zuzuordnen. Weitere Informationen zum Einrichten von Wissensdatenbanken finden Sie unter [Abrufen von Daten und Generieren von KI-Antworten mit Wissensdatenbanken für Amazon Bedrock](knowledge-base.md). Weitere Informationen zum Verknüpfen von Wissensdatenbanken mit Ihrem Agenten finden Sie unter [Verbessern der Antwortgenerierung für Ihren Agenten mit einer Wissensdatenbank](agents-kb-add.md).
1. Im Abschnitt **Details zum Integritätsschutz** können Sie **Bearbeiten** auswählen, um Ihrem Agenten einen Integritätsschutz zuzuordnen, sodass schädliche Inhalte blockiert und herausgefiltert werden. Wählen Sie im Dropdown-Menü unter **Integritätsschutz auswählen** den Integritätsschutz, den Sie verwenden möchten, und dann unter **Integritätsschutzversion** die zu verwendende Version aus. Sie können **Anzeigen** auswählen, um die Einstellungen für den Integritätsschutz anzuzeigen. Weitere Informationen finden Sie unter [So erkennen und filtern Sie schädliche Inhalte mithilfe vom Integritätsschutz für Amazon Bedrock](guardrails.md).
1. Im Abschnitt **Orchestrierungsstrategie** können Sie **Bearbeiten** auswählen, um die Orchestrierung Ihres Agenten anzupassen. Weitere Informationen zur Orchestrierungsstrategie, die Sie für Ihren Agenten verwenden können, finden Sie unter [Anpassen der Strategie zur Agentenorchestrierung](orch-strategy.md).
1. Im Abschnitt **Zusammenarbeit mehrerer Agenten** können Sie **Bearbeiten** auswählen, um ein Team für die Zusammenarbeit mehrerer Agenten zu erstellen. Weitere Informationen zur Zusammenarbeit mehrerer Agenten finden Sie unter [Verwenden der Zusammenarbeit mehrerer Agenten mit Agenten für Amazon Bedrock](agents-multi-agent-collaboration.md).
1. Wenn Sie mit der Konfiguration Ihres Agenten fertig sind, wählen Sie eine der folgenden Optionen aus:
+ Um im **Agent Builder** zu bleiben, wählen Sie **Speichern** aus. Anschließend können Sie den Agenten **vorbereiten**, um ihn mit Ihren aktualisierten Konfigurationen im Testfenster zu testen. Weitere Informationen zum Testen Ihres Agenten finden Sie unter [Testen des Verhaltens von Agenten und Beheben von Fehlern](agents-test.md).
+ Um zur Seite **Details zum Agenten** zurückzukehren, wählen Sie **Speichern und beenden** aus.
------
#### [ API ]
Um einen neuen Agenten zu erstellen, senden Sie die Anfrage [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html) (siehe Link für Anfrage- und Antwortformate und Felddetails) mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
[Siehe Codebeispiele](bedrock-agent_example_bedrock-agent_CreateAgent_section.md)
Um Ihren Agenten vorzubereiten und zu testen oder bereitzustellen, sodass Sie ihn [testen](agents-test.md) oder [bereitstellen](agents-deploy.md) können, müssen Sie mindestens die folgenden Felder angeben (wenn Sie möchten, können Sie diese Konfigurationen überspringen und sie später konfigurieren, indem Sie eine [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html)-Anfrage senden):
****
| Feld | Anwendungsfall |
| --- | --- |
| agentResourceRoleArn | Um einen ARN der Servicerolle mit Berechtigungen zum Aufrufen von API-Operationen auf dem Agenten anzugeben |
| foundationModel | Um ein Basismodell (FM) anzugeben, mit dem der Agent orchestrieren soll |
| instruction | Um dem Agenten Anweisungen zu geben, was er tun soll Wird im \$1instructions\$1-Platzhalter der Prompt-Vorlage für die Orchestrierung verwendet. |
Die folgenden Felder sind optional:
****
| Feld | Anwendungsfall |
| --- | --- |
| description | Beschreibt die Aufgaben des Agenten. |
| idleSessionTTLInSeconds | Dauer, nach der der Agent die Sitzung beendet und alle gespeicherten Informationen gelöscht werden. |
| customerEncryptionKeyArn | Der ARN eines KMS-Schlüssels zum Verschlüsseln von Agentenressourcen. |
| tags | Um die [Tags](tagging.md) zu Ihrem Agenten zuzuweisen. |
| promptOverrideConfiguration | Um die bei jedem Schritt der Orchestrierung an das FM gesendeten [Prompts anzupassen](advanced-prompts.md). |
| guardrailConfiguration | Um dem Agenten einen [Integritätsschutz](guardrails.md) hinzuzufügen. Geben Sie die ID oder den ARN des Integritätsschutzes und die zu verwendende Version an. |
| clientToken | Zur Sicherstellung, dass die API-Anfrage nur einmal durchgeführt wird. Weitere Informationen finden Sie unter [Sicherstellen von Idempotenz](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html). |
| cachingState | Um das Prompt-Caching von Eingaben für den Agenten zu aktivieren. Weitere Informationen finden Sie unter [Prompt-Caching für schnellere Modellinferenz](prompt-caching.md). |
| reasoning\$1config | Um Modelldenken zu ermöglichen, sodass das Modell erklärt, wie es zu seinen Schlussfolgerungen gekommen ist. Wird innerhalb eines additionalModelRequestFields Feldes verwendet. Sie müssen die Anzahl der budget\$1tokens angeben, die für Modellanalysen verwendet werden. Dabei handelt es sich um eine Teilmenge der Ausgabetokens. Weitere Informationen finden Sie unter [Verbessern von Modellantworten durch Modellargumentation.](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-reasoning.html) |
Die Antwort gibt das Objekt [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) zurück, das Details zu Ihrem neu erstellten Agenten enthält. Wenn der Agent nicht erstellt werden kann, gibt das Objekt [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) in der Antwort eine Liste mit `failureReasons` und eine Liste mit `recommendedActions` aus, für die Sie eine Fehlerbehebung ausführen müssen.
```
def create_agent(self, agent_name, foundation_model, role_arn, instruction):
"""
Creates an agent that orchestrates interactions between foundation models,
data sources, software applications, user conversations, and APIs to carry
out tasks to help customers.
:param agent_name: A name for the agent.
:param foundation_model: The foundation model to be used for orchestration by the agent.
:param role_arn: The ARN of the IAM role with permissions needed by the agent.
:param instruction: Instructions that tell the agent what it should do and how it should
interact with users.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.create_agent(
agentName=agent_name,
foundationModel=foundation_model,
agentResourceRoleArn=role_arn,
instruction=instruction,
)
except ClientError as e:
logger.error(f"Error: Couldn't create agent. Here's why: {e}")
raise
else:
return response["agent"]
```
Weitere Informationen finden Sie unter [Hallo Agenten für Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------