Es un mensaje dentro de una conversación.
| Representación JSON |
|---|
{
"role": string,
"chunks": [
{
object ( |
| Campos | |
|---|---|
role |
Es opcional. Es el rol dentro de la conversación, p.ej., usuario, agente. |
chunks[] |
Es opcional. Es el contenido del mensaje como una serie de fragmentos. |
eventTime |
Es opcional. Es la marca de tiempo del momento en que se envió o recibió el mensaje. No se debe usar si el mensaje forma parte de un 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: |
Bandinsecto
Es un fragmento de contenido dentro de un mensaje.
| Representación JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "text": string, "transcript": string, "blob": { object ( |
| Campos | |
|---|---|
| Datos de fragmentos La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta: | |
text |
Es opcional. Datos de texto. |
transcript |
Es opcional. Es la transcripción asociada al audio. |
blob |
Es opcional. Datos de BLOB. |
payload |
Es opcional. Datos de carga útil personalizados. |
image |
Es opcional. Son los datos de la imagen. |
toolCall |
Es opcional. Es la solicitud de ejecución de la herramienta. |
toolResponse |
Es opcional. Es la respuesta de la ejecución de la herramienta. |
agentTransfer |
Es opcional. Evento de transferencia de agente. |
updatedVariables |
Un struct representa las variables que se actualizaron en la conversación, con clave por nombres de variables. |
defaultVariables |
Un struct representa las variables predeterminadas al inicio de la conversación, con clave por nombres de variables. |
| Fin de los campos mutuamente excluyentes. | |
BLOB
Representa una entrada o salida de BLOB en la conversación.
| Representación JSON |
|---|
{ "mimeType": string, "data": string } |
| Campos | |
|---|---|
mimeType |
Obligatorio. Es el tipo de MIME estándar de IANA de los datos de origen. |
data |
Obligatorio. Son los bytes sin procesar del BLOB. Es una cadena codificada en Base64. |
Imagen
Representa una entrada o salida de imagen en la conversación.
| Representación JSON |
|---|
{ "mimeType": string, "data": string, "altText": string } |
| Campos | |
|---|---|
mimeType |
Obligatorio. Es el tipo de MIME estándar de IANA de los datos de origen. Los tipos de imágenes compatibles incluyen los siguientes: * image/png * image/jpeg * image/webp |
data |
Obligatorio. Son los bytes sin procesar de la imagen. Es una cadena codificada en Base64. |
altText |
Es opcional. Es el texto alternativo de la imagen. |
ToolCall
Solicitud para que el cliente o el agente ejecuten la herramienta especificada.
| Representación JSON |
|---|
{
"id": string,
"displayName": string,
"args": {
object
},
"parentToolCallId": string,
"agentName": string,
"targetApp": string,
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"tool": string,
"toolsetTool": {
object ( |
| Campos | |
|---|---|
id |
Es opcional. Es el identificador único de la llamada a la herramienta. Si se completa, el cliente debe devolver el resultado de la ejecución con el ID para coincidencias en |
displayName |
Solo salida. Es el nombre visible de la herramienta. |
args |
Es opcional. Son los parámetros y valores de entrada de la herramienta en formato de objeto JSON. |
parentToolCallId |
Solo salida. Es el ID de la llamada a la herramienta que causó esta, cuando la emitió un agente secundario que trabaja en nombre de una llamada superior. Está vacío para las llamadas de nivel superior. Permite que un cliente agrupe el trabajo de un agente secundario en la llamada que lo inició, en lugar de renderizar cada paso como un elemento hermano. |
agentName |
Solo salida. Nombre legible por humanos del agente que emitió esta llamada, p.ej., "Arquitecto de contratos". Está vacío cuando lo emite el agente raíz. |
targetApp |
Solo salida. La app a la que se dirige esta llamada, derivada por el asistente a partir de los argumentos de recursos de la llamada: un nombre de recurso de app, |
| Es el identificador de la herramienta que se ejecutará. Puede ser una herramienta persistente o una herramienta de un conjunto de herramientas. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta: | |
tool |
Es opcional. Es el nombre de la herramienta que se ejecutará. Formato: |
toolsetTool |
Es opcional. Es la herramienta del conjunto de herramientas que se ejecutará. |
| Fin de los campos mutuamente excluyentes. | |
ToolsetTool
Es una herramienta que se crea a partir de un conjunto de herramientas.
| Representación JSON |
|---|
{ "toolset": string, "toolId": string } |
| Campos | |
|---|---|
toolset |
Obligatorio. Es el nombre del recurso del conjunto de herramientas del que se deriva esta herramienta. Formato: |
toolId |
Es opcional. Es el ID de la herramienta para filtrar las herramientas de las que se recuperará el esquema. |
ToolResponse
Es el resultado de la ejecución de una herramienta específica del cliente o del agente.
| Representación JSON |
|---|
{
"id": string,
"displayName": string,
"response": {
object
},
"parentToolCallId": string,
"agentName": string,
"targetApp": string,
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"tool": string,
"toolsetTool": {
object ( |
| Campos | |
|---|---|
id |
Es opcional. Es el ID para coincidencias del |
displayName |
Solo salida. Es el nombre visible de la herramienta. |
response |
Obligatorio. Es el resultado de la ejecución de la herramienta en formato de objeto JSON. Usa la clave "output" para especificar la respuesta de la herramienta y la clave "error" para especificar los detalles del error (si los hay). Si no se especifican las claves "output" y "error", toda la "response" se trata como el resultado de la ejecución de la herramienta. |
parentToolCallId |
Solo salida. Es el ID de la llamada a la herramienta que causó esta, cuando la emitió un agente secundario que trabaja en nombre de una llamada superior. Está vacío para las llamadas de nivel superior. Permite que un cliente agrupe el trabajo de un agente secundario en la llamada que lo inició, en lugar de renderizar cada paso como un elemento hermano. |
agentName |
Solo salida. Nombre legible por humanos del agente que emitió esta llamada, p.ej., "Arquitecto de contratos". Está vacío cuando lo emite el agente raíz. |
targetApp |
Solo salida. Es la app a la que se orientó la herramienta ejecutada; refleja |
| Es el identificador de la herramienta que se ejecutó. Puede ser una herramienta persistente o una herramienta de un conjunto de herramientas. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta: | |
tool |
Es opcional. Es el nombre de la herramienta que se ejecutará. Formato: |
toolsetTool |
Es opcional. Es la herramienta del conjunto de herramientas que se ejecutó. |
| Fin de los campos mutuamente excluyentes. | |
AgentTransfer
Representa un evento que indica la transferencia de una conversación a un agente diferente.
| Representación JSON |
|---|
{ "targetAgent": string, "displayName": string } |
| Campos | |
|---|---|
targetAgent |
Obligatorio. Es el agente al que se transfiere la conversación. El agente se encargará de la conversación a partir de este punto. Formato: |
displayName |
Solo salida. Es el nombre visible del agente. |