기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # AI 에이전트 제품 ## AI 에이전트 제품이란 무엇인가요? AI 에이전트는 인공 지능을 활용하여 인간 또는 시스템을 대신하여 작업을 추론, 계획 및 완료하는 소프트웨어 시스템입니다. 고정된 규칙을 따르는 기존 소프트웨어와 달리 AI 에이전트는 독립적으로 운영되며 다단계 프로세스를 거쳐 적응하여 특정 목표를 달성합니다. AI 에이전트는 추론 및 계획을 위한 파운데이션 모델을 별도의 에이전트 도구(예: 가드레일, 지식 기반, 비즈니스 로직)와 결합하여 요청을 처리하고, 정보를 검색하고, 작업을 실행합니다. 지식 기반을 검색하고, API를 직접 호출하고, 시스템을 업데이트하고, 사용자 요구 사항 및 환경 컨텍스트에 따라 결정을 내릴 수 있습니다. 에이전트 도구는 다음을 포함하여 AI 에이전트 기능을 개선하는 특수 구성 요소입니다. + 도메인별 정보를 위한 지식 기반 + 안전 및 규정 준수를 위한 가드레일 + AWS MCP 서버 (MCP)와 같은 통합 프로토콜 + 전문 API 및 마이크로서비스 + 비즈니스 로직 구성 요소 및 워크플로 ## 에 적합한 AI 에이전트 및 도구 유형 AWS Marketplace AWS Marketplace 는 다양한 산업 및 사용 사례에서 다양한 AI 에이전트와 도구를 지원합니다. 일반적인 유형은 다음과 같지만 이 목록이 전체 목록은 아닙니다. **콘텐츠 생성 에이전트** 텍스트, 이미지, 비디오 및 멀티미디어를 포함하여 콘텐츠를 생성, 편집 또는 최적화하는 에이전트입니다. 글쓰기 어시스턴트, 소셜 미디어 콘텐츠 생성기, 마케팅 자동화 에이전트 등을 예로 들 수 있습니다. **데이터 분석 에이전트** 데이터에서 인사이트를 처리, 분석 및 도출하는 에이전트입니다. 비즈니스 인텔리전스 에이전트, 재무 분석 도구 및 예측 분석 시스템을 예로 들 수 있습니다. **고객 서비스 에이전트** 고객 상호 작용, 지원 요청 및 서비스 자동화를 처리하는 에이전트입니다. 예로는 챗봇, 티켓 라우팅 시스템 및 고객 경험 최적화 도구가 있습니다. **비즈니스 프로세스 자동화 에이전트** 복잡한 비즈니스 워크플로 및 프로세스를 자동화하는 에이전트입니다. 예를 들어 문서 처리 에이전트, 승인 워크플로 시스템 및 규정 준수 자동화 도구가 있습니다. **보안 및 규정 준수 에이전트** 보안 위협 또는 규정 준수 요구 사항을 모니터링, 탐지 및 대응하는 에이전트입니다. 위협 탐지 시스템, 감사 자동화 도구 및 위험 평가 에이전트를 예로 들 수 있습니다. **개발자 도구 에이전트** 소프트웨어 개발, 테스트 및 배포를 지원하는 에이전트입니다. 코드 생성 어시스턴트, 테스트 자동화 에이전트 및 배포 최적화 도구를 예로 들 수 있습니다. **에이전트 도구** 지식 기반, 가드레일 및 AWS MCP 서버 (MCP)와 같은 통합 프로토콜을 포함하여 다른 AI 에이전트를 개선하는 특수 구성 요소입니다. ## AI 에이전트 제품의 배포 옵션 AWS Marketplace 는 AI 에이전트를 위한 여러 배포 옵션을 지원하므로 아키텍처 및 고객 요구 사항에 가장 적합한 접근 방식을 선택할 수 있습니다. + **API 배포 옵션** - API 배포 옵션을 사용하면 고객이 공급업체 호스팅 엔드포인트를 통해 판매자의 AI 에이전트에 액세스할 수 있습니다. 이 옵션은 특수 인프라 또는 자체 환경에서 유지하려는 독점 모델이 필요한 에이전트 및 에이전트 도구에 적합합니다. + **컨테이너 배포** - AI 에이전트와 에이전트 도구를 고객이 자체 AWS 환경에서 실행할 수 있는 컨테이너화된 애플리케이션으로 패키징합니다. 이 옵션을 사용하면 고객에게 데이터와 인프라에 대한 더 큰 제어 권한을 제공합니다. ## 올바른 배포 옵션 선택 AI 에이전트 또는 도구에 대한 배포 옵션을 선택할 때는 다음 요소를 고려하세요. + **데이터 민감도** - 고객이 환경에서 반출될 수 없는 매우 민감한 데이터로 작업하는 경우, 컨테이너 배포가 최선의 옵션일 수 있습니다. + **모델 복잡성** - 특수 하드웨어가 필요한 대규모 또는 복잡한 모델의 경우, API 배포가 더 실용적일 수 있습니다. + **운영 오버헤드** - 다양한 배포 모델에서 솔루션을 유지 관리하고 업데이트하는 데 필요한 리소스를 고려합니다. 다음은 배포 옵션 간의 간단한 기능 비교입니다. | 기능 | API 배포 | 컨테이너 배포 | | --- | --- | --- | | 호스팅 | 공급업체 호스팅 엔드포인트 | 고객의 자체 AWS 환경 | | 데이터 제어 | 공급업체 서버에서 처리된 데이터 | 데이터에 대한 고객의 제어 권한 강화 | | 인프라 요구 사항 | 최소화 - 공급업체 인프라 사용 | 고객이 인프라를 관리해야 함 | | 확장성 | 공급업체에서 관리 | 고객이 제어하고 잠재적으로 더 유연함 | | 사용자 지정 | 제한적 - API 기능 기반 | 높음 - 환경에 대한 전체 제어 | | 정비 | 공급업체에서 처리 | 고객이 담당하는 업데이트 및 유지 관리 | | 보안 | 공급업체의 보안 조치에 따라 다름 | 고객 요구 사항에 따라 사용자 지정 가능한 보안 | | 업데이트 및 개선 사항 | 공급업체에서 자동으로 제공 | 수동 업데이트가 필요하지만 고객의 일정에 따라 진행 | | 규제 준수 | 공급업체의 인증에 따라 제한될 수 있음 | 특정 규제 요구 사항에 더 쉽게 적응 | # SaaS API 기반 AI 에이전트 제품 등록 AWS Marketplace 판매자는 서비스형 소프트웨어(SaaS) API 기반 AI 에이전트 또는 도구 제품을에 추가할 수 있습니다 AWS Marketplace. 여기에는 제품을 생성하고 결제 모델에 따라 적절한 AWS Marketplace API 작업과 통합하는 작업이 포함됩니다. 에서 SaaS API 기반 AI 에이전트 또는 도구 제품으로 소프트웨어를 판매하려면 다음 단계를 AWS Marketplace따르세요. + 에서 SaaS API 기반 AI 에이전트 또는 도구 제품을 생성합니다 AWS Marketplace. + 요금 모델에 AWS Marketplace 따라 제품을와 통합합니다. + 구독 기반 제품에 대한 자세한 내용은 [SaaS 구독 또는 Pay-As-You-Go 제품을와 통합 AWS Marketplace](saas-integrate-subscription.md) 섹션을 참조하세요. + 컨테이너 기반 제품에 대한 자세한 내용은 [SaaS 계약 제품을와 통합 AWS Marketplace](saas-integrate-contract.md) 섹션을 참조하세요. + 종량제 제품과의 계약에 대한 자세한 내용은 [SaaS 계약 기반 제품을와 통합 AWS Marketplace](saas-integrate-contract-with-pay.md) 섹션을 참조하세요. + 제품 통합을 테스트합니다. + 구독 기반 제품 테스트에 대한 자세한 내용은 [SaaS 구독 제품 통합 테스트](saas-integrate-subscription.md#saas-subscription-integration-testing) 섹션을 참조하세요. + 계약 기반 제품 테스트에 대한 자세한 내용은 [SaaS 계약 제품 통합 테스트](saas-integrate-contract.md#saas-contract-integration-testing) 섹션을 참조하세요. + 종량제 제품과의 계약 테스트에 대한 자세한 내용은 [SaaS 계약과 종량제 제품의 통합 테스트](saas-integrate-contract-with-pay.md#saas-contract-consumption-integration-testing) 섹션을 참조하세요. + 출시할 제품을 제출합니다. ## 사전 조건 시작하기 전에 다음이 있는지 확인합니다. + AI 에이전트 기능 및 대상 사용 사례에 대한 명확한 이해 + 적절한 보안 조치 및 규정 준수 인증 + 통합 및 배포를 위한 기술 설명서 + 비즈니스 모델에 맞는 요금 전략 + 요금 전략에 대한 자세한 내용은 [의 SaaS 제품 요금 AWS Marketplace](saas-pricing-models.md) 섹션을 참조하세요. ## SaaS API 기반 AI 에이전트 및 도구 관리 모든 SaaS API 기반 AI 에이전트 및 도구는 통합 **AI 에이전트 및 도구** 제품 페이지 또는 AWS Marketplace 관리 콘솔의 **SaaS** 제품 페이지를 통해 관리할 수 있습니다. ## 리스팅 마법사 시작 1. [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/)에 로그인합니다. 1. 탐색 모음에서 **제품**을 선택한 다음 **AI 에이전트 및 도구**를 선택합니다. 1. **AI 에이전트 및 도구 제품 생성** 메뉴에서 **API 기반 AI 에이전트 및 도구**를 선택합니다. 1. 제품 제목을 입력합니다. 1. **제품 ID 및 제품 코드 생성**을 선택합니다. 1. (선택 사항) 태그 기반 권한 부여를 지원하는 선택적 태그를 추가할 수도 있습니다. 1. **마법사로 계속**을 선택합니다. **참고** 태그 기반 권한 부여에 대한 자세한 내용은 AWS Identity and Access Management 사용 설명서의 [태그를 사용한 AWS 리소스 액세스 제어](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)를 참조하세요. ## 1단계: 제품 정보 제공 이 단계에서 제공하는 정보는 제품의 가치 제안을 전달합니다. 1. 제품 정보 탭에 대한 세부 정보를 제공합니다. + **제품 제목** + **SKU**(선택 사항) + **제품 로고 S3 URL** + **간단한 설명** + **자세한 설명** + **제품 비디오 URL**(선택 사항) + **주요 내용**(1\$13) 1. 지원 세부 정보를 입력하고 **리소스 추가**를 선택하여 선택적 학습 리소스를 추가합니다. 1. **제품 범주** 메뉴에서 1\$13개의 범주를 선택합니다. + **AI 에이전트 및 도구** 비즈니스 범주에서 하나 이상의 범주를 선택하는 것이 좋습니다. 1. 키워드를 입력하여 검색 시 발견 가능성을 개선합니다. 1. (선택 사항) 지침에 따라 비디오 및 이미지 자산을 추가합니다. 1. **다음**을 선택합니다. ## 2단계: 이행 옵션 구성 1. 이행 방법을 선택합니다. + **빠른 시작**(권장) - 판매자는 [AWS Marketplace 배포 API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Operations_AWS_Marketplace_Deployment_Service.html)와 통합하고 구독 시 고객의 AWS 계정에 직접 API 키를 제공합니다. + **웹 사이트로 리디렉션** - 고객은 API 키 또는 OAuth 토큰을 얻기 위해 웹 사이트로 리디렉션됩니다. **참고** 제품을 게시한 후에는 이행 방법을 변경할 수 없습니다. 1. 이행 URL을 입력합니다. 사용자가 로그인하거나 계정을 생성하는 URL입니다. 1. AI 에이전트 또는 도구 세부 정보를 선택합니다. + **AI 에이전트** - AI를 사용하여 요청을 처리하고 추론 및 의사 결정을 통해 작업을 완료하는 소프트웨어입니다. + **AI 도구**: + **MCP 서버** - AI 모델과 애플리케이션 간의 통신 및 컨텍스트 교환을 관리하는 서버입니다. + **지식 기반** - AI 에이전트가 결정 및 응답을 알리는 데 사용하는 구조화된 정보 모음입니다. + **가드레일** - AI 에이전트 동작 및 작업의 경계를 정의하는 규칙 및 제어입니다. + **기타** - AI 에이전트 기능을 개선하는 추가 도구입니다. 1. 엔드포인트 URL을 입력합니다. API가 요청을 수신하는 URL입니다. MCP 서버의 경우 MCP 엔드포인트를 나열합니다. 1. 사용 지침을 추가합니다. + 구매자가 API 스키마, 속도 제한 및 사용 예제와 같이 API를 사용할 수 있도록 자세한 지침을 제공합니다. + 설명서에 대한 추가 링크를 제공할 수도 있습니다. 1. 인증 방법을 선택합니다. + **API 키** - 고객이 판매자가 제공하는 API 키를 사용하여 인증합니다. + **OAuth** - 고객이 OAuth 2.0 인증 흐름을 사용하여 인증합니다. OAuth를 선택하는 경우, 다음을 포함하여 고객에게 명확한 사용 지침을 제공합니다. + OAuth 인증 URL 및 토큰 엔드포인트 + 필요한 범위 및 권한 + 단계별 인증 흐름 지침 + 적절한 인증 헤더가 있는 API 직접 호출 예제 + 일반적인 인증 문제 해결 1. (선택 사항) Amazon Bedrock AgentCore 통합 + 2각 OAuth 인증을 지원하는 MCP 서버를 나열하는 경우 MCP 서버 엔드포인트를 대상으로 사용하여 Amazon Bedrock AgentCore Gateway와의 통합을 활성화할 수 있습니다. 자세한 내용은 [MCP 서버 대상](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-MCPservers.html)을 참조하세요. 이 경우 OpenAPI 사양은 필요하지 않습니다. + API 키 인증을 사용하여 다른 API 기반 제품 또는 MCP 서버를 나열하는 경우, OpenAPI 사양을 제공하여 Amazon Bedrock AgentCore와의 통합을 활성화할 수 있습니다. + AgentCore의 AI 에이전트 배포 및 규모 조정 기능에 대한 자세한 내용은 [Amazon Bedrock AgentCore란 무엇인가요?](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html)를 참조하세요. 1. (선택 사항) - API 통합 프로토콜을 선택하고 사용 지침을 제공합니다. + **MCP** - Model Context Protocol(MCP)은 향상된 기능을 위해 외부 도구, 데이터 및 서비스에 대한 액세스를 표준화합니다. + **A2A** - Agent2Agent(A2A)를 사용하면 다양한 플랫폼에서 직접 통신 및 작업 위임을 수행할 수 있습니다. 1. AI 에이전트 도구 유형을 선택한 경우 에이전트가 추론 LLM을 사용하고 자율 기능을 보여주는지 확인합니다. 이러한 요구 사항은 AWS Marketplace에서 제공되는 에이전트가 높은 품질 기준을 충족하는 데 도움이 됩니다. 에이전트가 두 요구 사항을 모두 충족하지 않는 경우 다른 도구 유형을 선택합니다. ## 3단계: 제품 요금 구성 제품을 사용할 수 있도록 하려면 요금 모델을 AWS Marketplace결정하고 제품의 요금 차원을 정의합니다. 사용 가능한 요금 옵션에 대한 자세한 내용은 [의 SaaS 제품 요금 AWS Marketplace](saas-pricing-models.md) 섹션을 참조하세요. 각 차원은 단위당 가격을 설정할 수 있는 제품의 기능, 서비스 또는 기타 측면입니다. 1. 요금 모델을 선택합니다. 1. **다음**을 선택합니다. ## 4단계: 가격 검토 1. 제품 요금을 검토합니다. 1. **다음**을 선택합니다. **참고** 테스트 목적으로 가격이 0.001 USD 또는 0.00000001 USD로 설정됩니다. 지금은 가격을 변경할 필요가 없습니다. 이를 통해 팀과 AWS Marketplace 판매자 운영 팀 모두 할인된 가격으로 제품을 테스트할 수 있으며 테스트 비용이 많이 들지 않습니다. 제품이 공개되도록 제품 가시성을 요청할 때 실제 요금을 제공합니다. ## 5단계: 환불 정책 지정 1. 제품에 대한 환불 정책을 입력합니다. 1. **다음**을 선택합니다. ## 6단계: 최종 사용자 라이선스 계약(EULA) 구성 1. ** AWS Marketplace표준 계약**을 선택하거나 **사용자 지정 EULA**에 S3 URL을 제공합니다. + 표준 계약 사용에 대한 자세한 내용은 [AWS Marketplace의 표준 계약 사용](standardized-license-terms.md) 섹션을 참조하세요. 1. **다음**을 선택합니다. ## 7단계: 제안 가용성 구성 기본적으로에 나열된 제품은 AWS AWS Marketplace 가 지원하는 모든 국가에서 구매할 수 있습니다. 구매자가 제품을 구매할 수 있거나 구매할 수 없는 국가를 식별하여 국가별 가용성을 활성화할 수 있습니다. 1. 국가별 제안 가용성을 선택합니다. 1. **다음**을 선택합니다. ## (선택 사항) 8단계: 허용 목록 구성 제한된 가시성으로 AWS Marketplace 시작하도록 게시된 모든 신제품 목록입니다. 일부 AWS 계정 ID를 허용 목록에 추가하여 제품의 제한된 버전을 포함해 제한된 제품에 액세스할 수 있는 계정을 제어할 수 있습니다. 허용 목록에 AWS 계정을 추가하려면: 1. 허용 목록에 추가해야 하는 쉼표로 구분된 AWS 계정 ID를 입력합니다. 1. **제출**을 선택합니다. **참고** 테스트 목적으로 허용 목록에 테스트 계정만 추가합니다. ## 에서 SaaS API 기반 AI 에이전트 제품 설정 수정 AWS Marketplace 에서 **SaaS API 기반 에이전트 및 도구 제품을** 생성한 후 많은 제품 설정을 수정할 AWS Marketplace수 있습니다. 변경 요청 제출 및 제품 설정 수정에 대한 자세한 내용은 다음 주제를 참조하세요. ### 제품 변경 및 요청 + 변경 요청 관리에 대한 자세한 내용은 [변경 요청 관리](saas-product-settings.md#create-change-request) 섹션을 참조하세요. + 제품 업데이트에 대한 자세한 내용은 [제품 정보 업데이트](saas-product-settings.md#update-product-information)섹션을 참조하세요. + 아키텍처 업데이트에 대한 자세한 내용은 [아키텍처 세부 정보 업데이트](saas-product-settings.md#updating-architecture-details) 섹션을 참조하세요. ### 액세스 및 가시성 + 허용 목록 업데이트에 대한 자세한 내용은 [AWS 계정 IDs의 허용 목록 업데이트](saas-product-settings.md#update-allowlist) 섹션을 참조하세요. + 제품 가시성 변경에 대한 자세한 내용은 [제품 표시 여부 업데이트](saas-product-settings.md#saas-update-visibility) 섹션을 참조하세요. + 구매자 액세스 관리에 대한 자세한 정보는 [요금 조건 업데이트](saas-product-settings.md#saas-update-pricing-terms)섹션을 참조하세요. + 국가 가용성에 대한 자세한 내용은 [국가별 가용성 업데이트](saas-product-settings.md#saas-availability-by-country) 섹션을 참조하세요. ### 요금 및 약관 + 요금 조건 업데이트에 대한 자세한 내용은 [요금 조건 업데이트](saas-product-settings.md#saas-update-pricing-terms) 섹션을 참조하세요. + 요금 차원 추가에 대한 자세한 내용은 [요금 차원 추가](saas-product-settings.md#saas-add-pricing-dimensions) 섹션을 참조하세요. + 요금 차원 업데이트에 대한 자세한 내용은 [요금 차원 업데이트](saas-product-settings.md#saas-update-dimension) 섹션을 참조하세요. + 요금 차원 제한에 대한 자세한 내용은 [요금 차원 제한](saas-product-settings.md#restrict-pricing-dimensions) 섹션을 참조하세요. ### 법률 및 라이선스 + 환불 정책 업데이트에 대한 자세한 내용은 [제품의 환불 정책 업데이트](saas-product-settings.md#update-refund-policy) 섹션을 참조하세요. + EULA 업데이트에 대한 자세한 내용은 [최종 사용자 라이선스 계약(EULA) 업데이트](saas-product-settings.md#saas-update-eula) 섹션을 참조하세요. ### 무료 제품을 제공하려면 제품의 가시성이 제한된 경우: + 가시성을 제한 상태에서 공개로 변경하는 요청을 제출합니다. + 모든 요금 차원에 0 USD를 입력합니다. 제품이 이미 공개 상태인 경우: + **요금 조건 업데이트** 변경 요청을 제출합니다. + 모든 요금 차원에 0 USD를 입력합니다. **참고** 제품을 무료로 설정한 후에는 유료 제품으로 변환할 수 없습니다. # API 기반 AI 에이전트 제품 통합 ## API 기반 AI 에이전트 제품 지침 AWS Marketplace 는 모든 서비스형 소프트웨어(SaaS) API 기반 AI 에이전트 제품에 대한 지침을 제공합니다. 이러한 지침은 고객에게 안전하고 신뢰할 수 있는 환경을 보장합니다. **Topics** + [제품 검토 프로세스](#product-review-process) + [규정 준수 유지](#maintaining-compliance) ### 제품 검토 프로세스 제품을 제출하면는 제품 및 메타데이터를 AWS Marketplace 검토하여 현재 지침을 충족하는지 확인합니다. 진화하는 보안 요구 사항을 해결하기 위해 이러한 지침은 정기적으로 업데이트됩니다. ### 규정 준수 유지 AWS Marketplace 는 제품을 지속적으로 모니터링하여 규정 준수를 확인합니다. 제품이 현재 지침을 충족하지 않는 경우: + 문제를 해결할 때까지 새 구독자가 제품을 사용하지 못할 수 있습니다. + 새 요구 사항을 충족하도록 제품을 업데이트해야 합니다. | 카테고리 | 지침 | | --- | --- | | API 및 에이전트 기능 | 모든 API가 작동하고 적절하게 응답해야 합니다. 에이전트를 등록하는 경우, 솔루션은 명시적 외부 명령이나 일정한 인적 입력 없이 작동하여 자율 기능을 입증해야 합니다. | | API 액세스 및 인증 | 고객은 목록을 구독하고 API 키를 검색하거나, 단계를 따라서 OAuth 토큰을 생성할 수 있어야 합니다. | | 아키텍처 가이드라인 | [자세한 내용은 아키텍처 지침을 따르세요.](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html#saas-architecture) | | 고객 정보 요구 사항 | [자세한 내용은 고객 정보 요구 사항을 따르세요.](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html#saas-customer-information) | | 키 관리 | 공급업체는 고객에게 키를 무효화/교체할 수 있는 기능을 제공해야 합니다. 또한 공급업체에게는 고객이 목록에서 구독을 취소하면 키를 무효화하는 메커니즘이 있어야 합니다. | | MCP 서버 요구 사항(해당하는 경우) | MCP 서버의 경우, 공급업체는 설정을 위한 사전 조건 또는 환경 변수와 함께 원격 MCP 구성 세부 정보를 제공해야 합니다. | | 제품 설정 | [자세한 내용은 제품 설정 지침을 따르세요.](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html#saas-guidelines-setup) | | 제품 사용 | [자세한 내용은 제품 사용 지침을 따르세요.](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html#saas-product-usage) | | 사용 지침 | 사용 지침에는 사전 조건, 인증 설정, 지원되는 엔드포인트, 요청/응답 스키마, 도구 설명, 오류 코드 및 추가 리소스가 명확하게 명시되어야 합니다. | ## API 기반 AI 에이전트 제품 통합 ### 제품 요금에 따른 통합 제품을와 통합하는 AWS Marketplace 것은 API 기반 AI 에이전트 제품을 나열하는 한 단계입니다. API 기반 AI 에이전트 제품을와 통합하려면 코드를 작성하고 여러 고객 시나리오에 성공적으로 대응할 수 있음을 입증해야 AWS Marketplace합니다. 다양한 요금 모델을 기반으로 제품을 통합하는 방법에 대한 자세한 내용은 다음 주제를 참조하세요. + 구독 기반 제품에 대한 자세한 내용은 [SaaS 구독 또는 Pay-As-You-Go 제품을와 통합 AWS Marketplace](saas-integrate-subscription.md) 섹션을 참조하세요. + 컨테이너 기반 제품에 대한 자세한 내용은 [SaaS 계약 제품을와 통합 AWS Marketplace](saas-integrate-contract.md) 섹션을 참조하세요. + 종량제 제품과의 계약에 대한 자세한 내용은 [SaaS 계약 기반 제품을와 통합 AWS Marketplace](saas-integrate-contract-with-pay.md) 섹션을 참조하세요. ### 고객 온보딩 #### 웹 사이트로 리디렉션 이행 고객이를 통해 제품을 구독하면 AWS 환경에서 제품에 AWS Marketplace액세스합니다. 구독한 후, 고객은 계정을 등록하고 제품을 구성하기 위해 판매자의 웹 사이트로 전송됩니다. + [를 통해 SaaS 제품에 고객 온보딩 AWS Marketplace](saas-product-customer-setup.md)에서 웹 사이트로 리디렉션 이행을 사용하여 고객을 온보딩하는 방법에 대해 알아봅니다. #### QuickLaunch 이행 고객이를 통해 제품을 구독하면 API 키 또는 OAuth 자격 증명을 AWS Marketplace수신하여 API 엔드포인트 또는 MCP 서버를 호출합니다. 이 프로세스는 다음과 같이 작동합니다. + 고객이 제품을 구독합니다. + 고객이 웹 사이트에 가입하거나 계정으로 로그인합니다. + **PutDeploymentParameter** API를 사용하여 API 키 또는 OAuth 자격 증명을 고객의 AWS Secrets Manager에 저장합니다. + API 키의 경우에 파라미터 하나를 저장하면, 문자열인 `secretString` 파라미터가 `PutDeploymentParameter` API를 직접 호출합니다. OAuth 자격 증명의 경우에 파라미터를 두 개 이상 저장하면, 아래와 같이 `secretString` 파라미터에 키-값 페어가 포함된 JSON 문자열을 제공합니다. ``` { "Client Id": "12345", "Client Secret": "12345", "Discovery URL" : "https://auth.example.com/.well-known/openid-configuration" } ``` 다음 리소스에서 QuickLaunch 이행에 대해 자세히 알아보세요. + [AWS Marketplace 배포 API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Operations_AWS_Marketplace_Deployment_Service.html)의 **PutDeploymentParameter** API에 대해 자세히 알아봅니다. + [를 통해 SaaS 제품에 고객 온보딩 AWS Marketplace](saas-product-customer-setup.md)에서 고객 온보딩 지침을 찾습니다. ### AWS Marketplace APIs 액세스 다음 섹션에서는 제품의 고객 사용에 대한 결제 및 보고가 정확한지 확인하는 데 사용되는 AWS Marketplace 측정 서비스 또는 AWS Marketplace 권한 부여 서비스와 통합하는 프로세스를 간략하게 설명합니다. + AWS Marketplace APIs[AWS Marketplace 측정 및 권한 부여 서비스 APIs에 액세스](saas-integration-metering-and-entitlement-apis.md). ### SNS 알림 Amazon Simple Notification Service(Amazon SNS) 주제를 구독하여 제품의 고객 구독 변경 및 계약 권한에 대한 알림을 받습니다.는 제품 생성 중에 이러한 주제를 AWS Marketplace 제공하여 고객 액세스를 관리하는 데 도움이 됩니다. 다음은 SaaS API 기반 제품에 사용할 수 있는 Amazon SNS 주제입니다. + [Amazon SNS 주제: `aws-mp-entitlement-notification`](saas-notification.md#saas-sns-message-body) - 고객이 계약을 생성, 업그레이드 또는 갱신하거나 계약이 만료될 때 알려줍니다. 이는 계약이 포함된 요금 모델이 있는 제품에만 사용할 수 있습니다. + [Amazon SNS 주제: `aws-mp-subscription-notification`](saas-notification.md#saas-sns-subscription-message-body) - 구매자가 제품을 구독하거나 구독 해지할 때 알림을 제공하며, 비공개 제안의 `offer-identifier` 및 SaaS 무료 평가판의 무료 평가판 플래그를 포함하고 있습니다. 계약 및 구독을 포함한 모든 요금 모델에 사용할 수 있습니다. ## 사용 지침 템플릿 ### MCP 서버 사용 지침 템플릿 다음 예제에서는 도구 설명, 사전 조건, 인증 설정, 인기 있는 클라이언트에 대한 구성, 속도 제한 및 추가 리소스를 포함하여 MCP 서버의 사용 지침을 보여줍니다. ``` To get started using the remove MCP server, follow the instructions below: **Availble Tools** This MCP server support the following tools: - Search - Performs a web search - Summarize Website - Summarizes a webpage **Prerequisites** - Install **Node.js** and **npm** **Authentication** Replace `YOUR_API_KEY` with your actual key below. **Claude Desktop** Edit the configuration file at: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json Add the below code: ``` { "mcpServers": { "demo-example": { "command": "npx", "args": [ "mcp-remote", "https://remote.mcp.server/sse", "--header", "Authorization: Bearer " ] }, } } ``` **Cline** Cline stores MCP server configurations in a JSON file that can be modified. In the "Installed" tab, click "Configure MCP Servers" to access the settings file. Add the following: ``` { "mcpServers": { "demoServer": { "url": "https://remote.mcp.server/sse", "disabled": false, "autoApprove": ["searchWeb", "summarizeWebsite"], "timeout": 30 } } } ``` **Rate Limits** - 60 requests per minute per API key. - Exceeding returns HTTP 429 Too Many Requests. - Use retry and exponential backoff to handle limits. **Learn More** MCP Docs: https://mcp.search.demoproduct.com ``` ### AI 에이전트와 에이전트 및 도구 사용 지침 템플릿 다음 예제에서는 사전 조건, 인증 설정, 지원되는 엔드포인트, 요청/응답 스키마, 오류 코드 및 추가 리소스를 포함한 에이전트 또는 에이전트 도구의 사용 지침을 보여줍니다. ``` To get started follow the instructions below: **Authentication** All API requests require this HTTP header: Authorization: Bearer `YOUR_API_KEY` Replace `YOUR_API_KEY` with your actual key. **Search Endpoint** **Endpoint:** `GET /web/search` Performs a web search. **Query Parameters:** | Param | Type | Description | |------------|--------|-------------------------------------| | `q` | string | Your search query (required) | | `count` | int | Number of results (default: 10) | | `offset` | int | Offset for pagination | | `country` | string | Country code (e.g. `us`, `de`) | | `safesearch` | string | `off`, `moderate`, or `strict` | **Example Request:** ```bash curl -X GET "https://api.search.demo.com/res/v1/web/search?q=searchtool" \ -H "Authorization: Bearer YOUR_API_KEY" ``` **Response Schema:** ``` { "results": [{ "title": "string", "url": "string", "description": "string" }], "query" :"string", "total" :"number" } ``` **Example Response:** ``` { "results": [ { "title": "DemoProductAPI", "url": "https://demo.com", "description": "Demo Product API is a search tool for..." } ], "query": "searchtool", "total": 1 } ``` **Additional Search Types** DemoProduct also supports: - `GET /news/search – News articles` - `GET /images/search – Image results` - `GET /videos/search – Video results` These endpoints follow the same format as /web/search. **Summarize Endpoint** **Endpoint:** `POST /summarize` Summarizes a webpage **Request Headers:** Content Type: application/json **Request Body:** ``` { "input": "string" // URL or plain text } ``` **Example Request:** ``` { "input": "https://example.com/article" } ``` **Response Schema** ``` { "summary": "string" } ``` **Example Response** ``` { "summary": "This article explains our commitment to user privacy." } ``` **Error Codes** | Status | Meaning | | ------ | ------------------------------ | | `401` | Unauthorized (check your key) | | `429` | Too many requests (rate limit) | | `500` | Server error | All error responses follow this structure: ``` { "error": { "code": 401, "message": "Unauthorized" } } ``` **Rate Limits** - 60 requests per minute per API key. - Exceeding returns HTTP 429 Too Many Requests. - Use retry and exponential backoff to handle limits. **Learn More** API Docs: https://api.search.demoproduct.com ``` # Amazon Bedrock AgentCore Gateway 이 문서는 Amazon Bedrock AgentCore Gateway와 통합할 수 있는 API 기반 AI 에이전트 제품 또는 도구를 나열하려는 AWS Marketplace 판매자를 위한 정보를 제공합니다. **Topics** + [개요](#agentcore-overview) + [Bedrock AgentCore Gateway와 통합](#bedrock-agentcore-integration) ## 개요 Amazon Bedrock AgentCore Gateway는 개발자가 대규모로 도구를 빌드, 배포, 검색 및 연결하는 데 도움이 됩니다. 서비스를 통해 다음을 수행할 수 있습니다. + API, Lambda 함수 및 기존 서비스를 Model Context Protocol(MCP) 호환 도구로 변환 + 게이트웨이 엔드포인트를 통해 에이전트가 도구를 사용할 수 있도록 설정 + 완전 관리형 서비스에서 포괄적인 수신 및 송신 인증 사용 AI 에이전트는 이러한 도구를 사용하여 다음과 같은 작업을 수행합니다. + 데이터베이스 쿼리 + 메시지 보내기 + 문서 분석 자세한 내용은 [Amazon Bedrock AgentCore 개발자 안내서](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html)를 참조하세요. ## Bedrock AgentCore Gateway와 통합 제품에 따라 다음 방법 중 하나로 SaaS API 기반 AI 에이전트 제품에 대해 Amazon Bedrock AgentCore Gateway 통합을 활성화할 수 있습니다. + 2각 OAuth 인증을 지원하는 MCP 서버를 나열하는 경우 추가 요구 사항 없이 구매자에게 통합을 제공하도록 옵트인할 수 있습니다. 등록 프로세스의 일부로 제공하는 MCP 서버 엔드포인트가 통합에 사용됩니다. 그러나 MCP 서버가 아래 나열된 요구 사항을 충족하는지 확인해야 합니다. 자세한 내용은 [MCP 서버 대상](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-MCPservers.html)을 참조하세요. + 다른 모든 에이전트 또는 도구의 경우 OpenAPI 사양을 제공하여 통합을 활성화할 수 있습니다. ### MCP 서버 요구 사항 MCP 서버는 다음 요구 사항을 충족해야 합니다. + 다음 구성 중 하나를 사용한 2각 OAuth 인증: + 클라이언트 ID, 클라이언트 보안 암호 및 검색 URL + 클라이언트 ID, 클라이언트 보안 암호, 발급자, 권한 부여 엔드포인트 및 토큰 엔드포인트. + MCP 서버에는 도구 기능이 있어야 합니다. + 지원되는 MCP 프로토콜 버전: **2025-06-18** 및 **2025-03-26**. + 해당 서버의 제공된 URL 또는 엔드포인트의 경우, URL을 인코딩해야 합니다. 게이트웨이는 동일한 URL을 사용하여 서버를 간접적으로 호출합니다. ### OpenAPI 사양 요구 사항 OpenAPI 사양은 다음과 같아야 합니다. + 모든 작업에 대한 `operationId` 필드 포함 + 의미 체계 오류 없음 + 서버 속성에 유효한 보안(https) 엔드포인트 URL 포함 다음 표에는 지원되는 OpenAPI 기능과 지원되지 않는 OpenAPI 기능이 나와 있습니다. | 카테고리 | 지원됨 | 지원되지 않음 | | --- | --- | --- | | 버전 | 3.0 및 3.1 | 2 | | 스키마 정의 | 기본 데이터 유형(문자열, 숫자, 부울 등) | oneOf 사양 | | | 필수 필드 검증 | anyOf 사양 | | | 중첩된 객체 | | | | 항목 사양을 포함하는 배열 | | | | 표준 HTTP 메서드 | | | 미디어 유형 | application/json | 사용자 지정 미디어 유형 | | | application/xml | 이진 미디어 유형 | | | multipart/form-data | | | | x-www-form-urlencoded | | | 파라미터 | 단순 경로 파라미터 및 string/number/boolean 유형과 같은 기본 쿼리 파라미터 | 복잡한 경로 파라미터 직렬화 | | | | 복잡한 쿼리 파라미터 배열 | | | | 헤더 파라미터 직렬화 | | | | 쿠키 파라미터 직렬화 | | 요청 및 응답 | JSON 본문 | | | | XML 본문 | | | | 표준 HTTP 상태 코드 | | | 검증 | 기본 필드 검증 | 정규식 패턴 검증 | | | | 최솟값/최댓값 검증 | | 보안 | 해당 사항 없음 | 사양 수준의 보안 체계 | | | | 여러 보안 체계 | | | | 사양 수준의 OAuth 2.0 | | | | 사양 수준의 API 키 | | | | 사양 수준의 HTTP 기본 인증 | | 서버 구성 | 기본 URL | | | | 자리 표시자가 있는 URL | | ### Bedrock AgentCore Gateway 활성화 게이트웨이 통합을 활성화하기 전에 다음 작업을 완료하여 Amazon Bedrock AgentCore Gateway로 OpenAPI 사양 또는 MCP 서버를 테스트합니다. + [게이트웨이 생성](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building.html) + [대상 연결](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html) + [게이트웨이 테스트](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-testing.html) **게이트웨이 통합을 활성화하려면** 1. [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management)에 로그인합니다. 1. [AI 에이전트 및 도구](https://aws.amazon.com/marketplace/management/products/aiagents) 페이지를 엽니다. 1. **AI 에이전트 및 도구 제품** 탭에서 수정할 제품을 선택합니다. 1. **변경 요청** 드롭다운 목록에서 **이행 옵션 업데이트**를 선택합니다. 1. **Amazon Bedrock AgentCore 통합을 위한 도구 활성화**를 선택합니다. 1. OpenAPI 사양을 업로드합니다. 2각 OAuth 지원 MCP Server 제품의 경우 필수는 아니며 MCP 엔드포인트만 필요합니다. 1. **제출**을 선택합니다. 제출한 후에는 **요청** 탭에 요청 상태가 **검토 중**으로 표시됩니다. 처리를 완료하면 상태가 **성공**으로 변경됩니다. # 컨테이너 기반 AI 에이전트 제품 등록 ## 컨테이너 기반 AI 에이전트 및 도구 관리 Amazon Bedrock AgentCore 런타임에서 실행되는 컨테이너 기반 AI 에이전트 및 도구는 AWS Marketplace 관리 콘솔의 통합 **AI 에이전트 및 도구** 제품 페이지 또는 **서버** 제품 페이지를 통해 관리할 수 있습니다. Amazon Bedrock AgentCore 런타임을 지원하는 버전이 있는 제품만 **AI 에이전트 및 도구** 제품 페이지에 표시됩니다. ## 리스팅 마법사 시작 1. AWS 판매자 계정으로 [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/homepage/)에 로그인합니다. 1. **제품**을 선택한 다음 탐색 모음에서 **AI 에이전트 및 도구**를 선택합니다. 1. **AI 에이전트 및 도구 제품 생성** 메뉴를 선택한 다음 **컨테이너 기반 AI 에이전트 및 도구**를 선택합니다. 1. **제품 ID 및 제품 코드 생성**을 선택합니다. 1. (선택 사항) 태그 기반 권한 부여를 지원하는 선택적 태그를 추가할 수도 있습니다. 1. **계속**을 선택합니다. ## 1단계: 제품 정보 제공 1. **제품 정보** 다음을 입력합니다. + **제품 제목** + **제품 로고 S3 URL** + **간단한 설명** + **자세한 설명** + **주요 내용(1\$13)** 1. 지원 세부 정보를 입력하고 리소스 추가를 선택하여 선택적 학습 리소스를 추가합니다. 1. **제품 범주** 메뉴에서 1\$13개의 범주를 선택합니다. **AI 에이전트 및 도구** 비즈니스 범주에서 하나 이상의 범주를 선택하는 것이 좋습니다. 1. 키워드를 입력하여 검색 시 발견 가능성을 개선합니다. 1. (선택 사항) 지침에 따라 비디오 및 이미지 자산을 추가합니다. 1. **다음**을 선택합니다. ## 2단계: AI 에이전트 컨테이너 요금 구성 1. 요금 모델을 선택합니다. **AgentCore 요금 제한 사항** 컨테이너 이미지가 AgentCore를 사용하는 경우, **시간당** 및 **장기 계약 및 사용량 결합** 요금 모델은 지원되지 않습니다. 자세한 계약 요금 정보는 [를 사용한 컨테이너 제품의 계약 요금 AWS License Manager](container-license-manager-integration.md) 섹션을 참조하세요. 사용량 기반 요금의 사용자 지정 측정에 대한 자세한 내용은 [AWS Marketplace Metering Service를 사용하여 컨테이너 제품의 사용자 지정 측정 구성](container-metering-meterusage.md) 섹션을 참조하세요. 1. **다음**을 선택합니다. 1. **가격 설정**에서 1. **다음**을 선택합니다. ## 3단계: 환불 정책 지정 1. 환불 정책을 입력합니다. 1. **다음**을 선택합니다. **참고** 무료 제품 요금 모델을 선택한 경우, 환불 정책을 입력할 필요가 없습니다. ## 4단계: EULA 구성 1. ** AWS Marketplace표준 계약** 또는 **사용자 지정 EULA**를 선택합니다. **참고** 사용자 지정 EULA를 선택하는 경우, 최종 사용자 라이선스 계약의 URL을 입력합니다. 1. **다음**을 선택합니다. ## 5단계: 리포지토리 추가 1. 컨테이너 제품의 초기 리포지토리를 추가합니다. **참고** 리포지토리 이름은 판매자 계정의 모든 제품에서 고유해야 합니다. 제품 하나에 생성 가능한 리포지토리는 최대 50개입니다. 1. **다음**을 선택합니다. ## 6단계: 제안 가용성/허용 목록 구성 1. **제안 가용성 구성**에서 지리적 가용성 설정을 선택합니다. 1. **다음**을 선택합니다. 1. **허용 목록 구성**에서 제한된 상태에 있는 동안 목록에 액세스할 수 있어야 하는 AWS 계정을 나열합니다. 1. **제출**을 선택하여 제한된 가시성 테스트를 위한 새 변경 요청을 생성합니다. 요청 상태가 *성공* 상태가 될 때까지 10\$115분 정도 기다립니다. ## 7단계: 컨테이너 이미지 및 아티팩트를 리포지토리에 업로드 **참고** AgentCore를 컨테이너 이미지와 통합하는 방법은 [에 대한 Amazon Bedrock AgentCore 런타임 AWS Marketplace](bedrock-agentcore-runtime.md) 섹션을 참조하세요. 1. ECR 리포지토리의 URL을 찾습니다. + AWS Marketplace Management Portal에서 서버 제품 페이지를 엽니다. + 컨테이너 제품을 선택하여 세부 정보를 확인합니다. + 리포지토리 탭을 선택하여 리포지토리의 URL을 복사합니다. 1. **푸시 명령 보기**를 선택하여 Docker 컨테이너 이미지와 차트 Helm을 해당 리포지토리로 푸시하는 데 사용할 수 있는 명령을 포함한 지침 목록을 엽니다. 컨테이너 이미지 및 기타 아티팩트를 리포지토리로 푸시하는 방법에 대한 일반적인 정보는 Amazon Elastic Container Registry 사용 설명서의 [이미지 푸시](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html)를 참조하세요. **참고** docker pull 또는 docker push를 직접 호출할 때 다음 Amazon Elastic Container Registry(Amazon ECR) API 작업을 사용할 수 있습니다. DescribeImages - 리포지토리의 이미지에 대한 메타데이터를 검토할 때 사용합니다. GetAuthorizationToken - 아티팩트를 리포지토리에 업로드하기 전에 인증에 사용하며, 그 다음에는 docker pull 또는 docker push 명령을 사용합니다. ListImages - 푸시한 이미지 목록을 보는 데 사용합니다. 1. 나열된 명령을 사용하여 로컬 리포지토리에서 제품의 AWS Marketplace 리포지토리로 필요한 아티팩트를 푸시합니다. **참고** 푸시 명령에서 제공하는 태그는 리포지토리에 업로드하는 아티팩트 버전을 구분하는 데 사용됩니다. 아티팩트가 속한 버전에 적합한 태그를 사용합니다. 1. 버전에 필요한 컨테이너 이미지 또는 아티팩트마다 이 과정을 반복합니다. **참고** 버전의 각 제공 옵션에 최대 50개의 컨테이너 이미지 또는 아티팩트를 포함할 수 있습니다. 제공 옵션에 대한 자세한 내용은 다음 절차를 참조하세요. 1. 아티팩트를 업로드했으면 제품 버전을 생성할 준비가 된 것입니다. **참고** [에 대한 컨테이너 기반 제품 요구 사항 AWS Marketplace](container-product-policies.md)을 충족하는지 확인하기 위해 컨테이너 이미지가 자동으로 스캔됩니다. 자세한 내용은 [컨테이너 제품을 스캔하여 보안 문제 확인](container-product-getting-started.md#container-security) 단원을 참조하십시오. ## 8단계: 자산에 새 제품 버전 추가 1. AWS Marketplace Management Portal에서 **AI 에이전트 및 도구** 제품 페이지를 엽니다. **참고** Amazon Bedrock AgentCore 런타임을 지원하는 버전이 있는 컨테이너 제품만 **AI 에이전트 및 도구** 제품 페이지에 표시됩니다. 첫 번째 버전을 추가하기 전에 AWS Marketplace 관리 포털의 **서버** 제품 페이지에서만 제품을 찾을 수 있습니다. Amazon Bedrock AgentCore 런타임용 버전을 생성하면 **AI 에이전트 및 도구** 제품 페이지에서 컨테이너 제품을 찾을 수 있습니다. 1. 컨테이너 제품을 선택하고, **변경 요청** 드롭다운 메뉴를 클릭하고, **버전 업데이트**를 선택한 다음 **새 버전 추가**를 선택합니다. 1. **전송 옵션**에서 다음을 입력합니다. + **버전 제목** + **릴리스 정보** 1. **제공 옵션 추가**를 선택합니다. 1. **제공 방법**에서 **컨테이너 이미지**를 선택하고 다음을 입력합니다. + **지원되는 서비스**에서 구매자가 소프트웨어를 시작할 수 있는 환경을 선택합니다. + **Bedrock AgentCore** 서비스의 경우 **유형** 필드에서 **AI 에이전트, MCP 서버 또는 A2A 서버를** 선택합니다. + **컨테이너 이미지**: 이전에 지정한 *리포지토리 URL* 및 *버전 태그*입니다. + **제공 옵션 제목** 및 **배포 옵션 설명**: 이 제공 옵션의 제목과 설명을 입력합니다. + **사용 지침**: 구매자가 소프트웨어를 시작한 후 사용하는 데 도움이 되는 세부 정보를 입력합니다. + **환경 변수**: 구매자가 에이전트의 런타임 동작을 구성하기 위해 제공해야 하는 환경 변수를 지정합니다. 이러한 변수를 사용하여 시작 시 설정, 자격 증명 또는 사용자 지정 플래그를 컨테이너에 전달할 수 있습니다. 각 변수에 대해 컨테이너에서 예상한 이름, 설명 및 선택적 기본값을 제공합니다. 고유한 자격 증명 또는 API 키와 같은 변수의 경우 기본값을 제공하지 마십시오. 설명을 사용하여 변수에 대한 세부 정보와 가능한 값을 지정할 수 있습니다. 기본값이 있는 제공된 모든 변수는 구매자가 제품을 시작할 때 미리 채워집니다. 1. **AI 에이전트** 또는 **A2A 서버** 도구 유형을 선택한 경우 에이전트가 추론 LLMs 사용하고 자율 기능을 보여주는지 확인합니다. 이러한 요구 사항은 AWS Marketplace에서 제공되는 에이전트가 높은 품질 기준을 충족하는 데 도움이 됩니다. 에이전트가 두 요구 사항을 모두 충족하지 않는 경우 다른 도구 유형을 선택합니다. 1. **버전 추가**를 선택합니다. 요청 상태가 *성공*으로 표시될 때까지 기다렸다가 페이지를 새로 고칩니다. 새 버전을 추가하면 컨테이너 이미지에 취약성이 있는지 자동으로 스캔합니다. ## 9단계: 제품 목록 검토 및 공개로 게시 1. AWS Marketplace Management Portal에서 **AI 에이전트 및 도구** 제품 페이지를 엽니다. 1. 목록에서 컨테이너 제품을 선택합니다. 1. **보기 켜기를 AWS Marketplace** 선택합니다. 1. 제품 세부 정보 페이지의 정확성을 검토합니다. 사용 지침이 구매자에게 제품을 시작하는 데 필요한 단계를 충분히 안내하는지 확인합니다. 1. 공개로 가시성 업데이트 요청 제출: + **서버 제품** 페이지의 **현재 서버 제품** 탭에서 수정하려는 컨테이너 기반 제품을 선택합니다. **변경 요청** 드롭다운에서 **표시 여부 업데이트**를 선택합니다. ## 컨테이너 배포 세부 정보 컨테이너 배포는 AI 에이전트 또는 도구를 고객이 자체 AWS 환경에서 실행할 수 있는 컨테이너화된 애플리케이션으로 패키징합니다. 이러한 접근 방식에는 다음과 같은 이점이 있습니다. + 데이터가 고객 환경 내에 유지됨 + 사용자 지정 가능한 배포 구성 + Bedrock AgentCore Runtime 및 고객의 기존 인프라와의 통합 지원 컨테이너화된 에이전트를 등록할 때 고객이 성공적으로 구현할 수 있도록 명확한 배포 지침, 리소스 요구 사항 및 구성 옵션을 제공합니다. ### Bedrock AgentCore Runtime 컨테이너의 기술 요구 사항 **참고** 자세한 내용은 [에 대한 Amazon Bedrock AgentCore 런타임 AWS Marketplace](bedrock-agentcore-runtime.md) 섹션을 참조하세요. 용 컨테이너 기반 AI 에이전트 제품을 생성할 때는 다음 요구 사항을 AWS Marketplace따르세요. MCP 서버 요구 사항 + **전송**: 스트리밍 가능 상태 비저장 http 전용 + **세션 관리**: 플랫폼은 세션 격리를 위한 `Mcp-Session-Id` 헤더를 자동으로 추가합니다. + **호스트**: 컨테이너가 `0.0.0.0`에서 수신해야 합니다. + **포트**: 컨테이너는 MCP 서버 통신을 위해 포트 `8000`을 노출해야 합니다. + **경로**: `/mcp` - MCP RPC 메시지를 수신하기 위한 POST 엔드포인트입니다. MCP 서버의 InvokeAgentRuntime은 이 경로로 요청을 전달합니다. + **프로토콜**: MCP 서버는 'tools/list' 및 'tools/call'(FastMCP와 같은 공통 프레임워크에서 지원) 프로토콜 메시지를 포함한 MCP 프로토콜을 지원해야 합니다. 에이전트 요구 사항 + **/ping** 엔드포인트: 상태 확인을 위한 GET 엔드포인트 + **/invocations** 엔드포인트: 에이전트 상호 작용을 위한 POST 엔드포인트 + **Docker 컨테이너**: ARM64 컨테이너화된 배포 패키지 + **포트**: 컨테이너는 HTTP 기반 에이전트 통신을 위해 `8080` 포트를 노출해야 합니다. + 하드 코딩된 자격 증명 없음 + 일반적인 취약성 및 노출(CVE) 없음 A2A 서버 요구 사항 + **포트**: 포트 9000에서 실행되는 A2A 서버(HTTP의 경우 8080, MCP의 경우 8000) + **호스트**: 컨테이너가 `0.0.0.0`에서 수신해야 합니다. + **경로**: A2A 서버는 `/` (HTTP`/invocations`의 경우 , MCP`/mcp`의 경우 )에 탑재됩니다. + **에이전트 카드**: A2A는에서 에이전트 카드를 통해 기본 제공 에이전트 검색을 제공합니다. `/.well-known/agent-card.json` + **프로토콜**: agent-to-agent 통신에 JSON-RPC 사용 + **인증**: SigV4 및 OAuth 2.0 인증 체계 모두 지원 사용 지침 지침을 통해 고객이 제품을 시작하고 구성하는 과정을 자세하게 안내하는지 확인합니다. 자세한 내용은 [에 대한 AMI 및 컨테이너 제품 사용 지침 생성 AWS Marketplace](ami-container-product-usage-instructions.md) 항목을 참조하세요. ## 테스트 및 검증 MCP 호환 에이전트 또는 도구를 공개로 게시하기 전에 구현을 철저히 테스트합니다. + 사용 지침이 제품을 시작하고 구성하는 데 필요한 정보를 제공하는지 확인합니다. + 인증 흐름 및 오류 처리 테스트 + 다양한 로드 조건에서 성능 검증 + 널리 사용되는 MCP 클라이언트와의 호환성 보장 + 클라이언트별 구성 요구 사항 문서화 ## 모범 사례 및 권장 사항 ### 문서화 요구 사항 모델 컨텍스트 프로토콜 호환 에이전트 또는 도구를에 나열할 때는 포괄적인 설명서를 AWS Marketplace포함하세요. + 자세한 기능 설명 및 예제 + 인증 및 구성 지침 + 일반적인 통합 시나리오를 위한 샘플 코드 + 문제 해결 가이드 및 오류 참조 + 성능 고려 사항 및 모범 사례 ### 추가 리소스 AI 에이전트 또는 도구에서 Model Context Protocol(MCP)을 구현하는 방법에 대한 자세한 내용은 다음 리소스를 참조하세요. + [Amazon Bedrock AgentCore 설명서](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html) + [에 대한 Amazon Bedrock AgentCore 런타임 AWS Marketplace](bedrock-agentcore-runtime.md) + [컨테이너 기술 요구 사항](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html) # 에 대한 Amazon Bedrock AgentCore 런타임 AWS Marketplace 이 문서는 Amazon Bedrock AgentCore 런타임에 배포할 수 있는 AI 에이전트 또는 도구를 나열하려는 AWS Marketplace 판매자를 위한 정보를 제공합니다. AWS Marketplace용 Bedrock AgentCore Runtime 지원 컨테이너를 준비하기 위한 기술 요구 사항, 구성 지침 및 모범 사례를 간략하게 설명합니다. **Topics** + [개요](#agentcore-runtime-overview) + [Bedrock AgentCore 컨테이너 기술 요구 사항](#agentcore-container-requirements) + [Bedrock AgentCore Runtime 컨테이너 테스트](#testing-agentcore-container) + [컨테이너 구성 모범 사례](#container-best-practices) + [AWS Marketplace 제출 요구 사항](#marketplace-submission-requirements) + [추가 리소스](#agentcore-additional-resources) + [에서 AgentCore 런타임 지원 AWS Marketplace](#agentcore-support) ## 개요 Amazon Bedrock AgentCore Runtime은 AI 에이전트 또는 도구를 배포하고 실행하기 위해 특별히 구축된 안전한 서버리스 호스팅 환경을 제공합니다. Bedrock AgentCore 런타임 컨테이너를 나열 AWS Marketplace할 때 Bedrock AgentCore 환경 내에서 제대로 작동하려면 특정 요구 사항을 충족하는지 확인해야 합니다. **참고** 자세한 내용은 [Amazon Bedrock AgentCore Runtime 시작하기](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-getting-started.html)를 참조하세요. ## Bedrock AgentCore 컨테이너 기술 요구 사항 Amazon Bedrock AgentCore 런타임에는 AI 에이전트, MCP 서버 및 A2A 서버를 나열하기 위한 다양한 기술 요구 사항이 있습니다. + **에이전트 요구 사항** + **MCP 서버 요구 사항** + **A2A 서버 요구 사항** ### 에이전트 요구 사항 컨테이너화된 에이전트는 다음 핵심 요구 사항을 충족해야 합니다. + **/ping** 엔드포인트: 상태 확인을 위한 GET 엔드포인트 + **/invocations** 엔드포인트: 에이전트 상호 작용을 위한 POST 엔드포인트 + **Docker 컨테이너**: ARM64 컨테이너화된 배포 패키지 + **포트**: 컨테이너는 HTTP 기반 에이전트 통신을 위해 `8080` 포트를 노출해야 합니다. #### `/ping` - GET 이 엔드포인트는 에이전트가 작동 중이고 요청을 처리할 준비가 되었는지 확인합니다. **응답의 예:** ``` { "status": "Healthy" } ``` #### `/invocations` - POST 고객이 JSON 형식의 페이로드를 사용하여 InvokeAgentRuntime 작업으로 에이전트를 직접 호출할 때의 기본 에이전트 상호 작용 엔드포인트입니다. InvokeAgentRuntime은 스트리밍 응답을 지원하므로 고객이 부분 응답을 사용할 수 있게 되면 수신할 수 있습니다. **요청의 예:** ``` Content-Type: application/json { "prompt": "What's the weather today?" } ``` **응답의 예:** + JSON 응답(비스트리밍): ``` Content-Type: application/json { "response": "Your agent's response here", "status": "success" } ``` + SSE 응답(스트리밍): ``` Content-Type: text/event-stream data: {"event": "partial response 1"} data: {"event": "partial response 2"} data: {"event": "final response"} ``` ### MCP 서버 요구 사항 Amazon Bedrock AgentCore Runtime을 사용하면 Model Context Protocol(MCP) 서버를 배포하고 실행할 수 있습니다. MCP 프로토콜로 Amazon Bedrock AgentCore Runtime을 구성하면 서비스는 경로 `0.0.0.0:8000/mcp`에 MCP 서버 컨테이너가 있을 거라고 예상합니다. 이는 대부분의 공식 MCP 서버 SDK가 지원하는 기본 경로입니다. Amazon Bedrock AgentCore Runtime은 기본적으로 세션 격리를 제공하므로 스트리밍 가능한 상태 비저장 HTTP 서버가 필요합니다. 런타임은 헤더가 포함되지 않은 모든 요청에 대해 `Mcp-Session-Id` 헤더를 자동으로 추가합니다. 이를 통해 MCP 클라이언트는 동일한 Amazon Bedrock AgentCore Runtime 세션에 대한 연결 연속성을 유지할 수 있습니다. `InvokeAgentRuntime` API는 페이로드 데이터를 직접 전달하므로 MCP와 같은 프로토콜에 대한 RPC 메시지를 쉽게 프록시할 수 있습니다. 요구 사항: + **전송** - 스트리밍 가능한 상태 비저장 http만 사용해야 합니다. + **세션 관리** - 플랫폼은 세션 격리를 위한 `Mcp-Session-Id` 헤더를 자동으로 추가합니다. + **호스트** - 컨테이너가 `0.0.0.0`에서 수신해야 합니다. + **포트** - 컨테이너는 MCP 서버 통신을 위해 포트 `8000`을 노출해야 합니다. + **경로** - MCP RPC 메시지를 수신하려면 `/mcp`를 POST 엔드포인트로 노출해야 합니다. `InvokeAgentRuntime` API는 MCP 서버에 대한 요청을 이 경로로 전달합니다. + **프로토콜** - MCP 서버는 다음 프로토콜 메시지를 포함하여 MCP 프로토콜을 지원해야 합니다. + `tools/list` + `tools/call`(FastMCP와 같은 공통 프레임워크에서 지원됨) MCP 서버 요구 사항에 대한 자세한 내용은 [AgentCore Runtime에서 MCP 서버 배포](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-mcp.html)를 참조하세요. #### `/mcp` - POST 고객이 InvokeAgentRuntime으로 MCP 서버를 직접 호출할 때의 기본 에이전트 상호 작용 엔드포인트입니다. **목록 요청 예제:** ``` Content-Type: application/json { "jsonrpc": "2.0", "id": 1, "method": "tools/list", } ``` **목록 응답 예제:** JSON 응답(비스트리밍): ``` Content-Type: application/json { "jsonrpc": "2.0", "id": 1, "result": { "tools": [ { "name": "get_weather", "title": "Weather Information Provider", "description": "Get current weather information for a location", "inputSchema": { "type": "object", "properties": { "location": { "type": "string", "description": "City name or zip code" } }, "required": ["location"] } } ], "nextCursor": "next-page-cursor" } } ``` **도구 호출 요청 예제:** ``` Content-Type: application/json { "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "get_weather", "arguments": { "location": "New York" } } } ``` **도구 호출 응답 예제:** JSON 응답(비스트리밍): ``` Content-Type: application/json { "jsonrpc": "2.0", "id": 2, "result": { "content": [ { "type": "text", "text": "Current weather in New York:\nTemperature: 72°F\nConditions: Partly cloudy" } ], "isError": false } } ``` ### A2A 서버 요구 사항 Amazon Bedrock AgentCore 런타임을 사용하면 AgentCore 런타임에서 에이전트 Agent-to-Agent(A2A) 서버를 배포하고 실행할 수 있습니다. Amazon Bedrock AgentCore의 A2A 프로토콜 지원을 통해 투명한 프록시 계층 역할을 하여 A2A 서버와 원활하게 통합할 수 있습니다. A2A에 대해 구성된 경우 Amazon Bedrock AgentCore는 컨테이너가 루트 경로(`0.0.0.0:9000/`)의 포트`9000`에서 상태 비저장 스트리밍 가능한 HTTP 서버를 실행할 것으로 예상하며, 이는 기본 A2A 서버 구성과 일치합니다. 이 서비스는 프로토콜 투명성을 유지하면서 엔터프라이즈급 세션 격리를 제공합니다. InvokeAgentRuntime API의 JSON-RPC 페이로드는 수정 없이 A2A 컨테이너로 직접 전달됩니다. 이 아키텍처는 및 JSON-RPC 통신에서 에이전트 카드를 통한 기본 제공 에이전트 검색`/.well-known/agent-card.json`과 같은 표준 A2A 프로토콜 기능을 유지하면서 엔터프라이즈 인증(SigV4/OAuth 2.0) 및 확장성을 추가합니다. 다른 프로토콜과의 주요 차별화 요소는 포트(HTTP의 경우 9000 대 8080), 탑재 경로(`/` 대 `/invocations`) 및 표준화된 에이전트 검색 메커니즘이므로 Amazon Bedrock AgentCore는 프로덕션 환경의 A2A 에이전트를 위한 이상적인 배포 플랫폼입니다. 요구 사항: + **포트** - 포트 9000에서 실행되는 A2A 서버(HTTP의 경우 8080, MCP의 경우 8000) + **호스트** - 컨테이너가 `0.0.0.0`에서 수신해야 합니다. + **경로** + A2A 서버는에 탑재됩니다`/`(HTTP`/invocations`의 경우 , MCP`/mcp`의 경우 ). + GET `/ping` 사용 시 상태 확인 + **에이전트 카드** - A2A는에서 에이전트 카드를 통해 기본 제공 에이전트 검색을 제공합니다. `/.well-known/agent-card.json` + **프로토콜** - agent-to-agent 통신에 JSON-RPC 사용 + **인증** - SigV4 및 OAuth 2.0 인증 체계를 모두 지원합니다. A2A 서버 요구 사항에 대한 자세한 내용은 [ AgentCore 런타임에서 A2A 서버 배포를 참조하세요](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-a2a.html). #### `/` - POST 고객이 InvokeAgentRuntime으로 A2A 서버를 호출할 때 기본 에이전트 상호 작용 엔드포인트입니다. **에이전트 호출 요청의 예:** ``` Content-Type: application/json { "jsonrpc": "2.0", "id": "req-001", "method": "message/send", "params": { "message": { "role": "user", "parts": [ { "kind": "text", "text": "what is 101 * 11?" } ], "messageId": "12345678-1234-1234-1234-123456789012" } } } ``` **에이전트 호출 응답의 예:** JSON 응답(비스트리밍): ``` Content-Type: application/json { "jsonrpc": "2.0", "id": "req-001", "result": { "artifacts": [ { "parts": [ { "kind": "text", "text": "101 * 11 is 1111" } ] } ] } } ``` **에이전트 카드 검색 예:** ``` curl https://bedrock-agentcore..amazonaws.com/runtimes/{escaped_agent_arn}/invocations/.well-known/agent-card.json ``` #### `/ping` - GET 상태 확인을 수행하기 위한 엔드포인트입니다. ## Bedrock AgentCore Runtime 컨테이너 테스트 컨테이너를 제출하기 전에 철저히 AWS Marketplace테스트합니다. ### 로컬 에이전트 테스트 Docker를 사용하여 로컬에서 에이전트를 테스트합니다. ``` docker run -p 8080:8080 # Test ping endpoint curl http://localhost:8080/ping # Test agent invocation endpoint curl -X POST http://localhost:8080/invocations \ -H "Content-Type: application/json" \ -d '{"prompt": "Hello world!"}' ``` ### 로컬 MCP 서버 테스트 Docker를 사용하여 로컬에서 MCP 서버를 테스트합니다. ``` docker run -p 8000:8000 # Test ping endpoint curl http://localhost:8000/ping # Test MCP endpoint with tools/list curl -X POST http://localhost:8000/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0","id": 1,"method": "tools/list"}' # Test MCP endpoint with tools/call curl -X POST http://localhost:8000/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "get_weather", "arguments": {"location": "New York"}}}' ``` ### 로컬 A2A 서버 테스트 Docker를 사용하여 로컬에서 A2A 서버 테스트 ``` docker run -p 9000:9000 # Test ping endpoint curl http://localhost:9000/ping # Retrieve agent card curl http://localhost:9000/.well-known/agent-card.json # Test A2A endpoint with message/send curl -X POST http://localhost:9000/ \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": "req-001", "method": "message/send", "params": { "message": { "role": "user", "parts": [ { "kind": "text", "text": "what is 101 * 11?"}],"messageId": "12345678-1234-1234-1234-123456789012" }}}' ``` ### Bedrock AgentCore Runtime에서 테스트 로컬에서 컨테이너를 테스트한 후, Amazon Elastic Container Registry(Amazon ECR)에 업로드하고 Amazon Bedrock AgentCore Runtime에 배포합니다. Amazon Bedrock AgentCore 런타임 콘솔 또는 AWS Command Line Interface ()를 사용하여 배포할 수 있습니다AWS CLI. ## 컨테이너 구성 모범 사례 ### 보안 고려 사항 + **격리** - 간접 호출 사이에 민감한 데이터를 저장하지 마세요. + **인증** - 모든 수신 요청을 검증 + **로깅** - 적절한 정보를 로깅하지만 민감한 데이터는 포함하지 않습니다. + **종속성** - 보안 취약성을 방지하기 위해 모든 종속성을 최신 상태로 유지 ### 성능 최적화 + **콜드 스타트** - 빠른 콜드 스타트를 위해 컨테이너 최적화 + **메모리 사용량** - 메모리 사용량을 최소화하여 성능 향상 + **동시성** - 동시 요청을 효율적으로 처리하도록 에이전트 설계 + **시간 초과** - 적절한 시간 초과 처리 구현 ### 오류 처리 + **단계적 성능 저하** - 서비스를 사용할 수 없는 경우 폴백 메커니즘 구현 + **구조화된 오류** - 적절한 HTTP 상태 코드와 함께 잘 구조화된 오류 응답을 반환합니다. + **재시도 로직** - 일시적 장애에 적합한 재시도 로직 구현 ## AWS Marketplace 제출 요구 사항 AgentCore 런타임 컨테이너를 제출할 때 다음을 AWS Marketplace포함합니다. + **컨테이너 이미지** - 컨테이너 이미지가 Amazon ECR로 푸시됨 + **설명서** - 에이전트 또는 MCP 서버 사용 방법에 대한 포괄적인 설명서 + **사용 예제** - 에이전트 또는 MCP 서버를 호출하는 방법에 대한 명확한 예제 + **지원 정보** - 지원을 위한 연락처 정보 + **요금 정보** - 에이전트 또는 MCP 서버의 명확한 요금 구조 ## 추가 리소스 자세한 내용은 다음 자료를 참조하세요. + [Amazon Bedrock AgentCore란 무엇인가요?](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html) + [란 무엇입니까 AWS Marketplace?](https://docs.aws.amazon.com/marketplace/latest/userguide/what-is-marketplace.html) + [컨테이너 제품 시작하기](container-product-getting-started.md) ## 에서 AgentCore 런타임 지원 AWS Marketplace AgentCore 런타임 컨테이너를에 나열하는 것과 관련된 질문은 [지원 받기를 AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-support.html) AWS Marketplace참조하세요. AgentCore 런타임에 대한 기술적 질문은 [AWS Support 및 고객 서비스를](https://console.aws.amazon.com/support/home#/case/create?issueType=technical) 참조하세요. # MCP 통합 AWS MCP 서버 (MCP)는 AI 에이전트와 외부 도구 간의 원활한 통신을 지원하는 개방형 표준입니다. AI 에이전트 또는 도구에서 MCP를 구현하면 고객은 복잡한 API 통합 작업 없이 솔루션을 기존 에이전트 워크플로에 직접 통합할 수 있습니다. MCP는 AI 에이전트가 외부 기능에 액세스하는 방법을 변환합니다. 에이전트는 각 도구에 대한 사용자 지정 통합을 구축하는 대신 표준화된 프로토콜을 사용하여 MCP 호환 서비스를 검색하고, 연결하고, 상호 작용합니다. 이 접근 방식은 통합의 복잡성을 줄이고 플러그 앤 플레이 기능을 활성화합니다. 에이전트 또는 도구 AWS MCP 서버 에서를 구현하는 방법에 대한 자세한 내용은 섹션을 참조하세요[MCP 통합](#integrating-mcp). **Topics** + [AWS MCP 서버 통합의 주요 이점](#mcp-benefits) + [AWS MCP 서버 아키텍처 및 구성 요소](#mcp-architecture) + [AWS MCP 서버 구현을 위한 기술 요구 사항](#mcp-implementation) + [테스트 및 검증](#mcp-testing) + [문서화 요구 사항](#mcp-documentation) + [추가 리소스](#mcp-resources) ## AWS MCP 서버 통합의 주요 이점 MCP 통합은 AI 에이전트 공급자와 최종 사용자 모두에게 이점을 제공합니다. ### AI 에이전트 공급자의 이점 + MCP를 지원하며 많이 사용되는 AI 개발 솔루션을 이용해 고객에게 연락합니다. + 표준화된 통합을 통해 고객 온보딩에서 일어나는 마찰을 줄입니다. + MCP 호환 클라이언트 애플리케이션을 통해 검색을 활성화합니다. + 단일 구현으로 여러 클라이언트 플랫폼을 지원합니다. ### 최종 사용자를 위한 이점 + 사용자 지정 개발 없이 기존 AI 워크플로에 기능을 추가합니다. + 이미 알고 있는 익숙한 AWS MCP 서버 클라이언트 인터페이스를 사용합니다. + 자동 프로토콜 처리 및 오류 관리의 이점을 누릴 수 있습니다. + 여러 AI 플랫폼 및 애플리케이션을 통해 도구에 액세스합니다. + AWS MCP 서버지원 서비스 전반에서 일관된 인증을 유지합니다. ## AWS MCP 서버 아키텍처 및 구성 요소 AWS MCP 서버 는 AI 에이전트 또는 도구가 AWS MCP 서버 서버 역할을 하는 클라이언트-서버 아키텍처를 사용합니다. 고객 애플리케이션(AWS MCP 서버 클라이언트)은 서버에 연결하여 기능에 액세스합니다. 프로토콜은 다음과 같은 세 가지 주요 유형의 기능을 정의합니다. + **도구** - 에이전트가 작업을 수행하기 위해 직접 호출할 수 있는 함수입니다. + **리소스** - 에이전트가 읽거나 쿼리할 수 있는 데이터 소스입니다. + **프롬프트** - 에이전트가 사용할 수 있는 사전 정의된 프롬프트 템플릿입니다. ## AWS MCP 서버 구현을 위한 기술 요구 사항 AWS MCP 서버 서버는 다음과 같은 핵심 프로토콜 사양을 구현해야 합니다. + JSON-RPC 2.0 통신 프로토콜 + 표준 AWS MCP 서버 메시지 유형 및 형식 + 기능 광고 및 검색 + 인증 및 세션 관리 + 오류 처리 및 상태 보고 ### 구현 단계 1. 기능(도구, 리소스 또는 프롬프트)을 정의합니다. 1. AWS MCP 서버 서버 인터페이스를 구현합니다. 1. JSON 스키마를 사용하여 기능 스키마를 생성합니다. 1. 인증 및 권한 부여를 구현합니다. 1. 오류 처리 및 로깅을 추가합니다. 1. 호환 클라이언트로 테스트 AWS MCP 서버합니다. 1. 고객을 위한 기능을 문서화합니다. ### 기능 정의 예제 ``` { "name": "search_knowledge_base", "description": "Search the knowledge base for relevant information", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "The search query" }, "max_results": { "type": "integer", "description": "Maximum number of results to return", "default": 5 } }, "required": ["query"] } } ``` ## 테스트 및 검증 AWS MCP 서버호환되는 에이전트 또는 도구를 나열하기 전에 구현을 AWS Marketplace철저히 테스트합니다. + 기능 검색 및 스키마 검증 확인 + 인증 흐름 및 오류 처리 테스트 + 다양한 로드 조건에서 성능 검증 + 인기 있는 AWS MCP 서버 클라이언트와의 호환성 보장 + 클라이언트별 구성 요구 사항 문서화 ## 문서화 요구 사항 AWS MCP 서버호환되는 에이전트 또는 도구를에 나열할 때는 포괄적인 설명서를 AWS Marketplace포함하세요. + 자세한 기능 설명 및 예제 + 인증 및 구성 지침 + 일반적인 통합 시나리오를 위한 샘플 코드 + 문제 해결 가이드 및 오류 참조 + 성능 고려 사항 및 모범 사례 ## 추가 리소스 AI 에이전트 또는 도구 AWS MCP 서버 에서를 구현하는 방법에 대한 자세한 내용은 다음 리소스를 참조하세요. + [Model Context Protocol 사양](https://modelcontextprotocol.github.io/) + [MCP GitHub 리포지토리](https://github.com/modelcontextprotocol/mcp) + AWS MCP 서버 통합 지원을 위한 [AWS Marketplace 판매자 운영 팀](https://aws.amazon.com/marketplace/management/contact-us/)