Mendapatkan laporan dengan Deep Research

Deep Research adalah agen Made by Google untuk pengguna yang perlu mengumpulkan, menganalisis, dan memahami informasi internal dan eksternal.

Ringkasan

Saat Anda memasukkan perintah ke Deep Research, seperti "Bandingkan pesaing Contoh Proyek", Deep Research akan menilai apakah pertanyaan tersebut terkait dengan penelitian, membuat rencana yang menguraikan langkah-langkah yang diperlukan untuk melakukan penelitian, dan mengalirkan pertanyaan dan jawaban saat penelitian berlangsung. Kemudian, Gemini akan membuat laporan temuan dengan kutipan serta ringkasan audio.

Untuk sumber riset, Deep Research menggunakan data yang diindeks oleh aplikasi. Aplikasi ini juga dapat menggunakan hasil web jika penelusuran web diaktifkan untuk aplikasi.

Berikut beberapa contoh perintah yang digunakan Deep Research untuk membuat laporan:

  • Bagaimana cara meningkatkan pengalaman pengguna aplikasi mobile banking yang sudah ada agar lebih intuitif dan mudah digunakan?
  • Bagaimana cara mengurangi waktu tunggu pelanggan selama jam sibuk tanpa mengurangi kualitas dukungan?
  • Menganalisis situasi ekonomi negara-negara Eropa Tengah.
  • Bandingkan BigQuery dengan pesaingnya, dan berikan hasilnya dalam format tabel.

Menggunakan Deep Research

Pengguna akhir Anda dapat mengakses dan menggunakan Deep Research melalui aplikasi. Deep Research memiliki akses ke data yang telah diindeks oleh aplikasi dan, jika diaktifkan, hasil web.

Anda bisa mendapatkan hasil dari Riset Mendalam dari aplikasi atau menggunakan API (Tersedia secara umum dengan daftar yang diizinkan).

Konsol

Untuk menggunakan Deep Research di aplikasi, lakukan hal berikut:

  1. Di menu navigasi aplikasi, buka Deep Research.

  2. Klik Sumber untuk memilih sumber yang harus disertakan oleh agen untuk memberikan insight data yang paling relevan.

    Di sumber, selain sumber Gemini Enterprise, Anda juga dapat memilih untuk menyertakan hasil Google Penelusuran.

  3. Masukkan perintah ke Deep Research, lalu klik Kirim. Jika perintah tidak terkait dengan riset, Deep Research akan membuat jawaban. Jika perintah ditentukan terkait dengan riset, Deep Research akan menguraikan topik yang akan diteliti oleh agen dalam rencana riset.

  4. Edit perintah agen, jika perlu, untuk membuat rencana riset baru yang lebih sesuai dengan persyaratan Anda.

  5. Jika rencana riset dapat diterima oleh Anda, klik Mulai Riset.

    Agen mulai melakukan riset berdasarkan rencana:

    • Menyampaikan topik yang sedang diteliti seiring kemajuannya
    • Membuat laporan temuan dengan kutipan
    • Membuat ringkasan audio laporan berdurasi 1-2 menit

REST

