쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

설정
문의하기
피드백
AWS Documentation
AWS 계정 생성

타사 플랫폼용 Amazon OpenSearch Service ML 커넥터

PDF
RSS
포커스 모드
타사 플랫폼용 Amazon OpenSearch Service ML 커넥터 - Amazon OpenSearch Service
사전 조건 OpenSearch 서비스 커넥터 생성

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

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

이 자습서에서는 OpenSearch Service에서 Cohere로 커넥터를 생성하는 방법을 다룹니다. 커넥터에 대한 자세한 내용은 지원되는 커넥터를 참조하세요.

Amazon OpenSearch Service 기계 학습(ML) 커넥터를 외부 원격 모델과 함께 사용하는 경우 특정 권한 부여 자격 증명을에 저장해야 합니다 AWS Secrets Manager. 키 API 또는 사용자 이름과 암호 조합일 수 있습니다. 즉, Secrets Manager에서 OpenSearch 서비스 액세스를 읽을 수 있는 IAM 역할도 생성해야 합니다.

사전 조건

Cohere 또는 OpenSearch 서비스를 사용하는 외부 공급자에 대한 커넥터를 생성하려면 자격 증명을 저장하는에 OpenSearch 대한 서비스 액세스 권한을 부여하는 IAM 역할 AWS Secrets Manager이 있어야 합니다. 또한 보안 인증 정보는 반드시 Secrets Manager에 저장해야 합니다.

IAM 역할 생성

Secrets Manager 권한을 OpenSearch 서비스에 위임하는 IAM 역할을 설정합니다. 기존의 SecretManagerReadWrite 역할을 사용해도 됩니다. 새 역할을 생성하려면 IAM 사용 설명서의 IAM 역할 생성(콘솔)을 참조하세요. AWS 관리형 역할을 사용하는 대신 새 역할을 생성하는 경우이 자습서opensearch-secretmanager-role의를 자신의 역할 이름으로 바꿉니다.

  1. 다음 관리형 IAM 정책을 새 역할에 연결하여 OpenSearch 서비스가 Secrets Manager 값에 액세스할 수 있도록 허용합니다. 정책을 역할에 연결하려면 IAM 자격 증명 권한 추가를 참조하세요.

    {
    "Version": "2012-10-17",
    "Statement": [
        {   
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

  2. 역할 신뢰 정책 수정에 나와 있는 지침에 따라 역할의 신뢰 관계를 편집합니다. Principal 문에서 OpenSearch 서비스를 지정해야 합니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "sts:AssumeRole"
            ],
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "opensearchservice.amazonaws.com"
                ]
            }
        }
    ]
}

    aws:SourceAccount 및 aws:SourceArn 조건 키를 사용하여 액세스 권한을 특정 도메인으로 제한하는 것이 좋습니다. SourceAccount는 도메인 소유자에 속하는 AWS 계정 ID이고 SourceArn는 도메인ARN의 입니다. 예를 들어 신뢰 정책에 다음 조건 블록을 추가할 수 있습니다.

    "Condition": {
    "StringEquals": {
        "aws:SourceAccount": "account-id"
    },
    "ArnLike": {
        "aws:SourceArn": "arn:aws:es:region:account-id:domain/domain-name"
    }
}

권한 구성

커넥터를 생성하려면 IAM 역할을 OpenSearch 서비스에 전달할 수 있는 권한이 필요합니다. es:ESHttpPost 작업에도 액세스해야 합니다. 이 두 권한을 모두 부여하려면 요청에 서명하는 데 자격 증명이 사용되는 IAM 역할에 다음 정책을 연결합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": "arn:aws:iam::account-id:role/opensearch-secretmanager-role"
    },
    {
      "Effect": "Allow",
      "Action": "es:ESHttpPost",
      "Resource": "arn:aws:es:region:account-id:domain/domain-name/*"
    }
  ]
}

사용자 또는 역할에 역할을 전달할 iam:PassRole 권한이 없는 경우 다음 단계에서 리포지토리를 등록하려고 할 때 권한 부여 오류가 발생할 수 있습니다.

설정 AWS Secrets Manager

인증 자격 증명을 Secrets Manager에 저장하려면 AWS Secrets Manager 사용 설명서의 AWS Secrets Manager 암호 만들기를 참조하세요.

Secrets Manager가 키-값 페어를 보안 암호로 수락하면 형식이 ARN 인가 수신됩니다arn:aws:secretsmanager:us-west-2:123456789012:secret:MySecret-a1b2c3. 다음 단계에서 커넥터를 생성할 때이를 사용하고 키를 ARN사용할 때이의 레코드를 유지합니다.

OpenSearch 대시보드에서 ML 역할 매핑(세밀한 액세스 제어를 사용하는 경우)

