View a markdown version of this page

Datensätze erstellen und verwalten - Amazon Grundgestein AgentCore
Erstellen Sie einen RegistrierungseintragListet Registrierungsdatensätze aufDatensatzdetails anzeigenAktualisieren Sie einen RegistrierungseintragReichen Sie einen Datensatz zur Genehmigung einLöschen Sie einen RegistrierungseintragSchemavalidierung

Datensätze erstellen und verwalten

Bevorstehende Namespace-Migration

AWS Agent Registry befindet sich derzeit in der öffentlichen Vorschauversion unter dem Bedrock-Agentcore-Namespace. Ab dem 6. August 2026 wird der Dienst in den Agent-Registry-Namespace verschoben. Wenn Sie AWS Agent Registry verwenden, müssen Sie Ihre Endpoints, IAM-Richtlinien, SDK-Clients, CLI-Skripts und Registrierungsdaten aktualisieren. Weitere Informationen zur Migration aus der öffentlichen Vorschauversion finden Sie unter Umfassender Anleitung zur Registrierungsmigration.

Erstellen Sie einen Registrierungseintrag

Konsole

  1. Öffnen Sie die Seite mit den Registrierungsdetails.

  2. Wählen Sie im Abschnitt Registrierungseinträge die Option Datensatz erstellen aus.

  3. Wählen Sie einen Quelltyp:

    1. Vom Endpunkt aus synchronisieren — Geben Sie eine Endpunkt-URL und optionale Anmeldeinformationen an, um den Endpunkt aufzurufen, und die Registry ruft Metadaten von der Quelle ab. Nur für MCP- und Agent-Datensatztypen verfügbar. Um den Datensatz zu aktualisieren, nachdem sich die Quelle geändert hat, müssen Sie die Synchronisation manuell auslösen. Einzelheiten finden Sie unter Synchronisieren von Datensätzen aus externen Quellen.

    2. Manuell — Konfigurieren Sie die Datensatzdetails und die Protokollkonfiguration manuell.

Synchronisieren Sie vom Endpunkt aus

  1. Wählen Sie unter Datensatzdetails den Datensatztyp aus: MCP oder Agent.

    Anmerkung

    Die Synchronisation wird nur für MCP- und Agent-Datensatztypen unterstützt. Die Datensatztypen Agent Skills und Custom unterstützen keine Synchronisation. Verwenden Sie stattdessen den Quelltyp Manuell.

  2. Geben Sie die Endpunkt-URL ein. Muss eine gültige HTTPS-URL sein.

  3. Wählen Sie unter Anmeldeinformationstyp aus, wie die Registrierung beim Endpunkt autorisiert:

    1. IAM — Geben Sie einen Rollen-ARN für die Sigv4-Signatur und einen Dienstnamen (z. B., bedrock-agentcoreexecute-api,lambda) an. Geben Sie optional eine Region für das Signieren an.

    2. OAuth — Wählen Sie einen Credential Provider-ARN aus Identity aus, oder geben Sie ihn ein. AgentCore Konfigurieren Sie optional Bereiche und benutzerdefinierte Parameter unter Zusätzliche Konfiguration.

    3. Keine — Keine Autorisierung (für öffentliche Endpunkte).

  4. Wählen Sie Datensatz erstellen.

    Der Datensatz wurde im Status CREATING erstellt. Die Registrierung stellt eine Verbindung zum Endpunkt her, extrahiert Metadaten und füllt die Deskriptoren des Datensatzes aus. Nach Abschluss der Synchronisation wechselt der Datensatz zu DRAFT. Wenn die Synchronisation fehlschlägt, wechselt der Datensatz in den Status CREATE_FAILED, wobei die Fehlerdetails im Feld Statusgrund auf der Datensatzdetailseite verfügbar sind. Informationen zur Problembehandlung finden Sie unter Fehler bei der Datensatzsynchronisierung. Um den Datensatz zu aktualisieren, wenn sich die Quelle ändert, verwenden Sie die Schaltfläche Synchronisieren auf der Datensatzdetailseite oder wählen Sie während der Bearbeitung einen Endpunkt Re-sync aus.

AWS CLI- und SDK-Beispiele für das Erstellen von Datensätzen mit Synchronisation finden Sie unter Synchronisieren von Datensätzen aus externen Quellen.