Untuk menggunakan Deep Research menggunakan API, lakukan hal berikut:

  1. Kirim permintaan ke metode streamAssist.

    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/v1/projects/project_id/locations/global/collections/default_collection/engines/app_id/assistants/default_assistant:streamAssist" \
-d '{
     "query": {
       "text": "QUERY"
     },
     "agentsSpec": {
       "agentSpecs": {
         "agentId": "deep_research"
       }
     },
     "toolsSpec": {
       "vertexAiSearchSpec": {
         "dataStoreSpecs": {
           "dataStore": "projects/PROJECT_ID/locations/global/collections/default_collection/datastores/DATA_STORE_ID"
         }
       },
       "webGroundingSpec": {}
     }
    }'

    Ganti kode berikut:

    • PROJECT_ID: ID Google Cloud project Anda.
    • APP_ID: ID aplikasi.
    • QUERY: kueri.
    • DATA_STORE_ID: ID penyimpanan data saat aplikasi memiliki beberapa penyimpanan data. Jika Anda menentukannya, penelusuran akan dibatasi pada dokumen di penyimpanan data yang ditentukan.

    Respons

    Jika permintaan Anda berhasil, Anda akan menerima respons JSON yang mirip dengan respons berikut. Perhatikan SESSION_ID. Hal ini diperlukan untuk memulai proses riset pada langkah berikutnya.

    [{
 "answer": {
   "name": "ANSWER_ASSIST_NAME",
   "state": "SUCCEEDED",
   "replies": [
     {
       "groundedContent": {
         "content": {
           "role": "model",
           "text": "INLINE_TEXT"
         }
       },
     },
     {
       "groundedContent": {
         "content": {
           "role": "model",
           "text": "INLINE_TEXT_WITH_RESEARCH_PLAN"
         },
         "contentMetadata": {
           "contentKind": "RESEARCH_PLAN"
         }
       },
     }
   ],
 },
 "sessionInfo": {
   "session": "SESSION_ID",
   "queryId": "QUERY_ID",
   "turnId": "TURN_ID"
 },
 "assistToken": "ASSIST_TOKEN"
}
]

  2. Mulai riset untuk kueri pada langkah sebelumnya. Untuk melakukannya, kirim permintaan lain ke metode streamAssist. Dalam permintaan ini, tetapkan kueri Anda sebagai Start Research dan tambahkan informasi sesi dari langkah sebelumnya.

    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/v1/projects/project_id/locations/global/collections/default_collection/engines/app_id/assistants/default_assistant:streamAssist" \
-d '{
     "query": {
       "text": "Start Research"
     },
     "session": "SESSION_ID",
     "agentsSpec": {
       "agentSpecs": {
         "agentId": "deep_research"
       }
     },
     "toolsSpec": {
       "vertexAiSearchSpec": {
         "dataStoreSpecs": {
           "dataStore": "projects/PROJECT_ID/locations/global/collections/default_collection/datastores/DATA_STORE_ID"
         }
       },
       "webGroundingSpec": {}
     },
    }'

    Ganti kode berikut:

    • PROJECT_ID: ID Google Cloud project Anda.
    • APP_ID: ID aplikasi.
    • SESSION_ID: ID sesi dari langkah sebelumnya.
    • DATA_STORE_ID: ID penyimpanan data saat aplikasi memiliki beberapa penyimpanan data. Jika Anda menentukannya, penelusuran akan dibatasi pada dokumen di penyimpanan data yang ditentukan.

    Respons

    Jika permintaan Anda berhasil, Anda akan menerima respons JSON yang mirip dengan respons yang dipangkas berikut.

    Respons berisi instance resource AssistAnswer.

    Ini adalah respons streaming dan, oleh karena itu, bergantung pada jumlah data dalam respons riset, mungkin diperlukan waktu beberapa saat untuk melakukan streaming sepenuhnya.

    [{
 "answer": {
   "state": "IN_PROGRESS",
   "replies": [
     {
       "groundedContent": {
         "content": {
           "role": "model",
           "text": "RESEARCH_QUESTION_1"
         },
         "contentMetadata": {
           "contentKind": "RESEARCH_QUESTION",
           "contentId": "ID0"
         }
       },
     }
   ]
 },
 "assistToken": "ASSIST_TOKEN"
},
{
 "answer": {
   "state": "IN_PROGRESS",
   "replies": [
     {
       "groundedContent": {
         "content": {
           "role": "model",
           "text": "RESEARCH_ANSWER_1_PART_1"
         },
         "contentMetadata": {
           "contentKind": "RESEARCH_ANSWER",
           "contentId": "ID0"
         }
       },
     }
   ]
 },
 "assistToken": "ASSIST_TOKEN"
},
{
 "answer": {
   "state": "IN_PROGRESS",
   "replies": [
     {
       "groundedContent": {
         "content": {
           "role": "model",
           "text": "RESEARCH_ANSWER_1_PART_2"
         },
         "contentMetadata": {
           "contentKind": "RESEARCH_ANSWER",
           "contentId": "ID0"
         }
       },
     }
   ]
 },
 "assistToken": "ASSIST_TOKEN"
},
{
 "answer": {
   "state": "IN_PROGRESS",
   "replies": [
     {
       "groundedContent": {
         "content": {
           "role": "model",
           "text": "INLINE_TEXT"
         },
         "textGroundingMetadata": {
           "references": [
             {
               "documentMetadata": {
                 "document": "DOCUMENT_ID",
                 "uri": "DOCUMENT_REDIRECT_URI",
                 "title": "DOCUMENT_TITLE",
                 "pageIdentifier": "",
                 "domain": "DOCUMENT_DOMAIN"
               }
             }
           ]
           "searchEntryPoints": [
             {
               "renderedContent": "GROUNDING_SEARCH_ENTRY_POINT"
             }
           ]
          }
        }
      }
    ]
  }
},
{
 "answer": {
   "state": "IN_PROGRESS",
   "replies": [
     {
       "groundedContent": {
         "content": {
           "role": "model",
           "file": {
             "fileId": "AUDIO_FILE_ID"
           }
         },
         "contentMetadata": {
           "contentKind": "RESEARCH_AUDIO_SUMMARY"
         }
       },
     }
   ]
 },
 "assistToken": "ASSIST_TOKEN"
}
{
 "answer": {
   "name": "ANSWER_ASSIST_NAME",
   "state": "SUCCEEDED"
   },
 "sessionInfo": {
   "session": "SESSION_ID",
   "queryId": "QUERY_ID",
   "turnId": "TURN_ID"
 },
"assistToken": "ASSIST_TOKEN"
}]