View a markdown version of this page

レコードの作成と管理 - Amazon Bedrock AgentCore

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

レコードの作成と管理

移行がオープンに

AWS エージェントレジストリが新しいagent-registry名前空間で起動されました。パブリックプレビューbedrock-agentcore名前空間のサポートは、2026 年 9 月 17 日に終了します。移行手順については、「包括的なレジストリ移行ガイド」を参照してください。

レジストリレコードを作成する

コンソール

例
AWS Agent Registry namespace
  1. AWS エージェントレジストリコンソールでレジストリの詳細ページを開きます。

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

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

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

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

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

  1. レコードの詳細で、レコードタイプとして MCP または エージェントを選択します。

    注記

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

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

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

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

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

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

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

    レコードは CREATING ステータスで作成されます。レジストリはエンドポイントに接続し、メタデータを抽出して、レコードの記述子を入力します。同期が完了すると、レコードは DRAFT に移行します。同期が失敗すると、レコードは CREATE_FAILED ステータスに移行し、レコードの詳細ページの Status Reason フィールドでエラーの詳細が表示されます。トラブルシューティングについては、「同期エラーを記録する」を参照してください。ソースの変更時にレコードを更新するには、管理を選択し、レコードの詳細ページで同期を選択するか、管理 → 編集してエンドポイントから再同期を選択します。

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

手動

  1. 「レコードの詳細」セクションの「名前」に、レコードの一意の名前を入力します。名前はレジストリ内で一意である必要があります。 Nameと の組み合わせは一意Record versionである必要があります。名前は英数字で始まる必要があります。有効な文字は、a~z、A~Z、0~9、 _ (アンダースコア)、 - (ハイフン)、 . (ピリオド)、 / (スラッシュ) です。名前は最大 255 文字です。

  2. (オプション) 表示名に、レコードの人間が読み取れるラベルを入力します。これは、レジストリレコードテーブルと検索結果に、レコードの技術名とともに表示されます。

  3. (オプション) 説明 に、レコードの説明を入力します。説明は 1~4,096 文字です。

  4. レコードバージョンには、レコードのバージョン識別子 (例: 1.0.0または v2.1) を入力します。

  5. レコードタイプと記述子セクション:

    1. Type で、レコードのセマンティックタイプを選択します。タイプは、有効なプライマリ記述子キーを決定します。

      • MCP – AI ツールとエージェント通信用に設計されたプロトコル。コンテキスト管理と構造化されたメッセージ形式を処理します。

      • エージェント – エージェントagent-to-agent安全なやり取りのために設計されたプロトコル。分散ワークフローと情報交換を有効にします。

      • スキル – マークダウンドキュメントとオプションの構造化定義を使用してエージェントスキルを登録します。

      • カスタム – 特殊な通信パターンのためのカスタムプロトコル実装。独自のインターフェイス仕様と統合要件を定義します。

    2. Descriptor で、レコードの記述子データの形状を選択します。使用可能なオプションは、選択したタイプによって異なります。

      • MCP → MCP サーバーまたはカスタム

      • エージェント → A2A エージェントカード、MCP サーバー、またはカスタム

      • スキル → エージェントスキル定義またはカスタム

      • カスタム → カスタム

  6. 記述子固有のエディタが、記述子の選択に基づいて表示されます。プロトコル設定を JSON 形式で入力します。MCP サーバーと A2A エージェントカード記述子の場合は、公式スキーマの表示を切り替えて参照スキーマをside-by-side表示します。コンソールは JSON を公式スキーマと照合し、Amazon Q での診断ボタンを使用してインラインエラー (「プロパティ '名前' の欠落」など) を表示します。記述子ごとの設定の詳細については、「サポートされているレコードタイプ」を参照してください。

  7. (オプション) Tags セクションで、Add new tag を選択して 1 つ以上のタグをレコードにアタッチします。各タグにはキーとオプションの値があります。

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

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

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

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore コンソールでレジストリの詳細ページを開きます。

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

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

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

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

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

  1. レコードの詳細で、レコードタイプとして MCP または エージェントを選択します。

    注記

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

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

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

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

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

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

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

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

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

手動

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

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

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

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

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

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

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

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

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

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

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

AWS CLI

例
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \ --registry-id <registryId> \ --name "my-mcp-server" \ --display-name "MyMCPServer" \ --record-type MCP \ --descriptors '{"mcpServer": {"data": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}", "dataSchemaVersion": "2025-12-11"}}' \ --record-version "1.0" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
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