Manuell

  1. Geben Sie unter Datensatzdetails Folgendes ein:

    1. Name — Muss mit einem Buchstaben oder einer Ziffer beginnen. Gültige Zeichen sind a-z A-Z, 0-9, _ (Unterstrich), - (Bindestrich),. (Punkt) und/(Schrägstrich). Der Name kann bis zu 255 Zeichen lang sein.

    2. Beschreibung (optional) — 1 bis 4.096 Zeichen.

    3. Datensatzversion — Geben Sie die Version dieses Datensatzes an (z. B. 1.0.0, v2.1).

  2. Wählen Sie unter Datensatztyp eine der folgenden Optionen aus: MCP, Agent, Agent Skills oder Benutzerdefiniert.

  3. Ein typspezifischer Editor wird angezeigt. Geben Sie Ihre Protokollkonfiguration im JSON-Format ein.

    1. Aktivieren Sie für die Typen Agent und MCP die Option Offizielles Schema anzeigen, um das Referenzschema zur Orientierung nebeneinander anzuzeigen.

    2. Die Konsole validiert Ihr JSON anhand des offiziellen Schemas und zeigt Inline-Fehler (z. B. „Fehlende Eigenschaft 'Name'“) mit der Schaltfläche Diagnose mit Amazon Q an.

  4. Wählen Sie eine der folgenden Optionen:

    1. Als Entwurf erstellen — Erstellt den Datensatz im Status Entwurf.

    2. Erstellen und zur Genehmigung einreichen — Erstellt den Datensatz und leitet ihn sofort zur Genehmigung weiter.

AWS CLI

aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "MyMCPServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

AWS SDK

import boto3
import json

client = boto3.client('bedrock-agentcore-control')

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='MyMCPServer',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'inlineContent': server_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Listet Registrierungsdatensätze auf

Konsole

  1. Öffnen Sie die Seite mit den Registrierungsdetails.

  2. Im Abschnitt „Registrierungseinträge“ wird Folgendes angezeigt:

    1. Zähler in der Statusübersicht — Insgesamt eingereicht, Genehmigung ausstehend, Genehmigt, Veraltet, Abgelehnt.

    2. Datensatztabelle mit Spalten: Name, Beschreibung, Status, Datensatztyp, Datensatz-ARN, Letzte Aktualisierung.

  3. Verwenden Sie die Leiste „Datensätze durchsuchen“, um nach Namen zu filtern.

  4. Verwenden Sie die Dropdownliste Status aktualisieren, um mehrere Statusänderungen an ausgewählten Datensätzen vorzunehmen.

AWS CLI

aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['name']} - {record['status']} - {record['descriptorType']}")

Datensatzdetails anzeigen

Konsole

  1. Wählen Sie auf der Seite mit den Registrierungsdetails einen Datensatznamen aus der Datensatztabelle aus.

  2. Auf der Seite mit den Datensatzdetails wird Folgendes angezeigt:

    1. Abschnitt mit Datensatzdetails — Name, Beschreibung, Datensatz-ARN, Status (wird als Symbol neben dem Datensatznamen angezeigt), Version, Datum der letzten Aktualisierung, Datensatztyp, Datensatz-ID, Erstellungsdatum.

    2. Abschnitt zur Synchronisationskonfiguration (falls konfiguriert) — Synchronisationstyp, Quell-URL und Angaben zum Anmeldeinformationsanbieter (IAM-Rollen-ARN, Dienst-, Regions- oder OAuth-Provider-ARN, Grant-Typ, Bereiche, benutzerdefinierte Parameter).

    3. Abschnitt zur Protokollkonfiguration — Der Deskriptorinhalt, der als formatiertes JSON angezeigt wird (z. B. „Agentenkarte“ für A2A-Datensätze, „Server“ und „Tools“ für MCP-Datensätze).

  3. Verfügbare Aktionen:

    1. Schaltfläche „Synchronisieren“ (nur MCP- und Agent-Datensätze) — Löst eine neue Synchronisation vom konfigurierten Endpunkt aus. Öffnet ein Bestätigungsdialogfeld, bevor Sie fortfahren. Der Datensatz wechselt während der Synchronisation in den Status UPDATE.

    2. Dropdownmenü „Status aktualisieren“ — Zur Genehmigung einreichen, Genehmigen, Ablehnen oder Verwerfen.

    3. Three-dot Menü () — Bearbeiten oder Löschen.

AWS CLI

aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name: {response['name']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Descriptor Type: {response['descriptorType']}")
print(f"Version: {response['recordVersion']}")

Aktualisieren Sie einen Registrierungseintrag

Konsole

  1. Wählen Sie auf der Seite mit den Datensatzdetails das Dreipunktmenü () und dann Bearbeiten aus.

  2. Aktualisieren Sie auf der Seite „Datensatz bearbeiten“ eine der folgenden Optionen:

    1. Name, Beschreibung und Datensatzversion unter Datensatzdetails.

    2. Datensatztyp — Ändern Sie bei Bedarf den Protokolltyp.

  3. (Nur MCP- und Agent-Datensätze) Konfigurieren Sie unter Vom Endpunkt aus synchronisieren optional die Synchronisation:

    Sie können Datensätze mithilfe der Synchronisation aktualisieren, unabhängig davon, ob sie ursprünglich mit der Synchronisation erstellt wurden. Wenn die Synchronisation während einer Aktualisierung ausgelöst wird, wechselt der Datensatz in den Status AKTUALISIERUNG. Wenn der Vorgang erfolgreich ist, wird eine neue Datensatzversion im Status ENTWURF erstellt. Wenn dies fehlschlägt, wechselt der Datensatz in den Status UPDATE_FAILED mit Fehlerdetails im Feld Statusgrund. Die synchronisierten Daten überschreiben den Namen, die Beschreibung, die Version, die Tooldefinitionen und die Serverdefinitionen des Datensatzes mit den in der Quelle gefundenen Werten, ändern jedoch keine Felder, die die Quelle nicht bereitstellt. Ein Administrator oder Kurator muss den neuen Entwurf überprüfen und genehmigen, damit er in der Suche sichtbar wird. Bis dahin kann die vorherige genehmigte Version (falls vorhanden) weiterhin durchsucht werden. Weitere Informationen zum Verhalten von Doppelrevisionen finden Sie unter Lebenszyklus von Datensätzen.

    1. Geben Sie eine Endpunkt-URL ein, um die Synchronisation zu aktivieren. Felder für den Anmeldeinformationstyp werden angezeigt, wenn ein Endpunkt angegeben wird. Wenn für den Datensatz bereits die Synchronisation konfiguriert ist, sind die Felder für den Endpunkt und den Anmeldeinformationsanbieter bereits mit der vorhandenen Konfiguration gefüllt.

    2. Wählen Sie einen Anmeldeinformationstyp (IAM, OAuth oder None) und füllen Sie die erforderlichen Felder aus. Wenn der Datensatz zuvor mit einem Anmeldeinformationsanbieter konfiguriert wurde, sind die vorhandenen Werte vorab ausgefüllt.

    3. Wählen Sie einen Endpunkt Re-sync aus, um beim Speichern eine neue Synchronisation auszulösen. Der Datensatz wechselt während der Synchronisation in den Status UPDATE.

    4. Um die Synchronisation zu entfernen, klicken Sie auf die Schaltfläche Löschen neben dem Endpunktfeld. Dadurch werden der Endpunkt und alle Anmeldeinformationsfelder zurückgesetzt.

  4. Aktualisieren Sie unter Datensatzkonfiguration die Definitionen des Datensatzes im JSON-Editor.

    1. Sie können sowohl den Endpunkt für die Synchronisation konfigurieren als auch die Definitionen des Datensatzes manuell bearbeiten. Wenn die Synchronisation ausgelöst wird, ruft die Registrierung die neuesten Metadaten vom Endpunkt ab und aktualisiert den Namen, die Beschreibung, die Version, die Tooldefinitionen und die Serverdefinitionen des Datensatzes mit den Werten aus der Quelle, wobei sie Vorrang vor manuellen Änderungen an diesen Feldern hat. Felder, die die Quelle nicht bereitstellt, werden nicht geändert.

  5. Die Konsole validiert Ihr JSON anhand des offiziellen Schemas und zeigt Inline-Fehler mit der Schaltfläche Diagnose mit Amazon Q an.

  6. Wählen Sie eine der folgenden Optionen:

    1. Änderungen speichern — Speichert den Datensatz als Entwurf.

    2. Speichern und zur Genehmigung einreichen — Speichert und übermittelt in einem Schritt.

Ein Erfolgsbanner bestätigt: „[Name] wurde erfolgreich aktualisiert und zur Genehmigung eingereicht.“

AWS CLI

aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")

Reichen Sie einen Datensatz zur Genehmigung ein

Konsole

Von der Datensatz-Detailseite aus -

  1. Wählen Sie das Drop-down-Menü Status aktualisieren

  2. Wählen Sie dann „Zur Genehmigung einreichen“ aus.

    1. Alternativ können Sie bei der Erstellung oder Bearbeitung die Option Erstellen und zur Genehmigung einreichen oder Speichern und zur Genehmigung einreichen verwenden.

Anmerkung

Wenn die Auto-Approval Konfiguration der Registrierung auf TRUE gesetzt ist, wird dieser beim Einreichen eines Datensatzes zur Genehmigung automatisch genehmigt. Andernfalls, wenn die Auto-Approval Konfiguration auf FALSE gesetzt ist, wechselt der Datensatz in den Status „Ausstehende Genehmigung“ und wartet darauf, dass der Kurator ihn entweder genehmigt oder ablehnt. Darüber hinaus wird eine EventBridge Amazon-Benachrichtigung ausgelöst, die darauf hinweist, dass ein neuer Datensatz zur Genehmigung angefordert wurde.

AWS CLI

aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED

Löschen Sie einen Registrierungseintrag

Konsole

  1. Wählen Sie auf der Seite mit den Datensatzdetails das Dreipunktmenü () und dann „Löschen“.

  2. Bestätigen Sie den Löschvorgang, indem Sie „Löschen“ eingeben, wenn Sie dazu aufgefordert werden

Der Löschvorgang ist dauerhaft und kann nicht rückgängig gemacht werden.

AWS CLI

aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")

Schemavalidierung

Wenn Sie einen Datensatz erstellen oder bearbeiten, validieren die Konsole und die API Ihre Protokollkonfiguration anhand des offiziellen Schemas für den ausgewählten Datensatztyp. Weitere Informationen zu Validierungen finden Sie unter Unterstützte Datensatztypen.