Commencez avec AWS Registre des agents

Dans ce guide, vous allez créer votre premier registre, ajouter un enregistrement, l'approuver et le rechercher.

Conditions préalables

Suivez les étapes de la section Conditions préalables.

Étape 1 : créer un registre

Créez un registre avec autorisation IAM et approbation manuelle.

Console

Pour créer un registre avec une authentification basée sur IAM

Pour créer un registre avec une authentification basée sur JWT, l'autorisation du fournisseur d'identité utilise des jetons Web JSON (JWT) pour contrôler l'accès à l'API de recherche du registre. Vous pouvez utiliser Amazon Cognito pour configurer rapidement l'autorisation ou utiliser votre propre fournisseur d'identité pour activer OAuth 2.0.

Après avoir créé le registre, la console accède à la page des détails du registre. Le statut du registre est initialement en cours de création. AWS Le registre des agents attribue un ARN au registre, que vous pouvez trouver dans la section Détails du registre. Le statut du registre passe à Prêt une fois le provisionnement terminé. Vous pouvez ajouter des enregistrements au registre lorsque son statut est Prêt.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

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

Le statut du registre commence par CREATING et passe à READY une fois le provisionnement terminé.

AWS Kit 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'])

Étape 2 : Ajouter un enregistrement de registre

Créez un enregistrement pour un serveur MCP dans votre registre.

Console

Un enregistrement de registre représente un agent, un outil, une compétence ou une ressource personnalisée.

Une fois que vous avez choisi Create record, AWS Agent Registry commence à approvisionner l'enregistrement. Le statut de l'enregistrement est initialement en cours de création. Lorsque le provisionnement est terminé, le statut passe à Brouillon. Pour que le document soit accessible à d'autres personnes, soumettez-le pour approbation. Pour plus d'informations, voir Étape 3 : Soumettre l'enregistrement pour approbation.

AWS INTERFACE DE LIGNE DE COMMANDE (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

L'enregistrement est créé dans le statut CREATING et passe à DRAFT une fois le traitement terminé. Pour d'autres exemples de AWS CLI permettant de créer des enregistrements d'autres types, reportez-vous à la section Créer et gérer des enregistrements.

AWS Kit 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

Étape 3 : Soumettre l'enregistrement pour approbation

Console

La soumission d'un enregistrement pour approbation lance le processus de révision qui rend l'enregistrement disponible pour découverte. Vous pouvez soumettre un enregistrement à partir de la table des enregistrements du registre ou de la page des détails de l'enregistrement.

Pour soumettre un enregistrement pour approbation à partir de la table des enregistrements du registre

Pour soumettre un enregistrement pour approbation depuis la page des détails de l'enregistrement

Une fois que vous avez soumis un enregistrement pour approbation, le statut de l'enregistrement change en fonction du paramètre d'approbation du registre :

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

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

L'enregistrement est transféré vers PENDING_APPROVAL (ou directement vers APPROVED si l'approbation automatique est activée).

AWS Kit 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']}")

Étape 4 : Approuver l'enregistrement

Console

Pour approuver un enregistrement depuis la table des enregistrements du registre

Pour approuver un enregistrement depuis la page des détails de l'enregistrement

AWS INTERFACE DE LIGNE DE COMMANDE (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 Kit 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']}")

Étape 5 : Rechercher dans le registre

Console

Vous pouvez rechercher des enregistrements approuvés dans un registre à l'aide d'une recherche sémantique ou par mot-clé pour trouver des agents, des serveurs MCP, des compétences et d'autres ressources. Vous pouvez filtrer les résultats par nom, protocole ou version pour affiner votre recherche.

Pour rechercher des enregistrements de registre

La recherche renvoie uniquement les enregistrements ayant le statut Approuvé. Les enregistrements dans d'autres états, tels que brouillon, en attente d'approbation, rejeté ou obsolète, n'apparaissent pas dans les résultats de recherche.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

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

Votre enregistrement approuvé doit apparaître dans les résultats de recherche.

AWS Kit 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']}")

Ce que vous avez construit

Étapes suivantes