REST Resource: projects.locations.collections.engines.agents

Recurso: Agente

Realiza una tarea específica predefinida.

Representación JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "icon": {
    object (Image)
  },
  "createTime": string,
  "updateTime": string,
  "authorizations": [
    string
  ],
  "authorizationConfig": {
    object (AuthorizationConfig)
  },
  "dataStoreSpecs": {
    object (DataStoreSpecs)
  },
  "state": enum (State),
  "toolSettings": {
    object (AgentToolSettings)
  },
  "languageCode": string,
  "starterPrompts": [
    {
      object (StarterPrompt)
    }
  ],
  "customPlaceholderText": string,

  // Union field definition can be only one of the following:
  "adkAgentDefinition": {
    object (AdkAgentDefinition)
  },
  "managedAgentDefinition": {
    object (ManagedAgentDefinition)
  },
  "a2aAgentDefinition": {
    object (A2AAgentDefinition)
  },
  "dialogflowAgentDefinition": {
    object (DialogflowAgentDefinition)
  }
  // End of list of possible types for union field definition.

  // Union field agent_state_reason can be only one of the following:
  "suspensionReason": string,
  "rejectionReason": string,
  "deploymentFailureReason": string
  // End of list of possible types for union field agent_state_reason.
}
Campos
name

string

Es el identificador. Es el nombre del recurso del agente. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent} o projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/agents/{agent}
displayName

string

Obligatorio. Es el nombre visible del agente. Un LLM podría usar esta descripción para seleccionar automáticamente un agente que responda a una consulta del usuario.
description

string

Obligatorio. Es una descripción del agente legible por humanos. Un LLM podría usar esta descripción para seleccionar automáticamente un agente que responda a una consulta del usuario.
icon

object (Image)

Opcional. Ícono que representa al agente en la IU.
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la creación de este agente.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. 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".
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la actualización más reciente de este agente.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. 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".
authorizations[]
(deprecated)

string

Opcional. Obsoleto: Usa Agent.authorization_config en su lugar. Es la lista de autorizaciones requeridas para este agente.
authorizationConfig

object (AuthorizationConfig)

Opcional. Son las autorizaciones que requiere el agente.
dataStoreSpecs

object (DataStoreSpecs)

Opcional. Son los DataStoreSpecs asociados con el agente. Si no se configura este campo, se usarán todos los almacenes de datos del motor.
state

enum (State)

Solo salida. Es el estado del ciclo de vida del agente.
toolSettings
(deprecated)

object (AgentToolSettings)

Opcional. OBSOLETO: Se planeó la migración a la definición de AgentCard.
languageCode

string

Opcional. Es el código del idioma del texto en los campos description, displayName y starterPrompts.
starterPrompts[]

object (StarterPrompt)

Opcional. Son las sugerencias de instrucciones iniciales que se muestran al usuario en la página de destino del agente.
customPlaceholderText

string

Opcional. Es el texto de marcador de posición personalizado que aparece en el cuadro de texto antes de que el usuario ingrese texto.
Campo de unión definition. Es la definición del agente. LINT.IfChange(definition) definition puede ser solo una de las siguientes opciones:
adkAgentDefinition

object (AdkAgentDefinition)

Opcional. El comportamiento del agente se define como un agente de ADK.
managedAgentDefinition

object (ManagedAgentDefinition)

Opcional. Es el comportamiento del agente administrado por Google.
a2aAgentDefinition

object (A2AAgentDefinition)

Opcional. El comportamiento del agente se define como un agente de A2A.
dialogflowAgentDefinition

object (DialogflowAgentDefinition)

Opcional. El comportamiento del agente se define como un agente de Dialogflow.
Campo de unión agent_state_reason. Es el motivo por el que el agente se encuentra en su estado actual. agent_state_reason puede ser solo uno de los siguientes:
suspensionReason

string

Solo salida. Es el motivo por el que se suspendió al agente. Solo se establece si el estado es SUSPENDED.
rejectionReason

string

