View a markdown version of this page

외부 소스의 레코드 동기화 - Amazon Bedrock AgentCore
개요퍼블릭 MCP 서버에서 동기화OAuth 보호 MCP 서버에서 동기화IAM 보호 MCP 서버에서 동기화A2A 에이전트 카드에서 동기화기존 레코드에서 동기화 트리거

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

외부 소스의 레코드 동기화

지금 마이그레이션 열기

AWS 에이전트 레지스트리가 새 agent-registry 네임스페이스에서 시작되었습니다. 퍼블릭 미리 보기 bedrock-agentcore 네임스페이스에 대한 지원은 2026년 9월 17일에 중단됩니다. 마이그레이션 지침은 포괄적인 레지스트리 마이그레이션 가이드를 참조하세요.

개요

AWS 에이전트 레지스트리는 제공된 URL에 아웃바운드 자격 증명을 연결하여 외부 소스의 레코드 메타데이터를 자동으로 동기화할 수 있습니다. URL 및 자격 증명 공급자를 제공하면(액세스 권한 부여가 필요하지 않은 퍼블릭 리소스의 경우 선택 사항) 시스템은 서버 및 도구 정의를 추출하고 공식 프로토콜 스키마를 준수하는 레코드의 설명자를 채웁니다. 또한 소스에서 해당 값을 찾을 경우 레코드의 이름, 설명 및 버전을 업데이트합니다.

퍼블릭 MCP 서버에서 동기화

인증 또는 권한 부여가 필요하지 않은 퍼블릭 MCP 서버의 경우:

콘솔

예
AWS Agent Registry namespace

  1. AWS 에이전트 레지스트리 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보의 유형에서 MCP를 선택합니다. 설명자는 MCP 서버로 설정됩니다.

  5. 엔드포인트에 퍼블릭 MCP 서버 URL(예: https://knowledge-mcp.global.api.aws)을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 없음을 선택합니다.

  7. (선택 사항) 태그 섹션에서 새 태그 추가를 선택하여 레코드에 하나 이상의 태그를 연결합니다. 각 태그에는 키와 선택적 값이 있습니다.

  8. 레코드 세트 생성을 선택합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Bedrock-AgentCore 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보에서 레코드 유형으로 MCP를 선택합니다.

  5. 엔드포인트에 퍼블릭 MCP 서버 URL(예: https://knowledge-mcp.global.api.aws)을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 없음을 선택합니다.

  7. 레코드 세트 생성을 선택합니다.

레코드는 CREATING 상태로 생성됩니다. 레지스트리는 엔드포인트에 연결하고, 서버 및 도구 정의를 추출하고, 레코드의 설명자를 채웁니다. 동기화가 완료되면 레코드가 초안으로 전환됩니다. 동기화에 실패하면 레코드는 상태 이유 필드에서 사용 가능한 오류 세부 정보와 함께 CREATE_FAILED 상태로 전환됩니다. 문제 해결은 동기화 오류 기록을 참조하세요.

AWS CLI

예
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --display-name "AWS Knowledge Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "https://knowledge-mcp.global.api.aws"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "https://knowledge-mcp.global.api.aws"
    }
  }' \
  --region us-east-1

AWS SDK