例
AWS Agent Registry namespace
import boto3 import json client = boto3.client('agent-registry-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='my-mcp-server', displayName='MyMCPServer', recordType='MCP', descriptors={ 'mcpServer': { 'data': server_content, 'dataSchemaVersion': '2025-12-11' } }, recordVersion='1.0' ) print(f"Record ARN: {response['recordArn']}") print(f"Status: {response['status']}") # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
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
注記

agent-registry 名前空間では、 nameはレジストリ内の一意のキーです (name+ recordVersionの組み合わせは一意である必要があります)。人間が読めるラベルdisplayNameに を使用します。descriptors 構造はフラットで、プライマリ記述子タイプ (mcpServer、a2aAgentCard、agentSkillsDefinition、custom) によってキーが付けられます。前の inlineContent/schemaVersion フィールドの名前は data/ に変更されますdataSchemaVersion。

レジストリレコードを一覧表示する

コンソール

例
AWS Agent Registry namespace
  1. AWS エージェントレジストリコンソールでレジストリの詳細ページを開きます。

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

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

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

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

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore コンソールでレジストリの詳細ページを開きます。

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

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

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

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

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

AWS CLI

例
AWS Agent Registry namespace
aws agent-registry-control list-registry-records \ --registry-id "<registryId>" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registry-records \ --registry-id "<registryId>" \ --region us-east-1

AWS SDK

例
AWS Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.list_registry_records( registryId='<registryId>' ) for record in response['registryRecords']: print(f"{record['displayName']} ({record['name']}) - {record['status']} - {record['recordType']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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']}")
注記

agent-registry 名前空間では、 はフィールドごとの個別のクエリfiltersパラメータではなく、構造化パラメータ ({"name": "<dotted.path>", "values": […​]}エントリのリスト) ListRegistryRecordsを受け入れます。サポートされているフィルター名: name、status、および recordType。

レコードの詳細を表示する

コンソール

例
AWS Agent Registry namespace
  1. AWS エージェントレジストリコンソールのレジストリの詳細ページで、レコードテーブルからレコード名を選択します。

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

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

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

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

    4. タグセクション — レコードに関連付けられたタグをキーと値のテーブルとして表示します。タグを追加、削除、または変更するには、このセクションで編集を選択してタグの編集ページを開きます。

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

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

    2. 管理ボタン — 編集を選択してレコードを変更します。削除して完全に削除するか、同期を選択して設定済みのエンドポイントから新しい同期をトリガーします (MCP レコードとエージェントレコードのみ)。同期により確認ダイアログが開き、同期中にレコードが UPDATING ステータスに移行します。

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore コンソールのレジストリの詳細ページで、レコードテーブルからレコード名を選択します。

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

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

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

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

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

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

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

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

AWS CLI

例
AWS Agent Registry namespace
aws agent-registry-control get-registry-record \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control get-registry-record \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --region us-east-1

AWS SDK

例
AWS Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.get_registry_record( registryId='<registryId>', recordId='<recordId>' ) print(f"Name (dedup key): {response['name']}") print(f"Display Name: {response['displayName']}") print(f"Description: {response['description']}") print(f"Status: {response['status']}") print(f"Record Type: {response['recordType']}") print(f"Version: {response['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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']}")

レジストリレコードを更新する

コンソール

例
AWS Agent Registry namespace
  1. AWS エージェントレジストリコンソールのレコード詳細ページから、管理を選択し、編集を選択します。

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

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

    2. レコードタイプと記述子 — 必要に応じてセマンティックタイプや記述子の形状を変更します。タイプを変更すると、新しい記述子を選択し、記述子のコンテンツを再入力する必要がある場合があります。

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

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

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

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

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

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

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

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

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

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

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

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

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

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore コンソールのレコード詳細ページから、3 つのドットメニュー (⋮) を選択し、編集を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

注記

タグは、 AWS エージェントレジストリコンソールのレコードの編集ページからは編集されません。タグを変更するには、レコードの詳細ページに移動し、タグセクションで編集を選択し、タグの編集ページでタグを追加または削除し、変更の保存を選択します。(タグは AWS エージェントレジストリコンソールでのみサポートされています)。

AWS CLI

例
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --description "Updated description" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --description "Updated description" \ --region us-east-1

AWS SDK

例
AWS Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.update_registry_record( registryId='<registryId>', recordId='<recordId>', description='Updated description' ) print(f"Updated: {response['name']} - Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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']}")

承認のためにレコードを送信する

コンソール

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

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

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

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

注記

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

AWS CLI

例
AWS Agent Registry namespace
aws agent-registry-control submit-registry-record-for-approval \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control submit-registry-record-for-approval \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --region us-east-1

AWS SDK

例
AWS Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.submit_registry_record_for_approval( registryId='<registryId>', recordId='<recordId>' ) print(f"Status: {response['status']}") # PENDING_APPROVAL or APPROVED
Amazon Bedrock AgentCore namespace (to be deprecated)
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

レジストリレコードを削除する

コンソール

例
AWS Agent Registry namespace
  1. AWS エージェントレジストリコンソールのレコード詳細ページで、管理を選択し、削除を選択します。

  2. プロンプトdeleteが表示されたら、 を入力して削除を確認します。

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore コンソールのレコード詳細ページから、3 つのドットメニュー (⋮) を選択し、削除を選択します。

  2. プロンプトdeleteが表示されたら、 を入力して削除を確認します。

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

AWS CLI

例
AWS Agent Registry namespace
aws agent-registry-control delete-registry-record \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control delete-registry-record \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --region us-east-1

AWS SDK

例
AWS Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.delete_registry_record( registryId='<registryId>', recordId='<recordId>' ) print("Record deleted successfully")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3 client = boto3.client('bedrock-agentcore-control') response = client.delete_registry_record( registryId='<registryId>', recordId='<recordId>' ) print("Record deleted successfully")

スキーマの検証

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