Upgrade to Pro — share decks privately, control downloads, hide ads and more …

会社で探して使う | Kiro と学ぶ Amazon Bedrock AgentCore 12

会社で探して使う | Kiro と学ぶ Amazon Bedrock AgentCore 12

ほかのチームが作った道具やエージェントを見つけられないと、同じものを何度も作り直すことになります。この資料では、確かめた人が承認した道具、エージェント、Skill だけを 1 か所に並べ、人もエージェントも探せる AWS Agent Registry の仕組み (registry と record、載せる人、確かめる人、使う人の役、record の一生) を、公式のアイコンの構成図と流れの図で説明します。04 の AgentCore Gateway を MCP の record にして載せ、承認に出して承認し、record に無い言葉で探して見つけるところ、エージェントが registry の MCP の口で同じように探すところ、署名の無い問い合わせが断られるところを、AWS CLI の本物の端末の画面の大事な行で見せます。見つけても呼ぶ許可は別に IAM でもらうこと、役ごとの IAM の許可、承認を Amazon EventBridge で今の審査の流れにつなぐこと、AWS Organizations での自動の取り込み、AWS RAM と AWS PrivateLink、片付け、シリーズ 12 回の振り返りも扱います。命令の全文、record の中身を作る命令、MCP の口を呼ぶスクリプトの全文は付録にあります。Level 300 (仕組み、設定の選び方、作り方)。シリーズ「Kiro と学ぶ Amazon Bedrock AgentCore」の 12 (守って広げる) です。

Avatar for Riku INADA

Riku INADA PRO

November 11, 2026

More Decks by Riku INADA

Other Decks in Technology

