GetRAGSpaceInfo

공간 ID가 지정되지 않은 경우 지정된 RAG 공간 또는 모든 RAG 공간에 대한 정보를 반환합니다.

포맷 

GetRAGSpaceInfo ( ragAccountName {; spaceID } )

매개 변수 

ragAccountName - 사용할 RAG 계정의 이름에 대한 텍스트 표현식입니다. 현재 파일에서 RAG 계정 구성 스크립트 단계를 사용하여 계정을 설정하고 이 함수가 사용되기 전에 언제든지 이 이름을 할당하십시오.

spaceID - RAG 공간의 ID입니다. 생략하면 지정된 계정에 대한 모든 RAG 공간에 대한 정보가 반환됩니다.

괄호{ }의 매개 변수는 옵션입니다.

반환되는 데이터 유형 

텍스트

다음 버전에서 시작됨 

22.0

설명 

GetRAGSpaceInfo는 ragAccountName으로 지정된 AI 모델 서버의 검색 증강 생성(RAG) 공간에 대한 정보를 반환합니다. 이를 사용하여 RAG 공간의 존재를 확인하고, 콘텐츠를 모니터링하며, RAG 작업을 감사할 수 있습니다.

spaceID 값이 지정되지 않은 경우, 함수는 지정된 RAG 계정에 사용할 수 있는 RAG 공간의 배열을 포함하는 JSON 대상체를 반환합니다.

복사 
{
  "rag_space_list": [
    {
      "space_id": "<string>",
      "model": "<string>"
    }
  ]
}

  • rag_space_list는 RAG 공간의 배열입니다.

  • space_id는 RAG 공간 ID의 키입니다.

  • model은 이 RAG 공간에서 텍스트 임베딩 벡터를 생성하는 데 사용되는 모델 이름의 키입니다.

spaceID 값이 지정되면, 함수는 RAG 공간과 내부 데이터에 대한 정보를 포함하는 JSON 대상체를 반환합니다.

복사 
{
  "rag_space_id": "<string>",
  "model": "<string>",
  "entries": <number>,
  "values": [
    {
      "id": <number>,
      "filename": "<string>"
    },
    {
      "id": <number>,
      "text": "<string>"
    }
  ]
}

  • rag_space_id는 RAG 공간 ID입니다.

  • model은 이 RAG 공간에서 텍스트 임베딩 벡터를 생성하는 데 사용되는 모델의 이름입니다.

  • entries는 values 배열의 요소 수입니다.

  • values는 텍스트 문서 청크와 PDF 파일 이름의 배열입니다.

    • id는 텍스트 청크가 나온 텍스트 문서 또는 PDF 파일의 숫자 ID입니다.

    • filename은 공간에 추가된 PDF 파일의 이름입니다.

    • text는 공간에 추가된 텍스트 문서의 청크입니다. 동일한 텍스트 문서의 청크는 동일한 id를 갖습니다.

참고 

  • 이 함수를 사용하기 전에 먼저 RAG 계정 구성 스크립트 단계를 따라 RAG 계정을 구성해야 합니다.

  • 이 함수는 작업을 수행하기 전에 RAG 공간이 존재하는지 확인하는 데 유용합니다. 유효한 RAG 계정에서 공간이 존재하지 않거나 데이터가 없는 경우 이 함수는 오류 메시지를 반환합니다.

    [RAG 공간] 오류. 이유: RAG 공간 {space_id}을(를) 찾을 수 없음

  • RAG 계정이 유효하지 않거나 존재하지 않는 경우, 이 함수는 "?"를 반환합니다.

  • 이 함수는 FileMaker 솔루션 내의 RAG 공간을 감사하고 모니터링하는 데 사용할 수 있습니다.

예제 1 

"customer-support-rag-account"라는 이름으로 구성된 계정의 모든 RAG 공간에 대한 정보를 가져옵니다.

GetRAGSpaceInfo ( "customer-support-rag-account" )는 두 개의 RAG 공간에 데이터가 포함된 경우 다음을 반환할 수 있습니다.

복사 
{
  "rag_space_list": [
    {
      "space_id": "knowledge-base",
      "model": "multi-qa-MiniLM-L6-cos-v1"
    },
    {
      "space_id": "meeting-notes",
      "model": "multi-qa-MiniLM-L6-cos-v1"
    }
  ]
}

예제 2 

ID가 "knowledge-base"인 특정 RAG 공간에 대한 정보를 가져옵니다.

GetRAGSpaceInfo ( "customer-support-rag-account" ; "knowledge-base" )은 이름이 "Policies.pdf"인 PDF 파일과 세 개의 청크로 나누어진 텍스트 문서(간결성을 위해 자름)가 있는 공간에 대해 다음 JSON을 반환할 수 있습니다.

복사 
{
  "rag_space_id": "knowledge-base",
  "model": "multi-qa-MiniLM-L6-cos-v1",
  "entries": 4,
  "values": [
    {
      "id": 1,
      "filename": "Policies.pdf"
    },
    {
      "id": 2,
      "text": "반품 및 교환 처리에 대한 고객 지원 정책 및 절차..."
    },
    {
      "id": 2,
      "text": "반품하시려는 품목을 비롯한 모든 구성품을 함께 재포장해주셔야 합니다..."
    },
    {
      "id": 2,
      "text": "반품이 가능한 기간은 물품을 받으신 날짜로부터 14일 이내입니다..."
    }
  ]
}

예제 3 

작업을 수행하기 전에 스크립트에서 GetRAGSpaceInfo를 사용하여 RAG 공간이 존재하는지 확인합니다.

복사 
RAG 계정 구성[ RAG 계정 이름: "customer-support-rag-account" ; 엔드포인트: "https://myserver.example.com/llm/v1/" ; API 키: Global::RAG_API_Key ; SSL 인증서 확인 ]

변수 설정 [ $ragSpaceInfo ; 값: GetRAGSpaceInfo ( "customer-support-rag-account" ; "knowledge-base" ) ]

If [ PatternCount ( $ragSpaceInfo ; "[RAG 공간] 오류" ) > 0 or PatternCount ( $ragSpaceInfo ; "?" ) > 0 ]

    # RAG 공간이 존재하지 않습니다. 오류를 처리합니다.

    사용자 설정 대화상자 보기 [ "오류" ; "지정된 RAG 공간을 찾을 수 없습니다." ] 

Else

    # RAG 공간이 존재합니다. 작업을 진행합니다.
    
    변수 설정 [ $ragSpaceID ; 값: JSONGetElement ( $ragSpaceInfo ; "rag_space_id" ) ]
    
    사용자 설정 대화상자 보기 [ "공간 찾음" ; "RAG 공간 '" & $ragSpaceID & "'을(를) 사용할 수 있습니다." ]

End If

관련 주제