# レコードの作成と管理
<a name="registry-create-manage-records"></a>

**今後の名前空間の移行**  
 AWS エージェントレジストリは現在、bedrock-agentcore 名前空間のパブリックプレビュー中です。2026 年 8 月 6 日以降、サービスはエージェントレジストリ名前空間に移動します。 AWS エージェントレジストリを使用する場合は、エンドポイント、IAM ポリシー、SDK クライアント、CLI スクリプト、レジストリデータを更新する必要があります。パブリックプレビューからの移行の詳細については、[「包括的なレジストリ移行ガイド](registry-faq.md)」を参照してください。

## レジストリレコードを作成する
<a name="registry-create-record"></a>

### コンソール
<a name="registry-create-record-console"></a>

1. レジストリの詳細ページを開きます。

1. **レジストリレコード**セクションで、**レコードの作成**を選択します。

1. ソースタイプを選択します。

   1.  **エンドポイントからの同期** — エンドポイントを呼び出すエンドポイント URL とオプションの認証情報を指定すると、レジストリはソースからメタデータを取得します。MCP レコードタイプとエージェントレコードタイプでのみ使用できます。ソースの変更後にレコードを更新するには、同期を手動でトリガーする必要があります。詳細については、[「外部ソースからのレコードの同期](registry-sync-records.md)」を参照してください。

   1.  **手動** — レコードの詳細とプロトコル設定を手動で設定します。

 **エンドポイントからの同期** 

1. **レコードの詳細**で、レコードタイプとして **MCP** または **エージェント**を選択します。
**注記**  
同期は、MCP レコードタイプとエージェントレコードタイプでのみサポートされています。エージェントスキルとカスタムレコードタイプは同期をサポートしていません。代わりに手動ソースタイプを使用します。

1. **エンドポイント** URL を入力します。有効な HTTPS URL である必要があります。