Solo salida. Es el motivo por el que se rechazó al agente. Solo se establece si el estado es PRIVATE y se llegó a él por rechazo.
deploymentFailureReason

string

Solo salida. Es el motivo por el que falló la implementación del agente. Solo se establece si el estado es DEPLOYMENT_FAILED.

AdkAgentDefinition

Almacena la definición de un agente que usa el ADK y se implementa en Agent Engine (anteriormente conocido como Reasoning Engine).

Representación JSON 
{
  "toolSettings": {
    object (AgentToolSettings)
  },
  "provisionedReasoningEngine": {
    object (ProvisionedReasoningEngine)
  },
  "authorizations": [
    string
  ]
}
Campos
toolSettings

object (AgentToolSettings)

Opcional. Son los parámetros que definen cómo se presenta el agente al LLM del planificador.
provisionedReasoningEngine

object (ProvisionedReasoningEngine)

Opcional. Es el motor de razonamiento al que está conectado el agente.
authorizations[]
(deprecated)

string

Opcional. OBSOLETO: Usa Agent.authorizations en su lugar. Son los nombres de los recursos de las autorizaciones requeridas. Si el usuario no está autorizado, el servicio devolverá una cantidad de URIs de autorización que el usuario debe abrir en un navegador y autorizar. Una vez que se otorgan todas las autorizaciones, el usuario puede volver a intentar la búsqueda y las autorizaciones se reenviarán al agente.

Formato: projects/{project}/locations/{location}/authorizations/{authorization}

AgentToolSettings

Es la configuración de la herramienta que representa al agente para el LLM del planificador de Agentspace.

Representación JSON 
{
  "toolDescription": string,
  "inputParameterName": string,
  "inputParameterDescription": string
}
Campos
toolDescription

string

Obligatorio. Un LLM podría usarla para describir cuándo se debe usar el agente.
inputParameterName

string

Opcional. Nombre del parámetro para la llamada a función. El nombre de este parámetro le dará una pista al LLM sobre el tipo de contenido que se espera que contenga el parámetro, p.ej., una "pregunta", un "comando", una "búsqueda", etcétera.
inputParameterDescription

string

Opcional. Descripción del parámetro para la llamada a función. Esta descripción le proporcionará al LLM más información sobre el parámetro, p. ej., qué tipo de contenido se espera que se pase y qué acciones se deben realizar en él.

ProvisionedReasoningEngine

Realiza un seguimiento del motor de razonamiento al que está conectado el agente. Este mensaje no tiene como objetivo hacer un seguimiento del ciclo de vida del agente. En cambio, solo se usa para definir parámetros para conectarse al agente que ya se implementó en un motor de inferencia.

Representación JSON 
{
  "reasoningEngine": string
}
Campos
reasoningEngine

string

Obligatorio. Es el motor de razonamiento al que está conectado el agente. Formato: projects/{project}/locations/{location}/reasoningEngines/{reasoningEngine}

ManagedAgentDefinition

Almacena la definición de un agente administrado por Google.

Representación JSON 
{
  "toolSettings": {
    object (AgentToolSettings)
  },
  "authorizations": [
    string
  ],
  "deploymentInfo": {
    object (DeploymentInfo)
  },

  // Union field agent_config can be only one of the following:
  "dataScienceAgentConfig": {
    object (DataScienceAgentConfig)
  }
  // End of list of possible types for union field agent_config.
}
Campos
toolSettings

object (AgentToolSettings)

Opcional. Son los parámetros que definen cómo se presenta el agente al LLM del planificador.
authorizations[]
(deprecated)

string

Opcional. OBSOLETO: Usa Agent.authorizations en su lugar. Son los nombres de los recursos de las autorizaciones requeridas. Si el usuario no está autorizado, el servicio devolverá una cantidad de URIs de autorización que el usuario debe abrir en un navegador y autorizar. Una vez que se otorgan todas las autorizaciones, el usuario puede volver a intentar la búsqueda y las autorizaciones se reenviarán al agente.

