Fangen Sie an mit AWS Agenten-Registrierung

In diesem Handbuch erstellen Sie Ihre erste Registrierung, fügen einen Datensatz hinzu, genehmigen ihn und suchen danach.

Voraussetzungen

Führen Sie die Schritte unter Voraussetzungen aus.

Schritt 1: Erstellen Sie eine Registrierung

Erstellen Sie eine Registrierung mit IAM-Autorisierung und manueller Genehmigung.

Konsole

Um eine Registrierung mit IAM-basierter Authentifizierung zu erstellen

Um eine Registrierung mit JWT-basierter Authentifizierung zu erstellen, verwendet der Identitätsanbieter JSON-Web-Tokens (JWT), um den Zugriff auf die Such-API der Registrierung zu steuern. Sie können Amazon Cognito verwenden, um die Autorisierung schnell einzurichten, oder Ihren eigenen Identitätsanbieter verwenden, um OAuth 2.0 zu aktivieren.

Nach dem Erstellen der Registrierung wechselt die Konsole zur Seite mit den Registrierungsdetails. Der Registrierungsstatus lautet anfänglich Creating. AWS Agent Registry weist der Registrierung einen ARN zu, den Sie im Abschnitt Registrierungsdetails finden. Der Registrierungsstatus ändert sich nach Abschluss der Bereitstellung in Bereit. Sie können der Registrierung Datensätze hinzufügen, wenn der Status Bereit lautet.

AWS CLI

aws bedrock-agentcore-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1

Der Registrierungsstatus beginnt mit CREATING und wechselt zu READY, wenn die Bereitstellung abgeschlossen ist.

AWS SDK

import boto3

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

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])

Schritt 2: Fügen Sie einen Registrierungseintrag hinzu

Erstellen Sie einen Datensatz für einen MCP-Server in Ihrer Registrierung.

Konsole

Ein Registrierungseintrag steht für einen Agenten, ein Tool, eine Fähigkeit oder eine benutzerdefinierte Ressource.

Nachdem Sie „Datensatz erstellen“ ausgewählt haben, beginnt die AWS Agentenregistrierung mit der Bereitstellung des Eintrags. Der Datensatzstatus lautet anfänglich Creating. Wenn die Bereitstellung abgeschlossen ist, ändert sich der Status in Entwurf. Um den Datensatz anderen zur Verfügung zu stellen, reichen Sie ihn zur Genehmigung ein. Weitere Informationen finden Sie unter Schritt 3: Den Datensatz zur Genehmigung einreichen.

AWS CLI

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

Der Datensatz wird im Status CREATING erstellt und wechselt nach Abschluss der Verarbeitung in den Status ENTWURF. Weitere AWS CLI-Beispiele zum Erstellen von Datensätzen anderer Typen finden Sie im Abschnitt Datensätze erstellen und verwalten.

AWS SDK

import boto3
import json

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

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'schemaVersion': '2025-12-11',
                'inlineContent': server_content
            },
            'tools': {
                'protocolVersion': '2024-11-05',
                'inlineContent': tools_content
            }
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Schritt 3: Reichen Sie den Datensatz zur Genehmigung ein

Konsole

Mit dem Einreichen eines Datensatzes zur Genehmigung wird der Überprüfungsprozess gestartet, der den Datensatz zur Verfügung stellt. Sie können einen Datensatz aus der Tabelle mit den Registrierungseinträgen oder von der Seite mit den Datensatzdetails einreichen.

Um einen Datensatz aus der Tabelle mit den Registrierungseinträgen zur Genehmigung einzureichen

Um einen Datensatz von der Datensatzdetailseite aus zur Genehmigung einzureichen

Nachdem Sie einen Datensatz zur Genehmigung eingereicht haben, ändert sich der Datensatzstatus je nach den Genehmigungseinstellungen der Registrierung:

AWS CLI

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

Der Datensatz wird zu PENDING_APPROVAL (oder direkt zu APPROVED, wenn die automatische Genehmigung aktiviert ist) verschoben.

AWS SDK

import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")

Schritt 4: Genehmigen Sie den Datensatz

Konsole

Um einen Datensatz aus der Tabelle mit den Registrierungseinträgen zu genehmigen

Um einen Datensatz von der Datensatzdetailseite aus zu genehmigen

AWS CLI

aws bedrock-agentcore-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1

AWS SDK

import boto3

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

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")

Schritt 5: Durchsuchen Sie die Registrierung

Konsole

Sie können mithilfe der Semantik- oder Stichwortsuche nach genehmigten Einträgen in einer Registrierung suchen, um Agenten, MCP-Server, Fähigkeiten und andere Ressourcen zu finden. Sie können die Ergebnisse nach Name, Protokoll oder Version filtern, um Ihre Suche einzugrenzen.

Um nach Registrierungsdatensätzen zu suchen

Die Suche gibt nur Datensätze mit dem Status Genehmigt zurück. Datensätze mit dem Status „Entwurf“, „Genehmigung ausstehend“, „Abgelehnt“ oder „Veraltet“ werden nicht in den Suchergebnissen angezeigt.

AWS CLI

aws bedrock-agentcore search-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1

Ihr genehmigter Datensatz sollte in den Suchergebnissen erscheinen.

AWS SDK

import boto3

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

response = client.search_registry_records(
    registryIds=['arn:aws:bedrock-agentcore:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['name']} ({record['recordId']})")
    print(f"  Type: {record['descriptorType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['version']}")

Was du gebaut hast

Nächste Schritte