REST Resource: projects.locations.collections.dataStores.sessions

Recurso: Session

Definición externa del protocolo de sesión.

Representación JSON 
{
  "name": string,
  "displayName": string,
  "state": enum (State),
  "userPseudoId": string,
  "turns": [
    {
      object (Turn)
    }
  ],
  "labels": [
    string
  ],
  "startTime": string,
  "endTime": string,
  "isPinned": boolean,
  "pendingAsyncAssistOperationId": string
}
Campos
name

string

Inmutable. Nombre completamente calificado projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*
displayName

string

Es opcional. El nombre visible de la sesión.

Este campo se usa para identificar la sesión en la IU. De forma predeterminada, el nombre visible es el texto de la primera consulta de turno en la sesión.
state

enum (State)

El estado de la sesión.
userPseudoId

string

Un identificador único para hacer un seguimiento de los usuarios.
turns[]

object (Turn)

Turnos.
labels[]

string

Es opcional. Las etiquetas de la sesión. Se pueden establecer como filtro en ListSessionsRequest.
startTime

string (Timestamp format)

Solo salida. La hora en que comenzó la sesión.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo salida. La hora en que finalizó la sesión.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
isPinned

boolean

Es opcional. Indica si la sesión está fijada. La sesión fijada se mostrará en la parte superior de la lista de sesiones.
pendingAsyncAssistOperationId

string

Solo salida. Nombre completo del recurso de una operación AsyncAssist en curso para esta sesión, p.ej., projects/*/locations/*/collections/*/engines/*/sessions/*/operations/*. Se establece cuando comienza la operación y se borra cuando finaliza.

Estado

Enumeración del estado de la sesión.

Enums
STATE_UNSPECIFIED El estado no se especifica.
IN_PROGRESS La sesión está abierta en este momento.

Turno

Representa un turno, incluida una consulta del usuario y una respuesta del servicio.

Representación JSON 
{
  "query": {
    object (Query)
  },
  "answer": string,
  "assistAnswer": string,
  "detailedAnswer": {
    object (Answer)
  },
  "detailedAssistAnswer": {
    object (AssistAnswer)
  },
  "queryConfig": {
    string: string,
    ...
  },
  "live": boolean
}
Campos
query

object (Query)

Es opcional. La consulta del usuario. Es posible que no se establezca si este turno solo regenera una respuesta a un turno diferente.
answer

string

Es opcional. El nombre del recurso de la respuesta a la consulta del usuario.

Solo se establece si la generación de respuestas (llamada a la API de /answer) ocurrió en este turno.
assistAnswer

string

Solo salida. El nombre del recurso de la respuesta del Asistente a la consulta del usuario.

Solo se establece si se realizó una llamada de asistencia (llamada a la API de /assist) en este turno.

Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assistAnswer}. Para obtener todas las AssistAnswers de una sesión, establece GetSessionRequest.include_answer_details como verdadero. Como alternativa, para obtener un recurso AssistAnswer individual, usa la API de AssistAnswerService.GetAssistAnswer.
detailedAnswer

object (Answer)

Solo salida. En la API de ConversationalSearchService.GetSession, si GetSessionRequest.include_answer_details se establece como verdadero, este campo se propagará cuando se obtenga la sesión de consulta de respuesta.
detailedAssistAnswer

object (AssistAnswer)

Solo salida. En la API de ConversationalSearchService.GetSession, si GetSessionRequest.include_answer_details se establece como verdadero, este campo se propagará cuando se obtenga la sesión del Asistente.
queryConfig

map (key: string, value: string)

Es opcional. Representa metadatos relacionados con la configuración de la consulta, por ejemplo, el modelo y la versión de LLM que se usaron, los parámetros del modelo (temperatura, parámetros de fundamentación, etcétera). El prefijo "google." está reservado para la funcionalidad desarrollada por Google.
live

boolean

Es opcional. Indica si este turno es un turno en vivo.

Métodos

create

 Crea una sesión.

delete

 Borra una sesión.

get

 Obtiene una sesión.

list

 Enumera todas las sesiones por su DataStore superior.

patch

 Actualiza una sesión.