Formato: projects/{project}/locations/{location}/authorizations/{authorization}
deploymentInfo

object (DeploymentInfo)

Solo salida. Es la información de implementación automática del agente.
Campo de unión agent_config. Es la configuración específica del tipo de agente. agent_config puede ser solo uno de los siguientes:
dataScienceAgentConfig

object (DataScienceAgentConfig)

Opcional. Es la configuración específica de los agentes de ciencia de datos prediseñados de Google. Esta estructura de datos está diseñada para almacenar la configuración de la implementación y el tiempo de solicitud del agente.

DataScienceAgentConfig

Es la configuración específica de los agentes de ciencia de datos prediseñados de Google. Esta estructura de datos está diseñada para almacenar la configuración de la implementación y el tiempo de solicitud del agente.

Representación JSON 
{
  "bqProjectId": string,
  "bqDatasetId": string,
  "blocklistTables": [
    string
  ],
  "allowlistTables": [
    string
  ],
  "nlQueryConfig": {
    object (NlQueryConfig)
  }
}
Campos
bqProjectId

string

Obligatorio. Es el ID del proyecto de BigQuery en el que se encuentra el conjunto de datos.
bqDatasetId

string

Obligatorio. Es el ID del conjunto de datos de BigQuery que se usará para el agente. El conjunto de datos debe estar en el proyecto especificado por bqProjectId.
blocklistTables[]

string

Opcional. Son las tablas de BigQuery que se bloquearán para que el agente no las use.
allowlistTables[]

string

Opcional. Tablas de BigQuery que se pueden usar por el agente.
nlQueryConfig

object (NlQueryConfig)

Opcional. Es la configuración proporcionada por el cliente.

NlQueryConfig

Define la configuración proporcionada por el cliente específica para la traducción de lenguaje natural a código SQL o Python.

Representación JSON 
{
  "nl2sqlPrompt": string,
  "nl2pyPrompt": string,
  "nl2sqlExamples": [
    {
      object (Nl2SqlExample)
    }
  ],
  "schemaDescription": string,
  "bqSqlGenUseCustomPrompt": boolean
}
Campos
nl2sqlPrompt

string

Opcional. El cliente proporcionó instrucciones de NL2SQL
nl2pyPrompt

string

Opcional. El cliente proporcionó instrucciones para que el LLM escriba código de Python para el análisis de datos.
nl2sqlExamples[]

object (Nl2SqlExample)

Opcional. Son los ejemplos de NL2SQL proporcionados por el cliente, que incluyen tanto la entrada como el SQL esperado.
schemaDescription

string

Opcional. Es la descripción en lenguaje natural del esquema del conjunto de datos de BigQuery.
bqSqlGenUseCustomPrompt

boolean

Opcional. Indica si se debe usar la instrucción personalizada para el servicio de BigQuery SQL Gen.

Nl2SqlExample

Es un solo ejemplo de NL2SQL.

Representación JSON 
{
  "query": string,
  "expectedSql": string,
  "expectedResponse": string
}
Campos
query

string

Opcional. Es la pregunta en lenguaje natural que se responderá.
expectedSql

string

Opcional. Es el resultado esperado de SQL.
expectedResponse

string

Opcional. Es la respuesta esperada a la búsqueda.

DeploymentInfo

Es la información de implementación automática del agente.

Representación JSON 
{
  "operation": string,
  "finishTime": string
}
Campos
operation

string

Solo salida. Es el recurso de operación de larga duración para la implementación. Se puede usar para sondear el estado de la implementación. Cuando finalice la implementación, este campo estará vacío. Si falla la implementación,el campo contendrá el nombre del recurso del LRO fallido, pero el recurso de la operación en sí se borrará automáticamente después de un tiempo.
finishTime

string (Timestamp format)

Solo salida. Hora de finalización de la Deployment: Solo se configura si la implementación finalizó o falló.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. 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".

A2AAgentDefinition

Es la definición almacenada de un agente que usa A2A.

