사용자 지정 기술 만들기

  • 5분

사용자 지정 기술은 Azure AI Search 기술 세트의 기술에 의해 예상되는 입력 및 출력 데이터에 대한 예상 스키마를 구현해야 합니다.

입력 스키마

사용자 지정 기술의 입력 스키마는 처리할 각 문서의 레코드를 포함하는 JSON 구조체를 정의합니다. 각 문서에는 다음과 같이 고유한 식별자와 하나 이상의 입력이 포함된 데이터 페이로드가 있습니다.

{
    "values": [
      {
        "recordId": "<unique_identifier>",
        "data":
           {
             "<input1_name>":  "<input1_value>",
             "<input2_name>": "<input2_value>",
             ...
           }
      },
      {
        "recordId": "<unique_identifier>",
        "data":
           {
             "<input1_name>":  "<input1_value>",
             "<input2_name>": "<input2_value>",
             ...
           }
      },
      ...
    ]
}

출력 스키마

사용자 지정 기술에서 반환하는 결과의 스키마는 입력 스키마를 반영합니다. 각 입력 레코드에 대해 기술에서 생성하는 결과나 발생한 오류에 대한 세부 정보를 포함하는 레코드가 출력에 포함된다고 가정해보겠습니다.

{
    "values": [
      {
        "recordId": "<unique_identifier_from_input>",
        "data":
           {
             "<output1_name>":  "<output1_value>",
              ...
           },
         "errors": [...],
         "warnings": [...]
      },
      {
        "recordId": "< unique_identifier_from_input>",
        "data":
           {
             "<output1_name>":  "<output1_value>",
              ...
           },
         "errors": [...],
         "warnings": [...]
      },
      ...
    ]
}

이 스키마의 출력 값은 모든 JSON 구조체를 포함할 수 있는 속성 모음입니다. 즉, 인덱스 필드는 단순한 데이터 값인 것만 아니라 복합 형식을 포함할 수도 있습니다.