1. **認証情報タイプ**で、レジストリがエンドポイントで認可する方法を選択します。

   1.  **IAM** — SigV4 署名用の**ロール ARN** と**サービス**名 (、`bedrock-agentcore``execute-api`、 など`lambda`) を指定します。必要に応じて、署名する**リージョン**を指定します。

   1.  **OAuth** — AgentCore Identity から**認証情報プロバイダー** ARN を選択または入力します。必要に応じて、追加設定で**スコープ**と**カスタムパラメータ**を設定します。

   1.  **なし** — 認可なし (パブリックエンドポイントの場合）。

1. **[Create record]** (レコードを作成) を選択します。

   レコードは CREATING ステータスで作成されます。レジストリはエンドポイントに接続し、メタデータを抽出して、レコードの記述子を入力します。同期が完了すると、レコードは DRAFT に移行します。同期が失敗すると、レコードは CREATE\_FAILED ステータスに移行し、レコードの詳細ページの Status Reason フィールドでエラーの詳細が表示されます。トラブルシューティングについては、[「同期エラーを記録する](registry-troubleshooting.md#registry-troubleshooting-sync-errors)」を参照してください。ソースが変更されたときにレコードを更新するには、レコードの詳細ページの**同期**ボタンを使用するか、編集中に**エンドポイントから再同期**を選択します。

同期を使用してレコードを作成する AWS CLI および SDK の例については、[「外部ソースからのレコードの同期](registry-sync-records.md)」を参照してください。

 **手動** 

1. **レコードの詳細** で、次のように入力します。

   1.  **名前** — 文字または数字で始まる必要があります。有効な文字は、a～z、A～Z、0～9、\_ (アンダースコア）、- (ハイフン）、. (ドット）、/ (スラッシュ) です。名前は最大 255 文字です。

   1.  **説明** (オプション) — 1～4,096 文字。

   1.  **レコードバージョン** — このレコードのバージョンを指定します (例: 1.0.0、v2.1)。

1. **レコードタイプ** で、**MCP**、**エージェント**、**エージェントスキル**、または**カスタム**のいずれかを選択します。

1. タイプ固有のエディタが表示されます。プロトコル設定を JSON 形式で入力します。

   1. **エージェント**タイプと **MCP** タイプでは、**公式スキーマを表示**を切り替えて参照スキーマをside-by-side表示し、ガイダンスを表示します。

   1. コンソールは、公式スキーマに対して JSON を検証し、**Amazon Q での診断ボタンを使用してインラインエラー (「プロパティ」名「欠落**」など) を表示します。

1. 次のいずれかを選択します。

   1.  **ドラフトとして作成** — ドラフトステータスのレコードを作成します。

   1.  **作成して承認用に送信する** — レコードを作成し、すぐに承認用に送信します。

### AWS CLI
<a name="registry-create-record-cli"></a>

```
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
<a name="registry-create-record-sdk"></a>

```
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
```

## レジストリレコードを一覧表示する
<a name="registry-list-records"></a>

### コンソール
<a name="registry-list-records-console"></a>

1. レジストリの詳細ページを開きます。

1. **レジストリレコード**セクションには、以下が表示されます。

   1.  **ステータス概要カウンター** — 送信済み、承認保留中、承認済み、廃止済み、拒否済みの合計。

   1.  列を含む**レコードテーブル**: 名前、説明、ステータス、レコードタイプ、レコード ARN、最終更新日。

1. **検索レコード**バーを使用して、名前でフィルタリングします。

1. **ステータスの更新**ドロップダウンを使用して、選択したレコードの一括ステータス変更を実行します。

### AWS CLI
<a name="registry-list-records-cli"></a>

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

### AWS SDK
<a name="registry-list-records-sdk"></a>

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

## レコードの詳細を表示する
<a name="registry-view-record"></a>

### コンソール
<a name="registry-view-record-console"></a>

1. レジストリの詳細ページで、レコードテーブルからレコード名を選択します。

1. レコードの詳細ページに以下が表示されます。

   1.  **レコードの詳細**セクション — 名前、説明、レコード ARN、ステータス (レコード名の横にあるバッジとして表示）、バージョン、最終更新日、レコードタイプ、レコード ID、作成日。

   1.  **同期設定**セクション (設定されている場合) — 同期タイプ、ソース URL、認証情報プロバイダーの詳細 (IAM ロール ARN、サービス、リージョンまたは OAuth プロバイダー ARN、許可タイプ、スコープ、カスタムパラメータ）。

   1.  **プロトコル設定**セクション — フォーマットされた JSON として表示される記述子コンテンツ (A2A レコードの場合は「エージェントカード」、MCP レコードの場合は「サーバー」と「ツール」など）。

1. 利用可能なアクション:

   1.  **同期**ボタン (MCP およびエージェントレコードのみ) — 設定されたエンドポイントから新しい同期をトリガーします。続行する前に確認ダイアログを開きます。レコードは同期中に UPDATING ステータスに移行します。

   1.  **更新ステータス**ドロップダウン — 承認、承認、拒否、または廃止のために送信します。

   1.  **3 ドットメニュー (⋮)** — 編集または削除します。

### AWS CLI
<a name="registry-view-record-cli"></a>

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

### AWS SDK
<a name="registry-view-record-sdk"></a>

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

## レジストリレコードを更新する
<a name="registry-update-record"></a>

### コンソール
<a name="registry-update-record-console"></a>

1. レコードの詳細ページから、3 つのドットメニュー (⋮) を選択し、**編集**を選択します。

1. **レコードの編集**ページで、次のいずれかを更新します。

   1.  **名前** 、**説明** 、**レコードの詳細のレコードバージョン**。

   1.  **レコードタイプ** — 必要に応じてプロトコルタイプを変更します。

1. (MCP およびエージェントレコードのみ) **エンドポイントからの同期**では、オプションで同期を設定します。

   レコードは、元々同期で作成されたかどうかにかかわらず、同期を介して更新できます。更新中に同期がトリガーされると、レコードは UPDATING ステータスに移行します。成功すると、新しいレコードバージョンが DRAFT ステータスで作成されます。失敗すると、レコードはステータス理由フィールドにエラーの詳細を含む UPDATE\_FAILED ステータスに移行します。同期されたデータは、レコードの名前、説明、バージョン、ツール定義、サーバー定義をソースで見つかった値で上書きしますが、ソースが提供していないフィールドは変更しません。管理者またはキュレーターは、新しいドラフトが検索に表示されるように、新しいドラフトを確認して承認する必要があります。それまでは、以前に承認されたリビジョン (存在する場合) は引き続き検索可能です。デュアルリビジョン動作の詳細については、[「ライフサイクルの記録](registry-record-lifecycle.md)」を参照してください。

   1. **エンドポイント** URL を入力して同期を有効にします。認証情報タイプのフィールドは、エンドポイントが指定されている場合に表示されます。レコードに同期がすでに設定されている場合、エンドポイントと認証情報プロバイダーのフィールドには既存の設定が事前に入力されています。

   1. **認証情報タイプ** (IAM、OAuth、またはなし) を選択し、必須フィールドに入力します。レコードが以前に認証情報プロバイダーで設定されている場合、既存の値は事前に入力されています。

   1. 保存時に新しい同期をトリガーするには、**エンドポイントから再**同期を選択します。レコードは同期中に UPDATING ステータスに移行します。

   1. 同期を削除するには、エンドポイントフィールドの横にあるクリアボタンを選択します。これにより、エンドポイントとすべての認証情報フィールドがリセットされます。

1. **レコード設定**で、JSON エディタでレコードの定義を更新します。

   1. 同期のために両方のエンドポイントを設定し、レコードの定義を手動で編集できます。同期がトリガーされると、レジストリはエンドポイントから最新のメタデータを取得し、ソースで見つかった値を使用してレコードの名前、説明、バージョン、ツール定義、サーバー定義を更新し、これらのフィールドの手動編集よりも優先されます。ソースが提供していないフィールドは変更されません。

1. コンソールは JSON を公式スキーマと照合し、**Amazon Q での診断**ボタンを使用してインラインエラーを表示します。

1. 次のいずれかを選択します。

   1.  **変更の保存** — レコードをドラフトとして保存します。

   1.  **保存して承認のために送信** — 1 つのステップで保存して送信します。

成功バナーに、「[Name] が更新され、承認のために正常に送信されました」と表示されます。

### AWS CLI
<a name="registry-update-record-cli"></a>

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

### AWS SDK
<a name="registry-update-record-sdk"></a>

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

## 承認のためにレコードを送信する
<a name="registry-submit-record"></a>

### コンソール
<a name="registry-submit-record-console"></a>

レコードの詳細ページから -

1. **更新ステータス**ドロップダウンを選択する

1. 次に、**承認のために送信**を選択します。

   1. または、**作成して承認用に送信する**か、作成または編集中に**保存して承認用に送信**します。

**注記**  
レジストリの自動承認設定が TRUE に設定されている場合、承認のためにレコードを送信すると、自動的に承認されます。それ以外の場合、自動承認設定が FALSE に設定されている場合、レコードは「承認保留中」ステータスに移行し、Curator が承認または拒否するのを待ちます。さらに、新しいレコードの承認がリクエストされたことを示す Amazon EventBridge 通知がトリガーされます。

### AWS CLI
<a name="registry-submit-record-cli"></a>

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

### AWS SDK
<a name="registry-submit-record-sdk"></a>

```
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
```

## レジストリレコードを削除する
<a name="registry-delete-record"></a>

### コンソール
<a name="registry-delete-record-console"></a>

1. レコードの詳細ページから、3 つのドットメニュー (⋮) を選択し、**削除**を選択します。

1. プロンプトが表示されたら「削除」と入力して削除を確認します。

削除は永続的であり、元に戻すことはできません。

### AWS CLI
<a name="registry-delete-record-cli"></a>

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

### AWS SDK
<a name="registry-delete-record-sdk"></a>

```
import boto3

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

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

## スキーマの検証
<a name="registry-schema-validation"></a>

レコードを作成または編集すると、コンソールと API は、選択したレコードタイプの公式スキーマに対してプロトコル設定を検証します。検証の詳細については、[「サポートされているレコードタイプ](registry-supported-record-types.md)」を参照してください。