Mendapatkan laporan dengan Deep Research

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

Catatan: Agen Made by Google tidak tersedia di edisi Gemini Enterprise Frontline.

Ringkasan

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

Untuk sumber riset, Deep Research menggunakan data yang diindeks oleh aplikasi. Deep Research 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 ada agar lebih intuitif dan mudah digunakan?
• Bagaimana cara mengurangi waktu tunggu pelanggan selama jam puncak tanpa mengorbankan kualitas dukungan?
• Analisis situasi ekonomi negara-negara Eropa Tengah.
• Bandingkan BigQuery dengan pesaingnya, dan berikan hasilnya dalam format tabel.

Menggunakan Deep Research

Pengguna akhir 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 Deep Research dari aplikasi atau menggunakan API (Umumnya tersedia 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 riset, Deep Research akan membuat jawaban. Jika perintah ditentukan terkait riset, Deep Research akan menguraikan topik yang direncanakan untuk diteliti oleh agen dalam rencana riset.

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

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

   Agen akan mulai melakukan riset berdasarkan rencana:

   • Menayangkan topik yang diteliti saat riset berlangsung
   • Membuat laporan temuan dengan kutipan
   • Membuat ringkasan audio laporan berdurasi 1-2 menit

REST

Catatan: Riset mendalam menggunakan API Umumnya tersedia dengan daftar yang diizinkan. Anda harus berada dalam daftar yang diizinkan untuk menggunakan agen ini menggunakan API.

Untuk menggunakan Deep Research menggunakan API, lakukan hal berikut:

1. Kirim permintaan ke streamAssist metode.

   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 proyek Anda Google Cloud .
   • APP_ID: ID aplikasi.
   • QUERY: kueri.
   • DATA_STORE_ID: ID penyimpanan data jika aplikasi memiliki beberapa penyimpanan data. Jika Anda menentukan ID ini, 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. ID 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 streamAssist metode. 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 proyek Anda Google Cloud .
   • APP_ID: ID aplikasi.
   • SESSION_ID: ID sesi dari langkah sebelumnya.
   • DATA_STORE_ID: ID penyimpanan data jika aplikasi memiliki beberapa penyimpanan data. Jika Anda menentukan ID ini, 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.

   Respons ini adalah respons streaming dan, oleh karena itu, bergantung pada jumlah data dalam respons riset, mungkin perlu 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"
   }]