어시스턴트에 콘텐츠 업로드

API를 사용하여 어시스턴트에 파일을 업로드할 수 있습니다. 이러한 파일은 어시스턴트와 채팅할 때 사용할 수 있습니다. 어시스턴트 내에서 파일을 업로드하는 방법에 대한 자세한 내용은 파일 업로드 및 파일에 관한 채팅을 참고하세요.

API를 사용하여 어시스턴트에 콘텐츠를 업로드하려면 다음 curl 명령어를 실행합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/sessions/SESSION_ID:addContextFile" \
-d '{
      "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/sessions/SESSION_ID",
      "fileName": "FILE_NAME",
      "mimeType": "MIME_TYPE",
      "fileContents": "BASE64_ENCODED_FILE",
    }'

다음을 바꿉니다.

  • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
  • APP_ID: 앱의 ID입니다.
  • SESSION_ID: 세션 ID입니다. 세션 정보 저장 및 응답 가져오기에 표시된 대로 세션 생성 응답에서 이 ID를 가져올 수 있습니다.
  • FILE_NAME: 파일의 이름입니다.
  • MIME_TYPE: 파일의 MIME 유형입니다.
  • BASE64_ENCODED_FILE: 데이터의 base64 표현(ASCII 문자열)입니다. 이 문자열은 /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q== 문자열과 비슷해야 합니다.

명령어 및 응답 예시:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: 1234" \
"https://discoveryengine.googleapis.com/v1alpha/projects/1234/locations/global/collections/default_collection/engines/myapp/sessions/16002628354770206943:addContextFile" \
-d '{
      "name": "projects/1234/locations/global/collections/default_collection/engines/myapp/sessions/16002628354770206943",
      "fileName": "Hello World.pdf",
      "mimeType": "application/pdf",
      "fileContents": JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UaXRsZSAoSGVsbG8gd29ybGQpCi9Qcm9kdWNlciAoU2tpYS9QREYgbTEzMCBHb29nbGUgRG9jcyBSZW5kZXJlcik+PgplbmRvYmoKMyAwIG9iago8PC..............KMDAwMDAxNDk0NCAwMDAwMCBuIAp0cmFpbGVyCjw8L1NpemUgMTIKL1Jvb3QgNyAwIFIKL0luZm8gMSAwIFI+PgpzdGFydHhyZWYKMTU0NjYKJSVFT0YK",
    }'
------------------
{
  "session": "projects/1234/locations/global/collections/default_collection/engines/myapp/sessions/16002628354770206943",
  "fileId": "11157546467692423460",
  "tokenCount": "258"
}