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.
# Bereitstellen und Verwenden eines Amazon-Bedrock-Agenten in Ihrer Anwendung
Bevor Sie einen Agenten verwenden können, müssen Sie ihn bereitstellen, indem Sie einen Alias erstellen. Sie können den Agenten dann in Ihrer Anwendung verwenden, indem Sie den [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)-Vorgang aufrufen. In diesem Abschnitt erfahren Sie, wie Sie einen Alias erstellen und verwalten und wie Sie Ihren Agenten über eine Anwendung aufrufen.
**Topics**
+ [Bereitstellen eines Agenten](deploy-agent.md)
+ [Aufrufen eines Agenten über Ihre Anwendung](agents-invoke-agent.md)
# Bereitstellen eines Agenten
Wenn Sie zum ersten Mal einen Amazon-Bedrock-Agenten erstellen, haben Sie eine Version des Arbeitsentwurfs (`DRAFT`) und einen Testalias (`TSTALIASID`), der auf die Version des Arbeitsentwurfs verweist. Wenn Sie Änderungen an dem Agenten vornehmen, gelten die Änderungen für den Arbeitsentwurf. Sie arbeiten solange an Ihrem Arbeitsentwurf, bis Sie mit dem Verhalten des Agenten zufrieden sind. Dann können Sie den Agenten für die Bereitstellung und die Integration in die Anwendung einrichten, indem Sie *Aliasnamen* für den Agenten erstellen.
**Aliasnamen und Versionen**
Für die Bereitstellung des Agenten müssen Sie einen *Alias* erstellen. Während der Alias-Erstellung generiert Amazon Bedrock automatisch eine Version des Agenten. Der Alias verweist auf diese neu erstellte Version. Alternativ haben Sie die Möglichkeit, den Alias auf eine zuvor erstellte Version des Agenten verweisen zu lassen. Dann konfigurieren Sie die Anwendung so, dass sie API-Aufrufe an diesen Alias tätigt.
Eine *Version* ist ein Snapshot, der die Ressource so beibehält, wie sie zum Zeitpunkt ihrer Erstellung vorhanden war. Sie können den Arbeitsentwurf weiterhin ändern und bei Bedarf neue Aliasnamen (und damit Versionen) des Agenten erstellen. In Amazon Bedrock generieren Sie eine neue Version Ihres Agenten, indem Sie einen Alias erstellen, der standardmäßig auf die neue Version verweist. Amazon Bedrock erstellt Versionen in numerischer Reihenfolge, die mit 1 beginnt.
Versionen sind unveränderlich, da sie als Snapshot des Agenten zum Erstellungszeitpunkt dienen. Um einen Agenten in der Produktion zu aktualisieren, müssen Sie eine neue Version erstellen und die Anwendung so einrichten, dass sie den Alias aufruft, der auf diese Version verweist.
Mithilfe von Aliassen können Sie effizient zwischen verschiedenen Versionen des Agenten wechseln, ohne dass die Anwendung die Version verfolgen muss. Sie können beispielsweise einen Alias so ändern, dass er auf eine frühere Version des Agenten verweist, wenn es Änderungen gibt, die Sie schnell rückgängig machen müssen.
## Unterbrechen eines bereitgestellten Agenten
Möglicherweise müssen Sie die Ausführung eines Agenten vorübergehend unterbrechen, etwa bei Wartungsarbeiten, Updates oder der Behebung von Leistungsproblemen. Zum Unterbrechen eines Agenten verwenden Sie den Alias für den Agenten mit dem Vorgang [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html). Um einen Agenten anzuhalten, setzen Sie das Feld `aliasInvocationState` auf `REJECT_INVOCATIONS`. Wenn Sie die Ausführung des Agenten fortsetzen möchten, setzen Sie `aliasInvocationState` auf ein`ACCEPT_INVOCATIONS`. Sie müssen keine Änderungen an der IAM-Richtlinie vornehmen, um den Agenten zu unterbrechen.
Um zu überprüfen, ob ein Agent derzeit unterbrochen ist, rufen Sie [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) auf und überprüfen Sie das Feld `aliasInvocationState`. Sie können das Feld `aliasInvocationState` auch auf einen Alias in der Antwort von [ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html) überprüfen.
**Topics**
+ [Unterbrechen eines bereitgestellten Agenten](#agent-pause)
+ [Erstellen eines Alias für einen Agenten](deploy-agent-proc.md)
+ [Anzeigen von Informationen zu Agentenversionen in Amazon Bedrock](agents-version-view.md)
+ [Löschen der Version eines Agenten in Amazon Bedrock](agents-version-delete.md)
+ [Anzeigen von Informationen zu Aliasen von Agenten in Amazon Bedrock](agents-alias-view.md)
+ [Bearbeiten eines Alias eines Agenten in Amazon Bedrock](agents-alias-edit.md)
+ [Löschen eines Alias eines Agenten in Amazon Bedrock](agents-alias-delete.md)
# Erstellen eines Alias für einen Agenten
Im folgenden Verfahren wird gezeigt, wie Sie einen Alias und eine Version für einen Agenten erstellen. Nachdem Sie einen Alias erstellt haben, können Sie den Agenten in der Anwendung nutzen, indem Sie eine [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)-Anfrage mit einem [Laufzeit-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt) stellen.
**Erstellen eines Alias**
+ Erstellen Sie einen Alias und eine Version des Agenten. Wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und befolgen Sie dann die Schritte:
------
#### [ Console ]
**So erstellen Sie einen Alias (und optional eine neue Version)**
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 im Abschnitt **Aliase** die Option **Erstellen** aus.
1. Geben Sie unter **Aliasname** einen eindeutigen Namen ein und unter **Beschreibung** wahlweise eine Beschreibung.
1. Wählen Sie unter **Version zuordnen** eine der folgenden Optionen aus:
+ Um eine neue Version zu erstellen, wählen Sie **Neue Version erstellen und sie diesem Alias zuordnen** aus.
+ Um eine vorhandene Version zu verwenden, wählen Sie **Vorhandene Version verwenden, um diesen Alias zuzuordnen** aus. Wählen Sie im Dropdown-Menü die Version aus, der Sie den Alias zuordnen möchten.
1. Wählen Sie unter **Durchsatz auswählen** eine der folgenden Optionen aus:
+ Wählen Sie **On-Demand (ODT**) aus, damit der Agent die Modellinferenz zu den für Ihr Konto festgelegten Tarifen durchführen kann. Weitere Informationen finden Sie unter [Kontingente für Amazon Bedrock](quotas.md).
+ Wählen Sie **Bereitgestellter Durchsatz (PT)** und dann ein bereitgestelltes Modell aus, damit der Agent die Modellinferenz mit einer höheren Rate ausführen kann, indem er bereitgestellten Durchsatz verwendet, den Sie zuvor für das Modell erworben haben. Weitere Informationen finden Sie unter [Erhöhen Sie die Kapazität für den Modellaufruf mit Provisioned Throughput in Amazon Bedrock](prov-throughput.md).
1. Wählen Sie **Alias erstellen** aus.
------
#### [ API ]
Um einen Alias für einen Agenten zu erstellen, senden Sie eine [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.html)-Anfrage mit einem [Build-Timeendpunkt für Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
Die folgenden Felder sind erforderlich:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/deploy-agent-proc.html)
Die folgenden Felder sind optional:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/deploy-agent-proc.html)
```
def create_agent_alias(self, name, agent_id):
"""
Creates an alias of an agent that can be used to deploy the agent.
:param name: The name of the alias.
:param agent_id: The unique identifier of the agent.
:return: Details about the alias that was created.
"""
try:
response = self.client.create_agent_alias(
agentAliasName=name, agentId=agent_id
)
agent_alias = response["agentAlias"]
except ClientError as e:
logger.error(f"Couldn't create agent alias. {e}")
raise
else:
return agent_alias
```
Weitere Informationen finden Sie unter [Hallo Agenten für Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------
# Anzeigen von Informationen zu Agentenversionen in Amazon Bedrock
Nachdem Sie eine Version eines Agenten erstellt haben, können Sie Informationen darüber anzeigen oder sie löschen. Sie können eine neue Version eines Agenten nur erstellen, indem Sie einen neuen Alias erstellen.
Um zu erfahren, wie Sie eine Version eines Agenten löschen, wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und befolgen Sie die angegebenen Schritte:
------
#### [ Console ]
**Zeigen Sie Informationen zu einer Version eines Agenten wie folgt an:**
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 **Agenten** aus. Wählen Sie im Abschnitt **Agenten** einen Agenten aus.
1. Wählen Sie im Abschnitt **Versionen** die Version aus, die Sie sich ansehen möchten.
1. Wählen Sie den Namen der Informationen aus, die Sie anzeigen möchten, um Details zum Modell, zu den Aktionsgruppen oder zu den Wissensdatenbanken anzuzeigen, die der Version des Agenten angefügt sind. Sie können keine Teile einer Version ändern. Um Änderungen am Agenten vorzunehmen, verwenden Sie den Arbeitsentwurf und erstellen Sie eine neue Version.
------
#### [ API ]
Um Informationen über eine Agentenversion zu erhalten, senden Sie eine [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.html)-Anfrage mit einem [Build-Time-Endpunkt für Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Geben Sie die `agentId` und die `agentVersion` an.
Um Informationen über die Versionen eines Agenten aufzulisten, senden Sie eine [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html)-Anfrage mit einem [Build-Time-Endpunkt für Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) und geben Sie die `agentId` an. Sie können die folgenden optionalen Parameter festlegen:
****
| Feld | Kurzbeschreibung |
| --- | --- |
| maxResults | Die maximale Anzahl der Ergebnisse, die in einer Antwort zurückzugeben sind. |
| nextToken | Wenn die Anzahl der Ergebnisse die Anzahl übersteigt, die Sie im Feld maxResults angegeben haben, gibt die Antwort einen nextToken-Wert zurück. Senden Sie den nextToken-Wert in einer weiteren Anforderung, um den nächsten Ergebnisstapel zu sehen. |
------
# Löschen der Version eines Agenten in Amazon Bedrock
Um zu erfahren, wie Sie eine Version eines Agenten löschen, wählen Sie die Registerkarte für Ihre bevorzugte Methode aus und befolgen Sie die angegebenen Schritte:
------
#### [ Console ]
**Löschen Sie die Version eines Agenten wie folgt:**
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 **Agenten** aus. Wählen Sie im Abschnitt **Agenten** einen Agenten aus.
1. Zum Auswählen der zu löschenden Version markieren Sie im Abschnitt **Versionen** das Optionsfeld neben der Version, die Sie löschen möchten.
1. Wählen Sie **Löschen** aus.
1. Es erscheint ein Dialogfenster, das Sie vor den Auswirkungen des Löschvorgangs warnt. Zum Bestätigen, dass Sie die Version löschen möchten, geben Sie **delete** in das Eingabefeld ein und wählen Sie **Löschen** aus.
1. Es wird ein Banner angezeigt, in dem Sie darüber informiert werden, dass die Version gelöscht wird. Wenn der Löschvorgang abgeschlossen ist, wird ein Erfolgsbanner angezeigt.
------
#### [ API ]
Um eine Version eines Agenten zu löschen, senden Sie eine [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.html)-Anfrage mit einem [Build-Time-Endpunkt für Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Der Wert des Parameters `skipResourceInUseCheck` lautet standardmäßig `false` und der Löschvorgang wird gestoppt, wenn die Ressource verwendet wird. Wenn Sie `skipResourceInUseCheck` auf `true` setzen, wird die Ressource gelöscht, auch wenn sie in Verwendung ist.
------
# Anzeigen von Informationen zu Aliasen von Agenten in Amazon Bedrock
Wählen Sie die Registerkarte mit Ihrer bevorzugten Methode aus und führen Sie dann die Schritte aus, um zu erfahren, wie Sie Informationen zu den Aliasen eines Agenten anzeigen:
------
#### [ Console ]
**So zeigen Sie die Details eines Alias an**
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 im Abschnitt **Agenten** einen Agenten aus.
1. Wählen Sie im Abschnitt **Aliase** den anzuzeigenden Alias aus.
1. Sie können den Namen und die Beschreibung des Alias und die dem Alias zugeordneten Tags anzeigen.
------
#### [ API ]
Senden Sie zum Abrufen von Informationen zu einem Agentenalias eine [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html)-Anfrage mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Geben Sie die `agentId` und die `agentAliasId` an.
Senden Sie zum Auflisten von Informationen zu den Aliasen eines Agenten eine [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html)-Anfrage mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) und geben Sie die `agentId` an. Sie können die folgenden optionalen Parameter festlegen:
****
| Feld | Kurzbeschreibung |
| --- | --- |
| maxResults | Die maximale Anzahl der Ergebnisse, die in einer Antwort zurückzugeben sind. |
| nextToken | Wenn die Anzahl der Ergebnisse die Anzahl übersteigt, die Sie im Feld maxResults angegeben haben, gibt die Antwort einen nextToken-Wert zurück. Senden Sie den nextToken-Wert in einer weiteren Anforderung, um den nächsten Ergebnisstapel zu sehen. |
Wenn Sie alle Tags für einen Alias anzeigen möchten, senden Sie eine [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)-Anfrage mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) und geben Sie den Amazon-Ressourcennamen (ARN) des Alias an.
------
# Bearbeiten eines Alias eines Agenten in Amazon Bedrock
Wählen Sie die Registerkarte mit Ihrer bevorzugten Methode aus und führen Sie dann die Schritte aus, um zu erfahren, wie Sie einen Alias eines Agenten bearbeiten:
------
#### [ Console ]
**So bearbeiten Sie einen Alias**
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 im Abschnitt **Agenten** einen Agenten aus.
1. Wählen Sie im Abschnitt **Aliase** das Optionsfeld neben dem Alias aus, den Sie bearbeiten möchten. Wählen Sie dann **Bearbeiten** aus.
1. Bearbeiten Sie bei Bedarf die vorhandenen Felder. Weitere Informationen zu diesen Feldern finden Sie unter [Bereitstellen und Verwenden eines Amazon-Bedrock-Agenten in Ihrer Anwendung](agents-deploy.md).
1. Wählen Sie **Speichern**.
**So fügen Sie einem Alias zugeordnete Tags hinzu oder entfernen sie**
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 im Abschnitt **Agenten** einen Agenten aus.
1. Wählen Sie im Abschnitt **Aliase** den Alias aus, für den Sie Tags verwalten möchten.
1. Wählen Sie im Abschnitt **Tags (Markierungen)** die Option **Manage tags (Tags (Markierungen) verwalten)**.
1. Um einen Tag hinzuzufügen, wählen Sie **Add new tag (Neuen Tag hinzufügen)**. Geben Sie dann einen **Schlüssel** und optional einen **Wert** ein. Klicken Sie zum Entfernen eines Tags auf **Remove (Entfernen)**. Weitere Informationen finden Sie unter [Markieren von Amazon-Bedrock-Ressourcen](tagging.md).
1. Wählen Sie **Absenden** aus, wenn Sie mit dem Bearbeiten der Tags fertig sind.
------
#### [ API ]
Wenn Sie einen Agentenalias bearbeiten möchten, senden Sie eine [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html)-Anfrage mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Da alle Felder überschrieben werden, schließen Sie sowohl Felder ein, die Sie aktualisieren möchten, als auch Felder, die unverändert bleiben sollen.
Wenn Sie Tags zu einem Alias hinzufügen möchten, senden Sie eine [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.html)-Anfrage mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) und geben Sie den Amazon-Ressourcennamen (ARN) des Alias an. Der Anforderungstext enthält ein `tags`-Feld, bei dem es sich um ein Objekt handelt, das ein Schlüssel-Wert-Paar enthält, das Sie für jedes Tag angeben.
Wenn Sie Tags aus einem Alias entfernen möchten, senden Sie eine [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)-Anfrage mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) und geben Sie den Amazon-Ressourcennamen (ARN) des Alias an. Der `tagKeys`-Anfragesparameter ist eine Liste mit den Schlüsseln für die Tags, die Sie entfernen möchten.
------
# Löschen eines Alias eines Agenten in Amazon Bedrock
Wählen Sie die Registerkarte mit Ihrer bevorzugten Methode aus und führen Sie dann die Schritte aus, um zu erfahren, wie Sie einen Alias eines Agenten löschen:
------
#### [ Console ]
**Löschen eines Alias**
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 im Abschnitt **Agenten** einen Agenten aus.
1. Zum Auswählen des zu löschenden Alias markieren Sie im Abschnitt **Aliase** das Optionsfeld neben dem Alias, den Sie löschen möchten.
1. Wählen Sie **Löschen** aus.
1. Es erscheint ein Dialogfenster, das Sie vor den Auswirkungen des Löschvorgangs warnt. Zum Bestätigen, dass Sie den Alias löschen möchten, geben Sie **delete** in das Eingabefeld ein und wählen Sie **Löschen** aus.
1. Es wird ein Banner angezeigt, in dem Sie darüber informiert werden, dass der Alias gelöscht wird. Wenn der Löschvorgang abgeschlossen ist, wird ein Erfolgsbanner angezeigt.
------
#### [ API ]
Wenn Sie einen Alias eines Agenten löschen möchten, senden Sie eine [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.html)-Anfrage mit einem [Build-Time-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Der Wert des Parameters `skipResourceInUseCheck` ist standardmäßig `false` und der Löschvorgang wird gestoppt, wenn die Ressource verwendet wird. Wenn Sie `skipResourceInUseCheck` auf `true` setzen, wird die Ressource gelöscht, auch wenn sie in Verwendung ist.
```
def delete_agent_alias(self, agent_id, agent_alias_id):
"""
Deletes an alias of an Amazon Bedrock agent.
:param agent_id: The unique identifier of the agent that the alias belongs to.
:param agent_alias_id: The unique identifier of the alias to delete.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.delete_agent_alias(
agentId=agent_id, agentAliasId=agent_alias_id
)
except ClientError as e:
logger.error(f"Couldn't delete agent alias. {e}")
raise
else:
return response
```
Weitere Informationen finden Sie unter [Hallo Agenten für Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------
# Aufrufen eines Agenten über Ihre Anwendung
Verwenden Sie Ihren Agenten in der Anwendung, indem Sie eine [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)-Anfrage mit einem [Runtime-Endpunkt von Agenten für Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt) senden.
Standardmäßig enthält die Antwort von `InvokeAgent` einen Abschnitt mit der vollständigen Antwort des Agenten, was einige Zeit in Anspruch nehmen kann. Alternativ können Sie `InvokeAgent` so konfigurieren, dass die Antwort in mehreren kleineren Abschnitten gestreamt wird. Dadurch wird die Latenz der ersten Antwort des Agenten verringert.
**Streaming-Antworten**
Sie können optional das Streaming der Antwort aktivieren, indem Sie `streamFinalResponse` in Streaming-Konfigurationen ([StreamingConfigurations](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StreamingConfigurations.html)) auf `true` festlegen. Der Antwort-Stream enthält mehrere Ereignisse mit Abschnitten für jeden Teil der Antwort in der richtigen Reihenfolge.
Stellen Sie zum Streamen von Antworten sicher, dass die Ausführungsrolle des Agenten die Berechtigung `bedrock:InvokeModelWithResponseStream` für das konfigurierte Agentenmodell umfasst. Weitere Informationen finden Sie unter [Identitätsbasierte Berechtigungen für die Agenten-Servicerolle](agents-permissions.md#agents-permissions-identity).
Wenn Ihr Agent mit einem Integritätsschutz konfiguriert ist, können Sie auch das `applyGuardrailInterval` in den `StreamingConfigurations` angeben, um zu steuern, wie oft ein `ApplyGuardrail`-Anruf bei ausgehenden Antwortzeichen getätigt wird (z. B. alle 50 Zeichen) erfolgt.
Standardmäßig ist das Intervall für den Integritätsschutz auf 50 Zeichen festgelegt. Wenn ein größeres Intervall angegeben wird, wird die Antwort in größeren Abschnitten mit weniger `ApplyGuardrail`-Aufrufen generiert. Die folgenden Beispiele zeigen die Antwort, die für die Eingabezeichenfolge *Hallo, ich bin ein Agent* generiert wurde.
**Beispiel für eine Antwort in Blöcken: Das Intervall ist auf 3 Zeichen festgelegt**
```
'Hel', 'lo, ', 'I am', ' an', ' Age', 'nt'
```
Jeder Block weist mindestens 3 Zeichen auf, mit Ausnahme des letzten Blocks.
**Beispiel für eine Antwort in Blöcken: Das Intervall ist auf mindestens 20 Zeichen festgelegt**
```
'Hello, I am an Agent'
```
## Aufrufen eines Agenten
Das folgende Python-Beispiel zeigt, wie der Vorgang [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) aufgerufen wird und die Ausgabe des Agenten sowie alle durch den Aufruf generierten [Trace](trace-events.md)-Informationen angezeigt werden.
**Aufrufen eines Agenten**
1. Erstellen Sie einen Agenten, indem Sie die Anleitungen unter [Manuelles Erstellen und Konfigurieren von Agenten](agents-create.md) befolgen. Notieren Sie sich die ID für den Agenten. Bei Bedarf können Sie die ID später abrufen. Weitere Informationen finden Sie unter [Anzeigen von Informationen über einen Agenten](agents-view.md).
1. Erstellen Sie einen Alias für den Agenten, indem Sie die Anleitungen unter [Erstellen eines Alias für einen Agenten](deploy-agent-proc.md) befolgen. Notieren Sie sich die ID des Alias. Bei Bedarf können Sie die ID später abrufen. Weitere Informationen finden Sie unter [Anzeigen von Informationen zu Aliasen von Agenten in Amazon Bedrock](agents-alias-view.md).
1. Führen Sie folgenden Code aus. Aktualisieren Sie den Wert von `agent_id` auf die ID Ihres Agenten und den Wert `alias_id` auf die Alias-ID des Agenten. Wenn Sie die Antwort des Agenten streamen möchten, ändern Sie den Wert von `streamFinalResponse` in `True`. Sie können das Intervall des Integritätsschutzes auch ändern, indem Sie den Wert von `applyGuardrailInterval` ändern.
```
import boto3
import logging
from botocore.exceptions import ClientError
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
def invoke_agent(client, agent_id, alias_id, prompt, session_id):
response = client.invoke_agent(
agentId=agent_id,
agentAliasId=alias_id,
enableTrace=True,
sessionId = session_id,
inputText=prompt,
streamingConfigurations = {
"applyGuardrailInterval" : 20,
"streamFinalResponse" : False
}
)
completion = ""
for event in response.get("completion"):
#Collect agent output.
if 'chunk' in event:
chunk = event["chunk"]
completion += chunk["bytes"].decode()
# Log trace output.
if 'trace' in event:
trace_event = event.get("trace")
trace = trace_event['trace']
for key, value in trace.items():
logging.info("%s: %s",key,value)
print(f"Agent response: {completion}")
if __name__ == "__main__":
client=boto3.client(
service_name="bedrock-agent-runtime"
)
agent_id = "AGENT_ID"
alias_id = "ALIAS_ID"
session_id = "MY_SESSION_ID"
prompt = "Prompt to send to agent"
try:
invoke_agent(client, agent_id, alias_id, prompt, session_id)
except ClientError as e:
print(f"Client error: {str(e)}")
logger.error("Client error: %s", {str(e)})
```