0 / 0
영어 버전 문서로 돌아가기

API에서 참조할 파일 추가하기

마지막 업데이트 날짜: 2025년 2월 21일
API에서 참조할 파일 추가하기

파일을 추가하는 방법 알아보기 watsonx.ai 프로그래밍 방식으로 참조하려는 항목입니다.

일부 작업을 프로그래밍 방식으로 완료하려면 파일을 추가하고 API에서 참조할 수 있어야 합니다. 예를 들어, 프로그래밍 방식으로 foundation model 를 조정하려면 훈련 데이터 파일을 제공해야 합니다.

다음과 같은 자산 유형 중 하나를 만들어 파일을 추가할 수 있습니다

  • 연결 자산(connection asset)
  • 데이터 자산

자세한 내용은 데이터 참조에서 IBM watsonx.ai as a 서비스 API 설명서를 참조하세요.

UI에서 연결 자산을 만들어 파일 추가하기

파일을 사용할 수 있게 만드는 한 가지 방법은 IBM Cloud Object Storage 서비스 인스턴스의 새 버킷에 파일을 추가하여 watsonx.ai 프로젝트와 연결하면 됩니다. (IBM Cloud Object Storage 서비스 인스턴스는 사용자 인터페이스에서 watsonx.ai 프로젝트를 만들 때 자동으로 생성됩니다.)

API에서 참조할 수 있는 제품 사용자 인터페이스에서 연결 자산을 만들어 파일을 추가하려면 다음 단계를 완료하십시오

  1. IBM Cloud Object Storage 인스턴스에 watsonx.ai 프로젝트와 연결된 버킷을 추가합니다.

    IBM Cloud의 리소스 목록에서 스토리지를 확장한 다음 클릭하여 IBM Cloud Object Storage 서비스 인스턴스를 엽니다. 버킷 만들기를 클릭합니다.

  2. 버킷에 파일을 추가합니다.

    버킷의 오브젝트 탭에서 파일을 업로드합니다.

  3. API에서 파일을 참조하려면 파일이 저장된 버킷을 사용하여 IBM Cloud Object Storage 서비스 인스턴스에 대한 연결을 만들어야 합니다.

    1. 프로젝트에서 새 자산 > 데이터 소스에 연결을 선택하고 IBM Cloud Object Storage 선택한 후 다음을 클릭합니다.

    2. 연결 자산의 이름을 지정합니다.

    3. 연결 세부 정보를 보려면 다음 정보를 추가하세요:

      • 1단계에서 만든 버킷의 이름입니다.

      • URL 에 로그인하려면 IBM Cloud Object Storage 에서 스토리지 버킷을 열고, 설정 탭을 클릭한 다음, 공개 엔드포인트 URL 를 복사합니다.

      • 자격 증명의 경우, 액세스 키비밀 키 인증 옵션을 선택하여 데이터 소스에 연결합니다. IBM Cloud Object Storage 서비스 인스턴스의 기본 서비스 페이지에서 서비스 자격 증명 탭을 클릭한 다음, 사용하려는 키를 찾아 확장하여 키 세부 정보를 확인할 수 있습니다. 사용하는 키에는 HMAC 자격 증명이 포함되어야 합니다. HMAC 자격 증명이 포함된 기존 키가 없는 경우 키를 생성하세요. 다음 값을 복사하여 연결 자산 세부 정보 페이지의 해당 필드에 붙여넣습니다:

        버킷에서 복사 연결 자산에 붙여넣기
        access_key_id 액세스 키
        secret_access_key 시크릿 키

      watsonx.ai 프로젝트에서 IBM Cloud Object Storage 서비스 인스턴스에 대한 연결을 만드는 방법에 대한 자세한 내용은 IBM Cloud Object Storage connection를 참조하세요.

  4. 프로젝트의 자산 페이지에서 IBM Cloud Object Storage 데이터 연결 에셋을 엽니다. 현재 페이지의 URL 에서 URL 의 /connections/ 세그먼트 뒤에 표시되는 연결 ID를 복사합니다.

    API에서 파일을 참조할 때 이 연결 ID와 버킷 이름과 같은 기타 세부 정보를 지정할 수 있습니다.

    "type": "connection_asset",
       "connection": {
         "id": "<connection_id>"
       }
    

UI에서 데이터 자산을 생성하여 파일 추가하기

API에서 참조할 수 있는 제품 사용자 인터페이스에서 데이터 자산을 생성하여 파일을 추가하려면 다음 단계를 완료하십시오

  1. 프로젝트 개요 페이지에서 작업할 데이터 추가 버튼을 클릭합니다.

  2. 로컬 파일을 클릭한 다음, 데이터 자산을 클릭합니다.

  3. 찾아보기를 클릭하여 업로드할 파일을 찾아 선택합니다.

  4. 열기를 클릭한 다음, 완료를 클릭합니다.

  5. 클릭하면 모든 자산 목록 에서 방금 추가한 파일을 열 수 있습니다.

  6. 웹 브라우저의 위치 필드에 현재 페이지의 URL 의 data-assets//preview 사이에 표시되는 데이터 자산 ID를 복사합니다.

    데이터 자산 ID의 예는 1e6591a2-c69d-4716-92e3-73e8c2270956 입니다.

    API에서 파일을 참조할 때 이 데이터 자산 ID를 지정할 수 있습니다.

    {
      "training_data_references": [
      {
        "type": "data_asset",
        "location": {
          "href": "/v2/assets/<asset_id>?project_id=<project_id>"
        }
      }
     ]
    }
    

상위 주제: REST API