예
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    displayName='AWS Knowledge Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'source': {
                'fromUrl': {
                    'url': 'https://knowledge-mcp.global.api.aws'
                }
            }
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    descriptorType='MCP',
    synchronizationType='URL',
    synchronizationConfiguration={
        'fromUrl': {
            'url': 'https://knowledge-mcp.global.api.aws'
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
참고

agent-registry 네임스페이스에서 동기화 구성은 각 설명자 내에서 로 이동합니다source( mcpServer 및 a2aAgentCard 기본 설명자에서만 지원됨). 최상위 synchronizationType/synchronizationConfiguration 필드가 더 이상 존재하지 않습니다.

레코드는 CREATING 상태로 생성됩니다. 동기화 시간은 메타데이터의 크기에 따라 초에서 분까지 다양합니다. 동기화가 완료되면 서버 및 도구 정의를 포함하여 MCP 서버에서 추출된 설명자를 사용하여 초안으로 전환됩니다.

OAuth 보호 MCP 서버에서 동기화

MCP 서버가 OAuth로 보호되는 경우 권한 부여 서버에서 M2M 클라이언트를 생성한 다음 클라이언트 ID와 보안 암호 허용 목록이 포함된 AgentCore Identity에서 자격 증명 공급자를 구성하여 MCP 서버를 호출해야 합니다. 자격 증명 공급자가 있으면 동기화를 위해 레지스트리에 제공할 수 있습니다.

콘솔

예
AWS Agent Registry namespace

  1. AWS 에이전트 레지스트리 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보의 유형에서 MCP를 선택합니다. 설명자는 MCP 서버로 설정됩니다.

  5. 엔드포인트에 OAuth 보호 MCP 서버 URL을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 OAuth를 선택합니다.

  7. 자격 증명 공급자의 경우 AgentCore 자격 증명에서 자격 증명 공급자 ARN을 선택하거나 입력합니다.

  8. (선택 사항) 추가 구성을 확장하여 구성합니다.

    1. 범위 - 액세스 토큰을 가져올 때 요청할 OAuth 범위입니다.

    2. 사용자 지정 파라미터 - OAuth 토큰 요청에 대한 추가 키-값 파라미터입니다.

  9. (선택 사항) 태그 섹션에서 새 태그 추가를 선택하여 레코드에 하나 이상의 태그를 연결합니다. 각 태그에는 키와 선택적 값이 있습니다.

  10. 레코드 세트 생성을 선택합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Bedrock-AgentCore 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보에서 레코드 유형으로 MCP를 선택합니다.

  5. 엔드포인트에 OAuth 보호 MCP 서버 URL을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 OAuth를 선택합니다.

  7. 자격 증명 공급자의 경우 AgentCore 자격 증명에서 자격 증명 공급자 ARN을 선택하거나 입력합니다.

  8. (선택 사항) 추가 구성을 확장하여 구성합니다.

    1. 범위 - 액세스 토큰을 가져올 때 요청할 OAuth 범위입니다.

    2. 사용자 지정 파라미터 - OAuth 토큰 요청에 대한 추가 키-값 파라미터입니다.

  9. 레코드 세트 생성을 선택합니다.

레코드는 CREATING 상태로 생성됩니다. 레지스트리는 OAuth 자격 증명을 사용하여 엔드포인트에 연결하고, 서버 및 도구 정의를 추출하고, 레코드의 설명자를 채웁니다. 동기화가 완료되면 레코드가 초안으로 전환됩니다. 동기화에 실패하면 레코드는 상태 이유 필드에서 사용 가능한 오류 세부 정보와 함께 CREATE_FAILED 상태로 전환됩니다. 문제 해결은 동기화 오류 기록을 참조하세요.

AWS CLI

예
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --display-name "OAuth MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_OAUTH_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "OAUTH",
              "credentialProvider": {
                "oauthCredentialProvider": {
                  "providerArn": "$OAUTH_PROVIDER_ARN",
                  "grantType": "CLIENT_CREDENTIALS"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_OAUTH_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "OAUTH",
                "credentialProvider":
                {
                    "oauthCredentialProvider":
                    {
                        "providerArn": "$OAUTH_PROVIDER_ARN",
                        "grantType": "CLIENT_CREDENTIALS"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

필요한 추가 IAM 권한:

참고

이러한 동기화 관련 IAM 권한은 AgentCore Identity에서 관리하는 워크로드 자격 증명 및 OAuth 자격 증명 공급자 리소스를 승인합니다. 이러한 리소스는 의도적으로 bedrock-agentcore 네임스페이스 아래에 유지되므로이 정책은 변경되지 않습니다.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetWorkloadAccessToken"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:*:<account>:workload-identity-directory/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetResourceOauth2Token"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>"
            ]
        }
    ]
}
참고

이 역할에 액세스 토큰이 필요한 특정 OAuth 자격 증명 공급자 ARN으로 GetResourceOauth2Token 문의 범위를 지정합니다. ARN의 공급자 세그먼트에 와일드카드를 사용하지 마세요.와 같은 패턴을 token-vault/ 사용하거나 계정의 모든 OAuth 자격 증명 공급자에 액세스 권한을 token-vault/default/oauth2credentialprovider/ 부여하여 팀 간 자격 증명 액세스를 활성화할 수 있습니다. 와 같이 Resource 필드에서 특정 공급자의 이름을 지정하여 최소 권한 원칙을 따릅니다arn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>.

제한 사항:

  • CreateRegistryRecord 또는 UpdateRegistryRecord의 호출자는 자격 증명 공급자에 대한 GetWorkloadAccessToken 레지스트리 관련 워크로드 자격 증명 및 GetResourceOauth2Token 권한이 있어야 합니다.

  • 자격 증명 공급자는 동일한 계정에서 와야 합니다.

IAM 보호 MCP 서버에서 동기화

Amazon Bedrock AgentCore 런타임 또는 Amazon Bedrock AgentCore Gateway의 MCP 서버의 경우 SigV4 서명을 위한 IAM 역할을 지정합니다. 역할에는 대상 서비스에 액세스할 수 있는 권한이 있어야 합니다. 예: AgentCore 런타임bedrock-agentcore:InvokeAgentRuntimeForUser의 bedrock-agentcore:InvokeAgentRuntime 또는 , AgentCore 게이트웨이bedrock-agentcore:InvokeGateway의 .

IAM 역할 외에도 SigV4 서명을 위한 service 필드를 지정해야 합니다. MCP가 AgentCore 런타임 또는 AgentCore 게이트웨이에서 실행되는 경우 값은 여야 합니다agent-registry. MCP가 Amazon API Gateway에서 실행되는 경우 이고execute-api, MCP가 AWS Lambda에서 실행되는 경우 이어야 합니다lambda.

region 값은 선택 사항입니다. 기본적으로 요청은 레지스트리와 동일한 리전으로 서명됩니다.

콘솔

예
AWS Agent Registry namespace

  1. AWS 에이전트 레지스트리 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보의 유형에서 MCP를 선택합니다. 설명자는 MCP 서버로 설정됩니다.

  5. 엔드포인트에 IAM 보호 MCP 서버 URL을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 IAM을 선택합니다.

  7. 역할 ARN에 SigV4 서명을 위해 수임할 IAM 역할 ARN을 입력합니다.

  8. 서비스에 SigV4 서명의 서비스 이름(예: , agent-registryexecute-api, lambda)을 입력합니다.

  9. (선택 사항) 추가 구성을 확장하고 SigV4 서명할 리전을 선택합니다. 지정하지 않으면 레지스트리의 자체 리전이 사용됩니다.

  10. (선택 사항) 태그 섹션에서 새 태그 추가를 선택하여 레코드에 하나 이상의 태그를 연결합니다. 각 태그에는 키와 선택적 값이 있습니다.

  11. 레코드 세트 생성을 선택합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Bedrock-AgentCore 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보에서 레코드 유형으로 MCP를 선택합니다.

  5. 엔드포인트에 IAM 보호 MCP 서버 URL을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 IAM을 선택합니다.

  7. 역할 ARN에 SigV4 서명을 위해 수임할 IAM 역할 ARN을 입력합니다.

  8. 서비스에 SigV4 서명의 서비스 이름(예: , bedrock-agentcoreexecute-api, lambda)을 입력합니다.

  9. (선택 사항) 추가 구성을 확장하고 SigV4 서명할 리전을 선택합니다. 지정하지 않으면 레지스트리의 자체 리전이 사용됩니다.

  10. 레코드 세트 생성을 선택합니다.

레코드는 CREATING 상태로 생성됩니다. 레지스트리는 IAM 자격 증명을 사용하여 엔드포인트에 연결하고, 서버 및 도구 정의를 추출하고, 레코드의 설명자를 채웁니다. 동기화가 완료되면 레코드가 초안으로 전환됩니다. 동기화에 실패하면 레코드는 상태 이유 필드에서 사용 가능한 오류 세부 정보와 함께 CREATE_FAILED 상태로 전환됩니다. 문제 해결은 동기화 오류 기록을 참조하세요.

AWS CLI

예
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --display-name "Gateway MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_IAM_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "IAM",
              "credentialProvider": {
                "iamCredentialProvider": {
                  "roleArn": "$IAM_ROLE_ARN",
                  "service": "$SIGNING_SERVICE",
                  "region": "$SIGNING_REGION"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_IAM_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "IAM",
                "credentialProvider":
                {
                    "iamCredentialProvider":
                    {
                        "roleArn": "$IAM_ROLE_ARN",
                        "service": "$SIGNING_SERVICE",
                        "region": "$SIGNING_REGION"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

필요한 추가 IAM 권한:

참고

이 iam:PassRole 정책은 아웃바운드 동기화를 위해 AgentCore 자격 증명에 역할을 인계할 수 있는 레지스트리 권한을 부여합니다. iam:PassedToService 조건 값은 AgentCore Identity 서비스 보안 주체를 bedrock-agentcore.amazonaws.com 나타내며 변경되지 않습니다.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "iam:PassRole"
            ],
            "Resource":
            [
                "arn:aws:iam::<account>:role/<sync-role>"
            ],
            "Condition":
            {
                "StringEquals":
                {
                    "iam:PassedToService": "bedrock-agentcore.amazonaws.com"
                }
            }
        }
    ]
}

A2A 에이전트 카드에서 동기화

를 검색할 .well-known/agent-card.json 수 있는 에이전트 카드 URL 또는 에이전트의 기본 URL을 제공합니다.

콘솔

예
AWS Agent Registry namespace

  1. AWS 에이전트 레지스트리 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보의 유형에서 에이전트를 선택합니다. 설명자는 A2A 에이전트 카드로 설정됩니다.

  5. 엔드포인트에 에이전트 카드 URL(예: https://agent.example.com/.well-known/agent-card.json)을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 적절한 권한 부여 방법을 선택합니다.

    1. 없음 - 공개적으로 액세스할 수 있는 에이전트 카드의 경우.

    2. IAM - AgentCore 런타임 또는 게이트웨이에서 호스팅되는 에이전트의 경우. 역할 ARN 및 서비스 이름을 입력합니다.

    3. OAuth - OAuth 보호 에이전트의 경우. 자격 증명 공급자 ARN을 선택하거나 입력합니다.

  7. (선택 사항) 태그 섹션에서 새 태그 추가를 선택하여 레코드에 하나 이상의 태그를 연결합니다. 각 태그에는 키와 선택적 값이 있습니다.

  8. 레코드 세트 생성을 선택합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Bedrock-AgentCore 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 엔드포인트에서 동기화를 선택합니다.

  4. 레코드 세부 정보에서 에이전트를 레코드 유형으로 선택합니다.

  5. 엔드포인트에 에이전트 카드 URL(예: https://agent.example.com/.well-known/agent-card.json)을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  6. 자격 증명 유형에서 적절한 권한 부여 방법을 선택합니다.

    1. 없음 - 공개적으로 액세스할 수 있는 에이전트 카드의 경우.

    2. IAM - AgentCore 런타임 또는 게이트웨이에서 호스팅되는 에이전트의 경우. 역할 ARN 및 서비스 이름을 입력합니다.

    3. OAuth - OAuth 보호 에이전트의 경우. 자격 증명 공급자 ARN을 선택하거나 입력합니다.

  7. 레코드 세트 생성을 선택합니다.

레코드는 CREATING 상태로 생성됩니다. 레지스트리는 엔드포인트에 연결하고, 에이전트 카드 메타데이터를 추출하고, 레코드의 설명자를 채웁니다. 동기화가 완료되면 레코드가 초안으로 전환됩니다. 동기화에 실패하면 레코드는 상태 이유 필드에서 사용 가능한 오류 세부 정보와 함께 CREATE_FAILED 상태로 전환됩니다. 문제 해결은 동기화 오류 기록을 참조하세요.

AWS CLI

예
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --display-name "Travel Agent" \
  --record-type AGENT \
  --descriptors '{
    "a2aAgentCard": {
      "source": {
        "fromUrl": {
          "url": "https://agent.example.com/.well-known/agent-card.json"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration '{"fromUrl": {"url": "https://agent.example.com/.well-known/agent-card.json"}}' \
  --region us-east-1

A2A 동기화를 위한 자격 증명 공급자를 지정할 수도 있습니다. 예를 들어 AgentCore에서 호스팅되는 에이전트에서 동기화할 수 있습니다. 동기화 대상이 AgentCore 런타임 또는 게이트웨이에서 호스팅되는 에이전트인 경우를 service 필드agent-registry로 사용합니다.

예
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --display-name "A2A Agent Record" \
  --record-type AGENT \
  --descriptors "{
    \"a2aAgentCard\": {
      \"source\": {
        \"fromUrl\": {
          \"url\": \"$A2A_URL\",
          \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
              \"iamCredentialProvider\": {
                \"roleArn\": \"$IAM_INVOKER_ROLE\",
                \"service\": \"agent-registry\"
              }
            }
          }]
        }
      }
    }
  }"
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration "{
    \"fromUrl\": {
        \"url\": \"$A2A_URL\",
        \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
                \"iamCredentialProvider\": {
                    \"roleArn\": \"$IAM_INVOKER_ROLE\",
                    \"service\": \"bedrock-agentcore\"
                }
            }
        }]
    }
  }"

