Esta página se ha traducido con Cloud Translation API.

Obtener informes con Investigación a fondo

Deep Research es un agente creado por Google para los usuarios que necesitan recoger, analizar y comprender información interna y externa.

Información general

Cuando introduces una petición en Deep Research, como "Compara los competidores del proyecto de ejemplo", Deep Research evalúa si la pregunta está relacionada con una investigación, genera un plan que describe los pasos que debe seguir para llevar a cabo la investigación y transmite preguntas y respuestas a medida que avanza en su investigación. A continuación, genera un informe con sus conclusiones y citas, así como un resumen de audio.

En el caso de las fuentes de investigación, Deep Research usa los datos que indexa la aplicación. También puede usar resultados web si la búsqueda web está habilitada en la aplicación.

Aquí tienes algunos ejemplos de peticiones para las que Deep Research genera informes:

¿Cómo podemos mejorar la experiencia de usuario de nuestra aplicación de banca móvil para que sea más intuitiva y fácil de usar?
¿Cómo podemos reducir los tiempos de espera de los clientes durante las horas punta sin comprometer la calidad de la asistencia?
Analizar la situación económica de los países de Europa Central.
Compara BigQuery con sus competidores y ofrece los resultados en formato de tabla.

Usar Deep Research

Tus usuarios finales pueden acceder a Deep Research y usarlo a través de la aplicación. Deep Research tiene acceso a los datos que la aplicación ya ha indexado y, si está habilitado, a los resultados web.

Puedes obtener resultados de Investigación a fondo desde la aplicación o mediante la API (disponible de forma general con una lista de permitidos).

Consola

Para usar Deep Research en la aplicación, sigue estos pasos:

En el menú de navegación de la aplicación, ve a Investigación a fondo.
Haz clic en Fuentes para seleccionar las fuentes que debe incluir el agente para proporcionar las estadísticas de datos más relevantes.

En las fuentes, además de las fuentes de Gemini Enterprise, también puedes incluir resultados de la Búsqueda de Google.
Escribe una petición para Investigación a fondo y haz clic en Enviar. Si la petición no está relacionada con una investigación, Deep Research genera una respuesta. Si se determina que la petición está relacionada con una investigación, Deep Research describe los temas que el agente tiene previsto investigar en un plan de investigación.
Edita la petición del agente, si es necesario, para generar un nuevo plan de investigación que se ajuste mejor a tus requisitos.
Si el plan de investigación te parece adecuado, haz clic en Iniciar investigación.

El agente empieza a investigar según el plan:
- Transmite los temas que está investigando a medida que avanza.
- Genera un informe de resultados con citas
- Crea un resumen de audio de 1 o 2 minutos del informe

REST

Para usar Deep Research con la API, sigue estos pasos:

Envía una solicitud al método 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": {}
     }
    }'

Haz los cambios siguientes:

PROJECT_ID: el ID de tu proyecto de Google Cloud .
APP_ID: el ID de la aplicación.
QUERY: la consulta.
DATA_STORE_ID: el ID del almacén de datos cuando una aplicación tiene varios almacenes de datos. Si lo especifica, la búsqueda se limitará a los documentos del almacén de datos indicado.

Respuesta

Si la solicitud se realiza correctamente, recibirás una respuesta JSON similar a la siguiente. Ten en cuenta la SESSION_ID. Es necesario para iniciar el proceso de investigación en el siguiente paso.

[{
 "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"
}
]

Inicia la investigación de la consulta del paso anterior. Para ello, envía otra solicitud al método streamAssist. En esta solicitud, define tu consulta como Start Research y añade la información de la sesión del paso anterior.

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": {}
     },
    }'

Haz los cambios siguientes:

PROJECT_ID: el ID de tu proyecto de Google Cloud .
APP_ID: el ID de la aplicación.
SESSION_ID: el ID de sesión del paso anterior.
DATA_STORE_ID: el ID del almacén de datos cuando una aplicación tiene varios almacenes de datos. Si lo especifica, la búsqueda se limitará a los documentos del almacén de datos indicado.

Respuesta

Si la solicitud se realiza correctamente, recibirás una respuesta JSON similar a la siguiente respuesta truncada.

La respuesta contiene una instancia del recurso AssistAnswer.

Se trata de una respuesta de streaming y, por lo tanto, en función de la cantidad de datos que contenga la respuesta de la investigación, puede tardar un tiempo en transmitirse por completo.

[{
 "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"
}]

Obtener informes con Investigación a fondo Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Información general

Usar Deep Research

Consola

REST

Respuesta

Respuesta

Obtener informes con Investigación a fondo