세분화된 액세스 제어를 사용하면 커넥터를 설정할 때 추가 단계가 있습니다. 다른 모든 용도로 HTTP 기본 인증을 사용하더라도 ml_full_access를 전달할 iam:PassRole 권한이 있는 IAM 역할에 역할을 매핑해야 합니다opensearch-sagemaker-role.

  1. OpenSearch 서비스 도메인의 OpenSearch 대시보드 플러그인으로 이동합니다. OpenSearch 서비스 콘솔의 도메인 대시보드에서 대시보드 엔드포인트를 찾을 수 있습니다.

  2. 주 메뉴에서 보안, 역할을 선택하고 ml_full_access 역할을 선택합니다.

  3. 매핑된 사용자(Mapped users), 매핑 관리(Manage mapping)를 차례로 선택합니다.

  4. 백엔드 역할에서 전달 권한이 있는 역할ARN의를 추가합니다opensearch-sagemaker-role.

    arn:aws:iam::account-id:role/role-name

  5. Map(맵)을 선택하고 Mapped users(매핑된 사용자)에 사용자 또는 역할이 나타나는지 확인합니다.

OpenSearch 서비스 커넥터 생성

커넥터를 생성하려면 OpenSearch 서비스 도메인 엔드포인트에 POST 요청을 보냅니다. curl, 샘플 Python 클라이언트, Postman 또는 다른 메서드를 사용하여 서명된 요청을 보낼 수 있습니다. Kibana 콘솔에서는 POST 요청을 사용할 수 없습니다. 요청은 다음과 같은 형식을 사용합니다.

POST domain-endpoint/_plugins/_ml/connectors/_create
{
    "name": "Cohere Connector: embedding",
    "description": "The connector to cohere embedding model",
    "version": 1,
    "protocol": "http",
    "credential": {
        "secretArn": "arn:aws:secretsmanager:region:account-id:secret:cohere-key-id",
        "roleArn": "arn:aws:iam::account-id:role/opensearch-secretmanager-role"
    },
    "actions": [
        {
            "action_type": "predict",
            "method": "POST",
            "url": "https://api.cohere.ai/v1/embed",
            "headers": {
                "Authorization": "Bearer ${credential.secretArn.cohere-key-used-in-secrets-manager}"
            },
            "request_body": "{ \"texts\": ${parameters.texts}, \"truncate\": \"END\" }"
        }
    ]
}

이 요청의 요청 본문은 오픈 소스 커넥터 요청의 요청 본문과 두 가지 측면에서 다릅니다. credential 필드 내에서 OpenSearch 서비스가 Secrets Manager에서 읽을 수 있도록 허용하는 IAM 역할ARN의와 보안 암호의 ARN를 전달합니다. headers 필드에서는 보안 암호 키를 사용하여 보안 암호를 참조하고에서 오는 보안 암호의 사실을 참조합니다ARN.

도메인이 가상 프라이빗 클라우드(VPC) 내에 있는 경우 요청이 AI 커넥터VPC를 성공적으로 생성하려면 컴퓨터를에 연결해야 합니다. 에 액세스하는 것은 네트워크 구성에 따라 VPC 다르지만 일반적으로 VPN 또는 회사 네트워크에 연결하는 것이 포함됩니다. OpenSearch 서비스 도메인에 연결할 수 있는지 확인하려면 웹 브라우저https://your-vpc-domain.region.es.amazonaws.com에서 로 이동하여 기본 JSON 응답을 받는지 확인합니다.

샘플 Python 클라이언트

Python 클라이언트는 HTTP 요청보다 자동화가 간단하고 재사용성이 뛰어납니다. Python 클라이언트로 AI 커넥터를 만들려면 다음 샘플 코드를 Python 파일에 저장하세요. 클라이언트에는 AWS SDK for Python (Boto3), requests, requests-aws4auth 패키지가 필요합니다.

import boto3
import requests 
from requests_aws4auth import AWS4Auth

host = 'domain-endpoint/'
region = 'region'
service = 'es'
credentials = boto3.Session().get_credentials()
awsauth = AWS4Auth(credentials.access_key, credentials.secret_key, region, service, session_token=credentials.token)

path = '_plugins/_ml/connectors/_create'
url = host + path

payload = {
    "name": "Cohere Connector: embedding",
    "description": "The connector to cohere embedding model",
    "version": 1,
    "protocol": "http",
    "credential": {
        "secretArn": "arn:aws:secretsmanager:region:account-id:secret:cohere-key-id",
        "roleArn": "arn:aws:iam::account-id:role/opensearch-secretmanager-role"
    },
    "actions": [
        {
            "action_type": "predict",
            "method": "POST",
            "url": "https://api.cohere.ai/v1/embed",
            "headers": {
                "Authorization": "Bearer ${credential.secretArn.cohere-key-used-in-secrets-manager}"
            },
            "request_body": "{ \"texts\": ${parameters.texts}, \"truncate\": \"END\" }"
        }
    ]
}

headers = {"Content-Type": "application/json"}

r = requests.post(url, auth=awsauth, json=payload, headers=headers)
print(r.status_code)
print(r.text)

이 페이지에서

Related resources

Amazon OpenSearch Service API 참조
AWS CLI 에 대한 명령 Amazon OpenSearch Service
SDK 및 도구 

Related resources

Amazon OpenSearch Service API 참조
AWS CLI 에 대한 명령 Amazon OpenSearch Service
SDK 및 도구 
프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.