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.
# Konfigurieren eines Inline-Agenten zur Laufzeit
Sie können einen Inline-Amazon Bedrock-Agenten mithilfe [InvokeInlineAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html)der API dynamisch zur Laufzeit konfigurieren und aufrufen. Die Verwendung eines Inline-Agenten bietet Ihnen die Flexibilität, Ihre Agentenfunktionen wie Basismodelle, Anweisungen, Aktionsgruppen, Integritätsschutz und Wissensdatenbanken anzugeben, während Sie Ihren Agenten aufrufen. Sie müssen die Funktionen Ihres Agenten nicht vorab definieren, bevor Sie ihn verwenden können.
Im Folgenden finden Sie einige Anwendungsfälle, in denen die Verwendung von Inline-Agenten hilfreich sein kann, da sie Ihnen die Flexibilität bieten, Ihren Agenten zum Zeitpunkt des Aufrufs zu konfigurieren.
+ Führen Sie schnelle Experimente durch, indem Sie verschiedene Agentenfunktionen mit unterschiedlichen Konfigurationen testen und Tools, die Ihrem Agenten zur Verfügung stehen, dynamisch aktualisieren, ohne separate Agenten erstellen zu müssen.
+ Rufen Sie dynamisch einen Agenten auf, um bestimmte Aufgaben auszuführen, ohne neue Agentenversionen zu erstellen oder den Agenten vorzubereiten.
+ Führen Sie einfache Abfragen aus oder verwenden Sie den Codeinterpreter für einfache Aufgaben, indem Sie den Agenten zur Laufzeit erstellen und aufrufen.
+ Erstellen Sie mehrere Agenten in einer Einrichtung für die [Zusammenarbeit mehrerer Agenten](agents-multi-agent-collaboration.md), um gemeinsam an einer Aufgabe oder Konversation zu arbeiten.
Um die Zusammenarbeit mit mehreren Agenten zu nutzen, können Sie Ihre Agenten mithilfe von Inline-Agenten in den folgenden Kombinationen erstellen. APIs
**Agententypen**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/agents-create-inline.html)
**Unterstützte Modelle und Regionen**
Sie können jedes von Agenten für Amazon Bedrock unterstützte Basismodell verwenden, um Ihren Inline-Agenten zu konfigurieren, und Sie können Ihren Inline-Agenten in allen Regionen aufrufen, in denen Agenten für Amazon Bedrock unterstützt werden. Weitere Informationen zu allen in Amazon Bedrock unterstützten Modellen sowie die Regionen, in denen sie unterstützt werden, finden Sie unter:
+ [Unterstützte Regionen für Agenten für Amazon Bedrock](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-supported.html)
+ [Modellunterstützung nach Feature](https://docs.aws.amazon.com//bedrock/latest/userguide/models-features.html)
Mit Inline-Agenten können Sie zwischen Modellen wechseln. Wir empfehlen Ihnen, zwischen den Modellen zu wechseln, die zur selben Familie gehören. Der Wechsel zwischen Modellen, die zu unterschiedlichen Familien gehören, kann zu inkonsistentem Verhalten und zu Fehlern führen.
Die Konfiguration und der Aufruf eines Inline-Agenten werden derzeit in der Amazon-Bedrock-Konsole nicht unterstützt.
## Richtlinien für die Verwendung erweiterter Prompt-Vorlagen für Inline-Agenten
+ **Standardvorlagen für Prompts** – Standardmäßig verwendet Amazon Bedrock die Standardvorlage für Basisaufforderungen für Ihren Inline-Agenten, und die Prompts können jederzeit im Hintergrund geändert werden. Dies kann dazu führen, dass die Antworten inkonsistent sind. Wenn Sie konsistente Antworten auf Ihre Abfragen wünschen, passen Sie das Verhalten Ihres Inline-Agenten an, indem Sie die Logik in der standardmäßigen Basisvorlage für Prompts mit Ihren eigenen Konfigurationen außer Kraft setzen. Weitere Informationen finden Sie unter [Erweiterte Prompt-Vorlagen](https://docs.aws.amazon.com//bedrock/latest/userguide/advanced-prompts-templates.html).
+ **Verschlüsselung** – Verwenden Sie `customer managed key `, um die Sitzungsdetails im Ruhe-/Speicherbereich zu verschlüsseln. Wenn eine Sitzung mit einem kundenseitig verwalteten Schlüssel (CMK) gestartet wird, ist dieser für alle zukünftigen Anforderungen für dieselbe Sitzung erforderlich. Die Verwendung eines anderen CMK für dieselben Sitzungen führt zu einer Ausnahme.
+ **Freigabe von Sitzungen** – Künftig finden alle Sitzungen auf Konto- statt auf Rollenebene statt. Sie können Sitzungen auf Agentenebene isolieren, indem Sie einen eindeutigen Wert für `agentName` angeben.
+ **Status der Inline-Sitzungen** – Die Attribute innerhalb von `InlineSessionState` bleiben während der gesamten Sitzung bestehen. Verwenden Sie die Attribute, um zusätzlichen Kontext für Ihr Modell bereitzustellen und für [Few Shot Prompting](https://docs.aws.amazon.com//bedrock/latest/userguide/what-is-a-prompt.html#few-shot-prompting-vs-zero-shot-prompting) zu erstellen.
# Voraussetzungen
**Anmerkung**
Bei der Konfiguration und beim Aufrufen eines Inline-Agent-Features handelt es sich um eine Vorschauversion für Amazon Bedrock, die Änderungen unterliegt.
Erfüllen Sie die folgenden Voraussetzungen, bevor Sie Ihren Inline-Agenten aufrufen:
1. Entscheiden Sie sich für ein Basismodell, das Sie für die Konfiguration Ihres Inline-Agenten verwenden möchten, für die Region, in der Sie den Agenten aufrufen möchten, und für eine Anweisung, die dem Inline-Agenten mitteilt, was er tun soll.
1. Erstellen oder bereiten Sie eine oder mehrere der folgenden Agenteneigenschaften in Amazon Bedrock vor, die Sie für Ihren Inline-Agenten verwenden möchten.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/bedrock/latest/userguide/inline-agent-prereq.html)
1. Erstellen Sie eine AWS Identity and Access Management (IAM) -Rolle und fügen Sie der Rolle die in diesem Schritt erwähnte Richtlinie hinzu.
Bevor Sie einen Inline-Agenten aufrufen können, müssen Sie eine IAM-Rolle erstellen, die die erforderlichen Berechtigungen für die Verwendung der `InvokeInlineAgent`-API und den Zugriff auf Ressourcen wie Lambda-Funktionen, Wissensdatenbanken und Basismodelle bereitstellt.
Erstellen Sie eine benutzerdefinierte Servicerolle für Ihren Inline-Agenten, indem Sie die Schritte unter [Erstellen einer Rolle zum Delegieren von Berechtigungen an einen IAM-Benutzer](https://docs.aws.amazon.com//bedrock/latest/userguide/getting-started.html) ausführen. Nachdem Sie die IAM-Rolle erstellt haben, fügen Sie der Rolle folgende Richtlinie an.
**Anmerkung**
Aus Sicherheitsgründen empfiehlt es sich,, und durch Region *\$1\$1region\$1**\$1\$1account-id\$1*, Ihre Konto-ID und *\$1.ids* spezifische Ressourcen-IDs zu ersetzen, nachdem Sie sie erstellt haben.
# So rufen Sie einen Inline-Agenten auf
**Anmerkung**
Bei der Konfiguration und beim Aufrufen eines Inline-Agent-Features handelt es sich um eine Vorschauversion für Amazon Bedrock, die Änderungen unterliegt.
Bevor Sie Ihren Inline-Agenten aufrufen, stellen Sie sicher, dass alle [Voraussetzungen](https://docs.aws.amazon.com//bedrock/latest/userguide/inline-agent-prereq.html) erfüllt sind.
Um einen Inline-Agenten aufzurufen, senden Sie eine [InvokeInlineAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html)API-Anfrage mit einem [Runtime-Endpunkt von Agents for Amazon Bedrock und geben](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt) Sie mindestens die folgenden Felder ein.
****
| Feld | Anwendungsfall |
| --- | --- |
| instruction | Stellen Sie Anweisungen für den Inline-Agenten bereit, was er tun soll und wie er mit Benutzern interagieren soll. |
| foundationModel | Geben Sie ein [Basismodell](https://docs.aws.amazon.com//bedrock/latest/userguide/foundation-models-reference.html) an, das für die Orchestrierung durch den von Ihnen erstellten Inline-Agenten verwendet werden soll. Zum Beispiel anthropic claude, meta Llama3.1 usw. |
| sessionId | Eindeutige Kennung für die Sitzung. Verwenden Sie denselben Wert für alle Anfragen, um dieselbe Konversation fortzusetzen. |
Die folgenden Felder sind optional:
****
| Feld | Anwendungsfall |
| --- | --- |
| actionGroups | Liste von Aktionsgruppen, wobei jede Aktionsgruppe die Aktionen definiert, die der Inline-Agent ausführen kann. |
| knowledgeBases | Assoziationen der Wissensdatenbank mit Inline-Agenten zur Verbesserung der durch das Modell generierten Antwort. |
| guardrailConfiguration | Integritätsschutzkonfigurationen zur Blockierung von Themen, zur Vermeidung von Halluzinationen und zur Implementierung von Schutzmaßnahmen für Ihre Anwendung. |
| agentCollaboration | Definiert, wie der Mitarbeiter-Agent Informationen über mehrere Mitarbeiter-Agenten hinweg handhabt, um eine endgültige Antwort zu koordinieren. Der Mitarbeiter kann auch der Vorgesetzte sein. |
| collaboratorConfigurations | Konfigurationen für den Mitarbeiter-Agenten. |
| collaborators | Liste der Collaborator-Agenten. |
| promptOverrideConfiguration | Konfigurationen für erweiterte Prompts, die zum Überschreiben der Standard-Prompts verwendet werden. |
| enableTrace | Geben Sie an, ob die Ablaufverfolgung aktiviert werden soll oder nicht, um den Argumentationsprozess des Inline-Agenten nachzuverfolgen. |
| Sekunden im Leerlauf TTLIn | Geben Sie die Dauer, nach der der Inline-Agent die Sitzung beenden soll und alle gespeicherten Informationen gelöscht werden. |
| customerEncryptionKeyArn | Geben Sie den ARN eines KMS-Schlüssels zum Verschlüsseln von Agenten-Ressourcen an. |
| endSession | Geben Sie an, ob die Sitzung mit dem Inline-Agenten beendet werden soll oder nicht. |
| inlineSessionState | Parameter, die die verschiedenen Attribute einer Sitzung angeben. |
| inputText | Geben Sie den Prompt an, der an den Agenten gesendet werden soll. |
| 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). |
Das folgende Beispiel für die `InvokeInlineAgent`-API stellt vollständige Inline-Agentenkonfigurationen, einschließlich des Basismodells, Anweisungen, Aktionsgruppen mit Codeinterpreter, Integritätsschutz und Wissensdatenbanken bereit.
```
response = bedrock_agent_runtime.invoke_inline_agent(
// Initialization parameters: cannot be changed for a conversation
sessionId='uniqueSessionId',
customerEncryptionKeyArn: String,
// Input
inputText="Hello, can you help me with a task?",
endSession=False,
enableTrace=True,
// Agent configurations
foundationModel='anthropic.claude-3-7-sonnet-20250219-v1:0',
instruction="You are a helpful assistant...",
actionGroups=[
{
'name': 'CodeInterpreterAction',
'parentActionGroupSignature': 'AMAZON.CodeInterpreter'
},
{
'actionGroupName': 'FetchDetails',
'parentActionGroupSignature': '',
"actionGroupExecutor": { ... },
"apiSchema": { ... },
"description": "string",
"functionSchema": { ... }
}
],
knowledgeBases=[
{
knowledgeBaseId: "string",
description: 'Use this KB to get all the info',
retrievalConfiguration: {
vectorSearchConfiguration: {
filter: { ... },
numberOfResults: number,
overrideSearchType: "string"
}
}
}
],
guardrailConfiguration={
guardrailIdentifier: 'BlockEverything',
gurardrailVersion: '1.0'
},
promptOverrideConfiguration: {...}
// session properties: persisted throughout conversation
inlineSessionState = {
sessionAttributes = { 'key': 'value' },
promptSessionAttributes = {k:v},
returnControlInvocationResults = {...},
invocationId = 'abc',
files = {...},
}
}
```
Sie können Parameter für die Modelargumentation in der Anforderung aufnehmen. Nachfolgend sehen Sie ein Beispiel für eines einzelnen Prompts, mit dem die Modelargumentation in den `additionalModelRequestFields` aktiviert wird.
```
{
"basePromptTemplate": " ... ",
"inferenceConfiguration": {
"stopSequences": [
""
]
},
"parserMode": "DEFAULT",
"promptCreationMode": "DEFAULT",
"promptState": "DISABLED",
"promptType": "ORCHESTRATION",
"additionalModelRequestFields":
"reasoning_config": {
"type": "enabled",
"budget_tokens": 1024
}
}
```