開始使用 AWS 代理程式登錄檔

在本指南中，您將建立第一個登錄檔、新增記錄、核准記錄並搜尋記錄。

先決條件

完成先決條件中的步驟。

步驟 1：建立登錄檔

建立具有 IAM 授權和手動核准的登錄檔。

主控台

使用 IAM 型身分驗證建立登錄檔

若要使用 JWT 型身分驗證提供者授權建立登錄檔，請使用 JSON Web Token (JWT) 控制對登錄檔搜尋 API 的存取。您可以使用 Amazon Cognito 快速設定授權，或自攜身分提供者來啟用 OAuth 2.0。

建立登錄檔後，主控台會導覽至登錄檔詳細資訊頁面。登錄狀態一開始是建立 . AWS Agent 登錄檔會為登錄檔指派 ARN，您可以在登錄檔詳細資訊區段中找到。佈建完成後，登錄檔狀態會變更為就緒。當記錄的狀態為就緒時，您可以將記錄新增至登錄檔。

AWS CLI

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

登錄檔狀態會從 CREATING 開始，並在佈建完成時轉換為 READY。

AWS 開發套件

import boto3

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

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

步驟 2：新增登錄檔記錄

在登錄檔中為 MCP 伺服器建立記錄。

主控台

登錄檔記錄代表代理程式、工具、技能或自訂資源。

選擇建立記錄後， AWS 客服人員登錄檔會開始佈建記錄。記錄狀態最初是建立。佈建完成時，狀態會變更為草稿。若要讓記錄可供其他人探索，請將其提交以供核准。如需詳細資訊，請參閱步驟 3：提交記錄以供核准。

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

記錄會以 CREATING 狀態建立，並在處理完成時轉換為 DRAFT。如需建立其他類型記錄的更多 AWS CLI 範例，請參閱建立和管理記錄一節。

AWS 開發套件

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

步驟 3：提交記錄以供核准

主控台

提交記錄進行核准會啟動審核程序，讓記錄可供探索。您可以從登錄檔記錄資料表或記錄詳細資訊頁面提交記錄。

從登錄檔記錄資料表提交記錄以供核准

從記錄詳細資訊頁面提交記錄以供核准

在您提交記錄進行核准後，記錄狀態會根據登錄檔的核准設定而變更：

AWS CLI

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

記錄會移至 PENDING_APPROVAL （如果啟用自動核准，則直接移至核准）。

AWS 開發套件

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

步驟 4：核准記錄

主控台

從登錄檔記錄資料表核准記錄

從記錄詳細資訊頁面核准記錄

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 開發套件

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

步驟 5：搜尋登錄檔

主控台

您可以使用語意或關鍵字搜尋，在登錄檔中搜尋已核准的記錄，以尋找客服人員、MCP 伺服器、技能和其他資源。您可以依名稱、通訊協定或版本篩選結果，以縮小搜尋範圍。

搜尋登錄檔記錄

搜尋只會傳回處於已核准狀態的記錄。其他狀態的記錄，例如草稿、待核准、已拒絕或已棄用，都不會出現在搜尋結果中。

AWS CLI

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

已核准的記錄應該會出現在搜尋結果中。

AWS 開發套件

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

您已建置的內容

後續步驟