클라우드 스토리지 데이터 스토어 도구

이 도구는 자체 파일로 채워진 데이터 스토어에 연결하여 비정형 문서 또는 FAQ 콘텐츠에서 정보를 검색하고 가져오는 데 사용됩니다.

도구를 처음 만들 때 다음을 제공합니다.

  • 이름: AI가 도구의 작업을 이해하는 데 도움이 되는 설명이 포함된 이름입니다. 이름은 동사 (예: search_internal_docs 또는 query_product_manuals)로 시작해야 합니다.
  • 설명: (선택사항) 도구의 기능과 AI가 도구를 사용해야 하는 경우에 대한 설명입니다. 이를 통해 모델은 이 특정 데이터 스토어에 사용자의 프롬프트에 대한 답변이 포함되어 있는지 판단할 수 있습니다.
  • 모의 도구 응답: 데이터가 완전히 색인화되기 전에 테스트 목적으로 도구의 출력을 시뮬레이션하는 데 사용되는 선택적 구성입니다.
  • 위치: 데이터 스토어가 호스팅되는 리전입니다 (예: 전역).

  • 데이터 유형: 가져오는 콘텐츠의 형식입니다.

    • 비정형 데이터: PDF, HTML 파일, 텍스트 파일과 같은 문서에 가장 적합합니다.
    • FAQ: 구조화된 질문과 답변 쌍에 가장 적합합니다.

  • 폴더 또는 파일 선택: Google Cloud Storage (gs://*)에 있는 데이터의 경로입니다. 단일 파일 또는 전체 폴더를 가져올 수 있습니다.

  • 동기화 빈도: 도구에서 소스 파일의 업데이트를 확인하는 빈도입니다.

    • 일회성: 현재 데이터를 한 번 가져옵니다.
    • 주기적: 소스 파일이 변경되면 데이터 스토어를 자동으로 업데이트합니다 (생성 후에는 이 설정을 변경할 수 없음).

FAQ 데이터 스토어

FAQ 데이터 스토어에는 자주 묻는 질문 (FAQ)에 대한 답변이 있습니다. 사용자 질문이 업로드된 질문과 높은 신뢰도로 일치하면 에이전트는 해당 질문에 대한 답변을 수정하지 않고 반환합니다. 에이전트가 표시하는 각 질문과 답변 쌍의 제목과 URL을 제공할 수 있습니다.

데이터는 CSV 형식으로 데이터 스토어에 업로드해야 합니다. 각 파일에는 열을 설명하는 헤더 행이 있어야 합니다.

예를 들면 다음과 같습니다.

"question","answer","title","url"
"Why is the sky blue?","The sky is blue because of Rayleigh scattering.","Rayleigh scattering","https://en.wikipedia.org/wiki/Rayleigh_scattering"
"What is the meaning of life?","42","",""

title 및 url 열은 선택사항이며 생략할 수 있습니다.

"answer","question"
"42","What is the meaning of life?"

업로드 프로세스 중에 확장 프로그램에 관계없이 각 파일이 CSV 파일로 처리되는 폴더를 선택할 수 있습니다.

제한사항:

  • , 뒤에 추가 공백 문자가 있으면 오류가 발생합니다.
  • 빈 줄(파일 끝에 있는 경우에도)로 인해 오류가 발생합니다.

구조화되지 않은 데이터 스토어

구조화되지 않은 데이터 스토어에는 다음과 같은 형식의 콘텐츠가 포함될 수 있습니다.

  • HTML
  • PDF
  • TXT
  • CSV

다른 프로젝트의 Cloud Storage 버킷에서 파일을 가져올 수 있습니다 (일반적이지 않음). 이렇게 하려면 가져오기 프로세스에 명시적 액세스 권한을 부여해야 합니다. 오류 메시지에 가져오기를 실행하기 위해 버킷에 대한 읽기 액세스 권한이 필요한 사용자 이름이 포함되어 있으므로 해당 안내를 따르세요.

제한사항:

  • 최대 파일 크기는 텍스트 기반 형식의 경우 2.5MB, 다른 형식의 경우 100MB입니다.

Cloud Storage에서 가져오기도 참고하세요.