기존 레코드에서 동기화 트리거

콘솔

  1. 동기화가 구성된 MCP 또는 에이전트 레코드의 레코드 세부 정보 페이지를 엽니다.

예
AWS Agent Registry namespace

  1. AWS 에이전트 레지스트리 콘솔의 레코드 세부 정보 페이지에서 관리를 선택한 다음 동기화를 선택합니다.

  2. 확인 대화 상자에서 동기화가 레코드를 초안 상태로 되돌린다는 메시지를 검토합니다.

  3. 동기화를 선택하여 확인합니다.

또는 편집 중에 동기화를 트리거할 수 있습니다.

  1. 레코드 세부 정보 페이지에서 관리를 선택한 다음 편집을 선택합니다.

  2. 엔드포인트에서 동기화에서 엔드포인트에서 재동기화 확인란을 선택합니다.

  3. 변경 사항 저장을 선택합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Bedrock-AgentCore 콘솔의 레코드 세부 정보 페이지에서 헤더 작업의 동기화 버튼을 선택합니다.

  2. 확인 대화 상자에서 동기화가 레코드를 초안 상태로 되돌린다는 메시지를 검토합니다.

  3. 동기화를 선택하여 확인합니다.

또는 편집 중에 동기화를 트리거할 수 있습니다.

  1. 레코드 세부 정보 페이지에서 점 3개 메뉴(")를 선택한 다음 편집을 선택합니다.

  2. 엔드포인트에서 동기화에서 엔드포인트에서 다시 동기화 확인란을 선택합니다.

  3. 변경 사항 저장을 선택합니다.

레코드는 동기화 중에 업데이트 중 상태로 전환됩니다. 완료되면 소스의 업데이트된 설명자와 함께 초안으로 돌아갑니다. 동기화에 실패하면 레코드가 상태 이유 필드에서 사용 가능한 오류 세부 정보와 함께 UPDATE_FAILED 상태로 전환됩니다. 문제 해결은 동기화 오류 기록을 참조하세요.

AWS CLI

예
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --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>',
    triggerSynchronization=True
)
print(f"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>',
    triggerSynchronization=True
)
print(f"Status: {response['status']}")
참고

레코드가 초안이 아닌 상태(예: APPROVED)인 경우 업데이트가 새 초안 개정을 생성합니다. 승인된 개정은 검색 가능한 상태로 유지됩니다.

문제 해결: 동기화 오류 기록을 참조하세요.