Representación JSON 
{

  // Union field agent_card can be only one of the following:
  "jsonAgentCard": string,
  "remoteAgentCard": {
    object (RemoteAgentcard)
  }
  // End of list of possible types for union field agent_card.
}
Campos
Campo de unión agent_card. El nombre, las capacidades, la información de autorización, etc., del agente de la tienda agent_card solo pueden ser uno de los siguientes:
jsonAgentCard

string

Opcional. La tarjeta del agente es una cadena JSON.
remoteAgentCard

object (RemoteAgentcard)

Opcional. Es una tarjeta de agente remoto.

RemoteAgentcard

Es la definición de una tarjeta de agente alojada de forma remota.

Representación JSON 
{
  "uri": string
}
Campos
uri

string

Obligatorio. Es el URI de la tarjeta del agente.

DialogflowAgentDefinition

Es la definición almacenada de un agente que usa un agente de Dialogflow.

Representación JSON 
{
  "toolSettings": {
    object (AgentToolSettings)
  },
  "dialogflowAgent": string
}
Campos
toolSettings

object (AgentToolSettings)

Opcional. Son los parámetros que definen cómo se presenta el agente al LLM del planificador.
dialogflowAgent

string

Obligatorio. Es el nombre del recurso del agente de Dialogflow subyacente. Formato: projects/{project}/locations/{location}/agents/{agent}

Imagen

Representa una imagen.

Representación JSON 
{

  // Union field storage_method can be only one of the following:
  "uri": string,
  "content": string
  // End of list of possible types for union field storage_method.
}
Campos
Campo de unión storage_method. Puede ser un URI o el contenido codificado como una cadena base64. storage_method puede ser solo uno de los siguientes:
uri

string

Es el URI de la imagen.
content

string

Contenido del archivo de imagen codificado en Base64.

AuthorizationConfig

Describe las autorizaciones requeridas.

Representación JSON 
{
  "toolAuthorizations": [
    string
  ],
  "agentAuthorization": string
}
Campos
toolAuthorizations[]

string

Opcional. Es la lista de autorizaciones requeridas para que el agente acceda a otros recursos. Los tokens de Auth se pasarán al agente como parte del cuerpo de la solicitud.
agentAuthorization

string

Opcional. Es la autorización que se requiere para invocar al agente. Los tokens de Auth se pasarán al agente como parte del encabezado de autorización de la solicitud.

DataStoreSpecs

Representa un conjunto de especificaciones del almacén de datos.

Representación JSON 
{
  "specs": [
    {
      object (DataStoreSpec)
    }
  ]
}
Campos
specs[]

object (DataStoreSpec)

Opcional. Son especificaciones que definen los DataStores para filtrar en una llamada de búsqueda y las configuraciones de esos almacenes de datos. Esto solo se considera para los Engines con varios almacenes de datos.

Estado

Son los valores posibles para el estado del ciclo de vida del agente.

Enums
STATE_UNSPECIFIED El estado no se especifica.
CONFIGURED El agente está configurado, pero aún no se activó ninguna implementación.
DEPLOYING Se está implementando el agente.
DISABLED El agente solo está disponible para los administradores.
DEPLOYMENT_FAILED No se pudo implementar el agente.
PRIVATE El agente solo está disponible para su creador.
ENABLED El agente está disponible para los usuarios que tienen acceso.
SUSPENDED El agente no está disponible temporalmente, pero los usuarios que tienen acceso pueden verlo.

StarterPrompt

Es la sugerencia de instrucción inicial que se le muestra al usuario en la página de destino del agente.

Representación JSON 
{
  "text": string
}
Campos
text

string

Obligatorio. Es el texto del mensaje inicial.

Métodos

create

 Crea un Agent.

delete

 Borra un Agent.

deploy

 Implementa un Agent.

get

 Obtiene un Agent.

getAgentView

 Devuelve un AgentView para un Agent determinado, que contiene información adicional sobre el agente.

list

 Enumera todos los objetos Agent en un objeto Assistant que creó el llamador.

patch

 Actualiza un Agent