Transcript

  1. Kiro と学ぶ Amazon Bedrock AgentCore 12 守って広げる Level 300 会社で探して使う

    AWS Agent Registry 2026-11 時点 (AWS CLI 2.38.5) 2026 年 11 ⽉ 稲⽥ ⼤陸 アマゾン ウェブ サービス ジャパン © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 12 Kiro + AgentCore 1
  2. はじめに ⾃⼰紹介 稲⽥ ⼤陸 いなだ りく (いなりく) アマゾン ウェブ サービス

    ジャパン合同会社 ソリューションアーキテクト 製造業のお客様を中⼼に⽀援 最近の取り組み AI 駆動開発ライフサイクルの推進 Kiro と AWS Amplify の情報発信 © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. X @inada_riku Speaker Deck speakerdeck.com/inariku Zenn zenn.dev/inariku GitHub github.com/inariku 2
  3. はじめに シリーズの中の位置 いまは 12 会社で探して使う、前に読むとよいのは 04 道具をつなぐ はじめる 01–02 作り込む

    01 AgentCore のしくみ 03–06 ⾒て直す 03 覚えさせる 07–09 守って広げる 10–12 07 動きを⾒る 10 ⼊⼝と出⼝に鍵をかける 08 評価する 11 決まりで⽌める 09 良くし続ける 12 会社で探して使う 前に読む 02 Runtime を使いこなす 04 道具をつなぐ 計算させ、 05 Web を⾒させる 06 設定で組む © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 3
  4. はじめに この資料で分かることと、始める前に要るもの 作った道具を社内の registry に載せ、承認したものだけを探して使う 1 AWS Agent Registry: registry

    に record を載せ、承認したものだけを⾒せる 2 載せて探す: 04 の Gateway を載せ、CLI と MCP の⼝で探す。呼ぶ許しは別 3 広げる: 役ごとの許可、承認の知らせ、組織、アカウント、閉じた網 要るもの: 04 の Gateway、AWS CLI 2.38.5、AWS Identity and Access Management (IAM) の許し (20 枚⽬) jq と Python (botocore) も使う。同じ命令は公開の⼊⾨の⼿順 (天気の MCP サーバー) で流せる Registry とは お店の道具を載せる 会社に広げる registry と 4 ⼈の役 承認して、探す 許可、組織、網 © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 4
  5. 1 AWS Agent Registry とは 同じ道具を何度も作る ほかのチームが作ったものを⾒つけられないので、作り直す 注⽂を引く道具を作ろう チーム A

    こちらでも作ろう チーム B 誰のもので確かめたかの記録が無いと、⼿間と版のずれが重なる © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 6
  6. 1 AWS Agent Registry とは 承認したものだけを並べる registry 載せる⼈、確かめる⼈、探す⼈が、1 つの registry

    を使う AWS Agent Registry と AgentCore Gateway は Amazon Bedrock AgentCore の部品 © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 7
  7. 1 AWS Agent Registry とは registry と record registry は載せる場所とその決まり。record

    は載せた 1 つのもの record の型 registry acdecks12-shop-registry ⼊⼝の確かめ⽅ IAM か JWT。作ったあとは変えられない 承認 ⼿で (省いたとき) か、⾃動 ほか 名前、説明、タグ、暗号の鍵 お店の道具 (注⽂と返⾦) 返⾦の⼿順書 版 1.0、型 MCP 版 1.0、型 SKILL 中⾝: ⼝の URL と道具 3 つ 中⾝: SKILL.md の⽂ APPROVED PENDING_APPROVAL MCP MCP サーバーと道具 AGENT A2A の agent card など SKILL Skill の SKILL.md CUSTOM ⾃分で決めた JSON GATEWAY ⾃動の取り込みで作る MCP、AGENT、SKILL は 載せるときに型で確かめる © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 8
  8. 1 AWS Agent Registry とは 4 ⼈の役 使う⼈に⾒えるのは、確かめる⼈が承認したものだけ 1 管理する⼈

    registry を作る create-registry 2 載せる⼈ record を作って出す create-registry-record 3 確かめる⼈ 確かめて承認する update-registry-record-status 4 使う⼈ 承認済みを探す search-discoverable-registry-records AWS Agent Registry: 使う⼈の⼀覧と検索に出るのは APPROVED の版だけ © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 9
  9. 1 AWS Agent Registry とは record の⼀⽣ 下書き、承認待ち、承認済み。外すと戻せない 出す 承認

    DRAFT PENDING_APPROVAL APPROVED 下書き 承認待ち 承認済み (探せる) 直すと新しい下書きの版になる。 差し戻す 前の版は次の承認まで探せる REJECTED 直して出し直す そのまま承認もできる DEPRECATED 外す: どの状態からでも。戻せない 探す側に⾒えるのは承認済みの版だけ。隠すだけなら差し戻し、直して承認すれば新しい版で戻る © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 10
  10. 第2部 2 載せて、承認して、探す 04 の Gateway を record にして載せ、承認してから探す ©

    2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 11
  11. 2 載せて、承認して、探す registry を作ると、探せるのは IAM の許しを持つ⼈だけになる 1 できた registry acdecks12-shop-registry

    2 決まりは 2 つ ⼊⼝は IAM: 探すには IAM の許しが要る 承認は⼿で: 承認するまで 管理する⼈ まだ record は無い だれにも⾒えない どちらも省いたときの値。⼊⼝の型は、あとで変えられない。READY になってから record を載せる 1 registry を作る命令。名前と タグだけを付けた 2 作れた。⼊⼝は IAM、⾃動の承認の 決まりは空 (⼿で承認する) 作る命令は agent-registry-control、探す命令は agent-registry (プレビューの頃の命令は使えない) © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 12
  12. 2 載せて、承認して、探す 04 の Gateway を record にして載せる。最初は下書き record: お店の道具

    (注⽂と返⾦) 04 の Gateway 1 2 お店の道具 3 つ (変えずに読む) 中⾝: MCP の形で、⼝の URL と道具 3 つ customers___lookup_customer orders___get_order_history refunds___process_refund 載せる 3 DRAFT 下書き。まだだれにも⾒えない record を載せる命令 1 中⾝の JSON (付録 A7) 2 ⼀覧で⾒ると、下書き (DRAFT) 3 名前、説明、URL に秘密や資格情報を書かない。外の MCP や A2A の⼝から取り込んで同期もできる © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 13
  13. 2 載せて、承認して、探す 承認されるまで、record は探す側に出てこない DRAFT 1 PENDING_APPROVAL 載せる⼈が出す 3 APPROVED

    2 確かめる⼈が承認 管理する側の⼀覧: 全部の record 4 探す側の⼀覧: 承認済みだけ お店の道具 APPROVED お店の道具 APPROVED 返⾦の⼿順書 PENDING_APPROVAL (承認待ち) 返⾦の⼿順書は出てこない 1 承認に出した 2 確かめる⼈が承認した 3 管理する側の ⼀覧: 2 つとも⾒える 4 探す側の ⼀覧: 承認済みの 1 つだけ © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 14
  14. 2 載せて、承認して、探す record に無い⾔葉で探しても、意味が近い record が⾒つかる 意味の検索と 1 「お⾦を戻したい」 record

    に無い⾔葉で探す 2 お店の道具 (注⽂と返⾦) ⼝の URL も返る ⾔葉の⼀致を 同時に流す 承認待ちの record は探さない 3 道具 3 つ 返⾦の道具 refunds___process_refund 1 「お⾦を戻したい」で探した 2 ⾒つかった record 3 その record の道具 3 つ。返⾦の道具も ⼊っている © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 15
  15. 2 載せて、承認して、探す エージェントも、registry の MCP の⼝で同じように探せる registry の MCP の⼝

    1 エージェント (MCP の呼ぶ側) 3 お店の道具 道具は 3 つ search_discoverable_registry_records list_discoverable_registry_records batch_get_discoverable_registry_record SigV4 2 CLI と同じ record (承認済みだけ) 1 つ⽬に⽂を渡して呼ぶ ⼝: https://agent-registry.<リージョン>.api.aws/registry/<ID>/mcp 1 ⼝が持つ道具 3 つ 2 検索の道具に⽂を渡した (15 枚⽬とは別の⽂) 3 CLI と同じ record が返った © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 16
  16. 2 載せて、承認して、探す ⾒つけても、呼べるかは別 registry が教えるのは⼝と確かめ⽅。呼ぶ許可は別に IAM でもらう 1 探す: AWS

    Agent Registry agent-registry: SearchDiscoverableRegistryRecords 問い合わせ窓⼝ (エージェント) 2 呼ぶ: AgentCore Gateway (04) bedrock-agentcore: InvokeGateway record が教えるのは URL と⼊⼝の確かめ⽅まで。呼ぶ許可は Gateway の持ち主が IAM で別に出す 承認済みでも、record の URL やパッケージが本物かは AWS が確かめない。許した場所にだけつなぎ、 パッケージは版を固定して⼊れる © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 17
  17. 3 会社に広げる 署名の無い問い合わせは、registry に届く前に断られる 署名なし 1 検索の⼝: AccessDeniedException (署名が無い) 2

    MCP の⼝: 401 (認証が要る) IAM の許しで署名すると、答える (15、16 枚⽬) 1 署名を付けずに探すと、 断られる 2 MCP の⼝も、認証が要ると断る IAM は AWS の役で動く⼈とエージェント向け。社内のサインイン (Amazon Cognito など) で⼊る⼈にも 探させるなら、作るときに JWT を選ぶ (変えられない) © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 19
  18. 3 会社に広げる 役ごとに許可を分ける 探すだけの⼈に載せる許しを付けない。状態を変えるのは確かめる⼈ 管理する⼈ 載せる⼈ 確かめる⼈ 使う⼈ registry を作る、変える、消す

    CreateRegistry ほか record を作る、直す、承認に出す CreateRegistryRecord ほか 承認する、差し戻す、外す UpdateRegistryRecordStatus 探す、⼀覧、MCP の⼝ (InvokeRegistryMcp) SearchDiscoverableRegistryRecords ほか 管理の操作 (agent-registry-control) はいつも IAM。探す側 (agent-registry) の⼊⼝だけが IAM か JWT IAM の⽅針の全⽂の例は、⽂書の Prerequisites の⾴にある 管理する⼈には bedrock-agentcore:*WorkloadIdentity と iam:CreateServiceLinkedRole も要る © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 20
  19. 3 会社に広げる 承認を、今の審査の流れにつなぐ 承認に出すと Amazon EventBridge に知らせが届く。⾃分の確かめを流す 承認に出す PENDING_APPROVAL 知らせ

    ⾃分の確かめ 承認か差し戻し 載せる⼈ Registry EventBridge スキャンと⼈の⽬ 状態を変える API 差し戻すときは理由を書く。載せる⼈が直して出し直す 確かめること: 安全と決まりに合うか、説明と⼊⼒の型、重なる道具、読むだけか、取り消せるか、お⾦が動くか 返⾦の道具は危うさが⾼い。registry の承認は、呼ぶときの確認 (11 回⽬の Policy) の代わりにならない ⾃動の承認を使うなら、出せる⼈を絞り、知らせで⾃動の確かめを流す (この資料では作っていない) © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 21
  20. 3 会社に広げる 組織で⾃動で載せる 組織の Runtime と Gateway が、1 つの registry

    に⾃動で載る AWS Organizations 管理のアカウント 信頼の許可を有効にし、 委任の管理者を決める メンバーのアカウント 1 Runtime Gateway メンバーのアカウント 2 Runtime Gateway 委任の管理者のアカウント 組織の registry 組織とリージョンで 1 つ © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. メンバーのアカウント 3 Runtime ⾃動で作られる record GATEWAY Gateway から AGENT Runtime から ⾃動で載った record も承認が要る。 ⾃動の承認とは組まない 取り込み中は record を消せない この資料では使っていない Gateway 22
  21. 3 会社に広げる アカウントをまたぐ、閉じた網から使う AWS Resource Access Manager (AWS RAM) の

    4 つの許可で分ける アカウントをまたぐ (AWS RAM) 閉じた網から (AWS PrivateLink) 持ち主の ⾃分の Amazon VPC registry agent-registry-control 読むだけ (既定) 読み取りと探す。MCP の⼝なし 管理 (作る、承認する) 使う⼈ 探すと MCP の⼝だけ agent-registry 載せる⼈ 使う⼈ + record を作る、出す 探す、MCP の⼝ 管理 載せる⼈ + 承認、差し戻し、外す registry を変える、消すのは持ち主だけ。 同じ組織で RAM の組織との共有を有効に インターネットを通らずに使う。 ⼝の⽅針で、使える API を絞れる していれば、招待は要らない © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 23
  22. 第4部 4 ⽚付けて、振り返る record と registry を消し、シリーズの 12 回を振り返る ©

    2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 24
  23. 4 ⽚付けて、振り返る ⽚付ける 消すときは record、registry の順。この回の分は最後にまとめて消す 1 record を 2

    つ消す お店の道具、返⾦の⼿順書 2 registry を消す record が 0 になってから 3 ⼀覧で確かめる list-registries が 0 件 この回の registry と record は、シリーズの最後にまとめて消す (04 の Gateway は残す) registry は、record を全部消してからでないと消せない。⼿元の found.json と mcp-found.json も消す record は今ある件数で数える。毎⽉ 5,000 件まで無料 (2026 年 11 ⽉)。消す命令は付録 A6 © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 25
  24. 4 ⽚付けて、振り返る シリーズの振り返り 各回の部品と、問い合わせ窓⼝で使った所 01 AgentCore Runtime 窓⼝を東京に載せる 04 AgentCore

    Gateway AWS Lambda を道具に 07 AgentCore Observability トレースとログを読む 10 AgentCore Identity ⼊⼝と出⼝の確かめ © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 02 AgentCore Runtime セッション、版、⻑い仕事 05 Code Interpreter、Browser 計算と Web の⾴を読む 08 AgentCore Evaluations 本番の会話を採点 11 Policy in AgentCore Cedar の決まりで⽌める 03 AgentCore Memory 短期と⻑期の記憶 06 AgentCore harness 設定で窓⼝を組む 09 AgentCore optimization 改善の案と A/B テスト 12 AWS Agent Registry 道具を載せて探す 26
  25. 4 ⽚付けて、振り返る このシリーズで扱わなかった部品 部品 何をするか 扱わなかった理由 AgentCore payments エージェントが⼩さな⽀払いをする 東京に無い。外のウォレットの

    申し込みが要る Web Answer (Gateway) Web を調べ、出典付きの答えを返す us-east-1 だけ Runtime Instances ⾃分のアカウントの EC2 で⻑く動かす 東京にあるが、試していない ⾃分の AWS KMS の鍵 (Registry) record の中⾝を⾃分の鍵で暗号にする 作るときだけ選べる。既定の 鍵を使った ⾃分の項⽬ (Registry) 持ち主や区分の項⽬を⾜して絞り込む registry に項⽬の型を決める 必要がある © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 27
  26. まとめ まとめ 載せて、承認して、探す。呼ぶ許しは別 1 AWS Agent Registry: registry に record

    を載せ、承認したものだけを⾒せる 2 載せて探す: 04 の Gateway を載せ、CLI と MCP の⼝で探す。呼ぶ許しは別 広げる: 役ごとの許可、承認の知らせ、組織、アカウント、閉じた網 3 1 載せて承認する 承認済みだけが探せる © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 2 探す CLI と MCP の⼝。呼ぶ許可は別 3 広げる 役、知らせ、組織、閉じた網 28
  27. まとめ 次に読む資料 気になる部品の回へ。エージェントの中の作りは別のシリーズで 01〜11 別のシリーズ 別のシリーズ シリーズの地図の全体 Strands Agents 01

    ハーネスエンジニアリング 01 気になる部品の回へ戻る。 エージェントのしくみ エージェント = どれか 1 つから⾜せる (モデル + ハーネス、道具) モデル + ハーネス © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 29
  28. 付録 A1 ⽤語 ⽤語 意味 ⽤語 意味 registry record を載せる

    場所 (⼊⼝と承認の決まり) record 載せた 1 つのもの descriptor record の中⾝ (型ごと) server.json MCP サーバーの説明の形 DRAFT 下書き PENDING_APPROVAL 承認待ち APPROVED 承認済み (探せる) REJECTED 差し戻した DEPRECATED 外した (戻せない) SigV4、JWT AWS の署名、サインインの トークン agent-registry-control 作る、出す、承認する命令 agent-registry 探す命令、MCP の⼝ EventBridge、RAM 知らせを配る、 アカウントで分ける PrivateLink VPC から閉じた網で使う © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 30
  29. 付録 A2 命令の全⽂ (1) registry を作る AWS CLI 2.38.5、東京。# の⾏は何をした命令か。\

    は次の⾏に続く # registry を作り、ID を変数に取る (返る ARN の最後の / の後ろが ID) REG=$(aws agent-registry-control create-registry --region ap-northeast-1 \ --name acdecks12-shop-registry --description "お店の道具とエージェントの⽬録" \ --tags project=agentcore-decks --query registryArn --output text | cut -d/ -f2) # status が READY になってから次へ進む (CREATING のあいだは、少し待って流し直す) aws agent-registry-control get-registry --region ap-northeast-1 \ --registry-id $REG | jq -cr '.status, .discoveryConfiguration, .approvalConfiguration' © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 31
  30. 付録 A3 命令の全⽂ (2) record を載せる AWS CLI 2.38.5、東京。# の⾏は何をした命令か。\

    は次の⾏に続く # record を載せ、ID を変数に取る (shop-tools.json の作り⽅は付録 A7) REC=$(aws agent-registry-control create-registry-record --region ap-northeast-1 \ --registry-id $REG --name acdecks12-shop-tools --record-version 1.0 \ --display-name "お店の道具 (注⽂と返⾦)" \ --description "お客さんの確かめ、注⽂の履歴、返⾦の道具" \ --record-type MCP --descriptors file://shop-tools.json \ --tags project=agentcore-decks --query recordArn --output text | cut -d/ -f4) # 下書き (DRAFT) になったかを⼀覧で⾒る (13 枚⽬の ③) aws agent-registry-control list-registry-records --region ap-northeast-1 \ --registry-id $REG © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 32
  31. 付録 A4 命令の全⽂ (3) 承認に出して、承認する AWS CLI 2.38.5、東京。# の⾏は何をした命令か。\ は次の⾏に続く

    # 承認に出す。確かめる⼈が承認する aws agent-registry-control submit-registry-record-for-approval \ --region ap-northeast-1 --registry-id $REG --record-id $REC aws agent-registry-control update-registry-record-status --region ap-northeast-1 \ --registry-id $REG --record-id $REC --status APPROVED \ --status-reason "説明と道具の形を確かめた" # 返⾦の⼿順書の record (型 SKILL。refund-skill.json は付録 A8) を作って出す SKILL=$(aws agent-registry-control create-registry-record --region ap-northeast-1 \ --registry-id $REG --name acdecks12-refund-procedure --record-version 1.0 \ --display-name "返⾦の⼿順書" --record-type SKILL \ --descriptors file://refund-skill.json --tags project=agentcore-decks \ --query recordArn --output text | cut -d/ -f4) aws agent-registry-control submit-registry-record-for-approval \ --region ap-northeast-1 --registry-id $REG --record-id $SKILL © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 33
  32. 付録 A5 命令の全⽂ (4) 探す、MCP の⼝、断られる AWS CLI 2.38.5、東京。# の⾏は何をした命令か。\

    は次の⾏に続く # ⽂で探す。探す側の⼀覧 aws agent-registry search-discoverable-registry-records --region ap-northeast-1 \ --registry-ids $REG --search-query "お⾦を戻したい" aws agent-registry list-discoverable-registry-records --region ap-northeast-1 \ --registry-id $REG # MCP の⼝: 付録 A9 の mcp_call.py で、道具の⼀覧と、⽂で探す道具を呼ぶ export REG; run() { uv run -q --with boto3 python3 mcp_call.py "$@"; } run tools/list | jq -r '.result.tools[].name' run tools/call search_discoverable_registry_records '{"searchQuery": "注⽂の返⾦をしたい"}' # 署名を付けずに探す。署名の無い MCP の⼝ (どちらも断られる) aws agent-registry search-discoverable-registry-records --region ap-northeast-1 \ --registry-ids $REG --search-query "返⾦" --no-sign-request --cli-error-format yaml curl -s -X POST https://agent-registry.ap-northeast-1.api.aws/registry/$REG/mcp \ -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 34
  33. 付録 A6 命令の全⽂ (5) ⽚付ける AWS CLI 2.38.5、東京。# の⾏は何をした命令か。\ は次の⾏に続く

    # 返⾦の⼿順書の record、お店の道具の record の順に消す aws agent-registry-control delete-registry-record --region ap-northeast-1 \ --registry-id $REG --record-id $SKILL aws agent-registry-control delete-registry-record --region ap-northeast-1 \ --registry-id $REG --record-id $REC # registry を消す (record が 0 になってから) aws agent-registry-control delete-registry --region ap-northeast-1 \ --registry-id $REG # registry の数を確かめる (0 になる) aws agent-registry-control list-registries --region ap-northeast-1 \ --query 'length(registries)' © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 35
  34. 付録 A7 record の中⾝ (1) shop-tools.json を作る AWS CLI 2.38.5、東京。#

    の⾏は何をした命令か。\ は次の⾏に続く # URL は 04 の Gateway の⼝。説明 (D) は 100 字まで URL=$(aws bedrock-agentcore-control get-gateway --region ap-northeast-1 \ --gateway-identifier <04 の Gateway の ID> --query gatewayUrl --output text) D='ネットの家電のお店の問い合わせ窓⼝が使う道具。' D+='お客さんの確かめ、注⽂の履歴、返⾦。⼊⼝は IAM (SigV4)。' jq -n --arg d "$D" --arg u "$URL" '{name: "com.example.shop/support-desk-tools", title: "お店の問い合わせ窓⼝の道具", description: $d, version: "1.0.0", remotes: [{type: "streamable-http", url: $u}]}' > server.json # 04 のプロジェクトの道具の定義 3 つの名前に、対象の名前と ___ を付ける jq -n '{tools: [inputs | (input_filename | split("/")[-1] | rtrimstr(".json")) as $t | .[] | .name = "\($t)___\(.name)"]}' agentcore/tools/*.json > tools.json jq -n --slurpfile s server.json --slurpfile t tools.json '{mcpServer: { dataSchemaVersion: "2025-12-11", data: ($s[0] | tojson), additionalData: {tools: { dataSchemaVersion: "2025-11-25", data: ($t[0] | tojson)}}}}' > shop-tools.json © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 36
  35. 付録 A8 record の中⾝ (2) 返⾦の⼿順書 (SKILL) SKILL.md (--- から

    4. までの 9 ⾏) と、それを refund-skill.json に包む jq の命令 --name: refund-procedure description: <下の⽂> --# 返⾦の⼿順 1. お客さんの ID で本⼈を確かめる。 2. 注⽂の履歴で、注⽂の ID と額を確かめる。 3. 返⾦の額は 1 円から注⽂の額まで。超えるときは返⾦しない。 4. 返⾦は取り消せない。お客さんが返⾦を望んだときだけ受け付ける。 jq -n --rawfile m SKILL.md \ '{agentSkillsDefinition: {additionalData: {skillMd: {data: $m}}}}' > refund-skill.json description: お客さんから返⾦を頼まれたときの⼿順。本⼈を確かめ、注⽂の額を確かめ、額が注⽂の額を 超えないことを確かめてから返⾦する。 © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 37
  36. 付録 A9 mcp_call.py の全⽂ mcp_call.py (Python 3。付録 A5 のとおり uv

    run --with boto3 で動かす) import json, os, sys, urllib.request, botocore.session from botocore.auth import SigV4Auth from botocore.awsrequest import AWSRequest REGION, (method, *args) = "ap-northeast-1", sys.argv[1:] URL = f"https://agent-registry.{REGION}.api.aws/registry/{os.environ['REG']}/mcp" params = {"name": args[0], "arguments": json.loads(args[1])} if args else {} msg = {"jsonrpc": "2.0", "id": 1, "method": method, "params": params} body = json.dumps(msg).encode() h = {"Content-Type": "application/json", "Accept": "application/json, text/event-stream"} req = AWSRequest(method="POST", url=URL, data=body, headers=h) cred = botocore.session.Session().get_credentials() SigV4Auth(cred, "agent-registry", REGION).add_auth(req) r = urllib.request.Request(URL, body, dict(req.headers)) # data があると POST print(urllib.request.urlopen(r, timeout=30).read().decode()) © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 38
  37. 付録 A10 出典 AWS、AgentCore Developer Guide 「AWS Agent Registry: Discover

    and manage agents, tools, and resources」 (4、6、7、28 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry.html AWS、AgentCore Developer Guide「Get started with AWS Agent Registry」 (4、12、13、14、31、32、33 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-get-started.html AWS Machine Learning Blog、2026 年 8 ⽉、 Manage agents, tools and skills at scale with AWS Agent Registry (6、9、17、20、21 枚⽬) aws.amazon.com/blogs/machine-learning/manage-agents-tools-and-skills-at-scale-with-aws-agent-registry/ AWS、AgentCore Developer Guide「Key capabilities」 (7、21 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-key-capabilities.html AWS、AgentCore Developer Guide「Notifications (Amazon EventBridge)」 (7、21 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-eventbridge.html AWS、AgentCore Developer Guide「Concepts and terminology」 (8、9 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-concepts.html © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 39
  38. 付録 A11 出典 (続き) AWS、AgentCore Developer Guide「Supported Inbound Authorization types」

    (8、12、16、19、20、34 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-supported-auth-types.html AWS、AgentCore Developer Guide「Create and manage registries」 (8、12、25、27、31、35 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-create-manage.html AWS、AgentCore Developer Guide「Supported record types and descriptors」 (8、13、32、33、36、37 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-supported-record-types.html AWS、AgentCore Developer Guide「Using AWS Agent Registry with AWS Organizations」 (8、22 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-organizations.html AWS、AgentCore Developer Guide「Record lifecycle」 (10、14 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-record-lifecycle.html AWS、AgentCore Developer Guide「Curating the registry」 (10、14、33 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-curating.html © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 40
  39. 付録 A12 出典 (続き) AWS、AgentCore Developer Guide「Discovering the registry」 (13、15、16、34、38

    枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-searching.html AWS、AgentCore Developer Guide「Data protection in AWS Agent Registry」 (13、15、16、17 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-data-protection.html Model Context Protocol のプロジェクト、server.json の形の⽂書 (13、36 枚⽬) github.com/modelcontextprotocol/registry AWS、AgentCore Developer Guide「Prerequisites」 (20 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-prerequisites.html AWS、AgentCore Developer Guide「AWS CloudTrail integration」 (20 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-cloudtrail-integration.html AWS、AgentCore Developer Guide「Reviewing registry records」 (21 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-reviewing-records.html Anthropic、2025 年 9 ⽉、エージェントのための道具の書き⽅ (21 枚⽬) anthropic.com/engineering/writing-tools-for-agents © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 41
  40. 付録 A13 出典 (続き) OpenAI、2025 年 4 ⽉、エージェントの作り⽅の⼿引き (21 枚⽬)

    cdn.openai.com/business-guides-and-resources/a-practical-guide-to-building-agents.pdf AWS、AgentCore Developer Guide「Sharing a registry across accounts with AWS RAM」 (23 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-cross-account-sharing.html AWS、AgentCore Developer Guide「VPC and AWS PrivateLink with AWS Agent Registry」 (23 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-privatelink.html AWS、AgentCore Developer Guide「Supported AWS Regions」 (25、27 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agentcore-regions.html AWS、AgentCore Developer Guide「Overview」 (26 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html AWS、AgentCore Developer Guide「Web Answer」 (27 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-connector-web-answer-tool.html AWS、AgentCore Developer Guide「Define a custom metadata schema」 (27 枚⽬) docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-custom-metadata-schema.html © 2026, Amazon Web Services, Inc. or its affiliates. All rights reserved. 42