AgentView

Os dados para mostrar um agente.

Representação JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "icon": {
    object (Image)
  },
  "agentType": enum (AgentType),
  "agentOrigin": enum (AgentOrigin),
  "state": enum (State),
  "userPermissions": {
    object (UserPermissions)
  },
  "suggestedPrompts": [
    {
      object (SuggestedPrompt)
    }
  ],
  "customPlaceholderText": string,
  "userAnnotations": {
    object (UserAnnotations)
  },
  "agentSharingState": enum (AgentSharingState),

  // 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

Nome do recurso do agente. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}
displayName

string

Obrigatório. Nome de exibição do agente. O idioma é Agent.language_code ou ListAvailableAgentViewsRequest.language_code se as traduções estiverem ativadas.
description

string

Obrigatório. Descrição do agente legível por humanos. Isso pode ser usado por um LLM para selecionar automaticamente um agente que responda a uma consulta do usuário e gerar a primeira versão das etapas para o agente, que pode ser modificada pelo usuário. O idioma é Agent.language_code ou ListAvailableAgentViewsRequest.language_code se as traduções estiverem ativadas.
icon

object (Image)

Opcional. O ícone que representa o agente na UI.
agentType

enum (AgentType)

Apenas saída. É o tipo do agente.
agentOrigin

enum (AgentOrigin)

Imutável. A origem do agente.
state

enum (State)

Apenas saída. O estado do agente.
userPermissions

object (UserPermissions)

As permissões do usuário para este agente.
suggestedPrompts[]

object (SuggestedPrompt)

Opcional. Os comandos sugeridos para o agente, que serão mostrados na página de destino dele.
customPlaceholderText

string

O texto de marcador de posição personalizado que aparece na caixa de texto antes de o usuário inserir qualquer texto.
userAnnotations

object (UserAnnotations)

Opcional. Anotações por usuário do caller atual para o agente.
agentSharingState

enum (AgentSharingState)

Apenas saída. O estado de compartilhamento do agente.
Campo de união agent_state_reason. O motivo pelo qual o agente está no estado atual. agent_state_reason pode ser apenas de um dos tipos a seguir:
suspensionReason

string

O motivo da suspensão do agente. Só é definido se o estado for SUSPENSO.
rejectionReason

string

O motivo da rejeição do agente. Definido somente se o estado for "PRIVATE" e tiver sido alcançado por rejeição.
deploymentFailureReason

string

O motivo da falha na implantação do agente. Definido apenas se o estado for DEPLOYMENT_FAILED.

AgentType

É o tipo do agente.

Tipos enumerados
AGENT_TYPE_UNSPECIFIED O tipo de agente não foi especificado.
NO_CODE Agente sem código.
HTTP Agente HTTP.
ADK Agente do ADK.
MANAGED Agente gerenciado pelo Google.
A2A Agente A2A.
DIALOGFLOW Agente do Dialogflow.
LOW_CODE Agente com pouco código.

UserPermissions

As permissões do usuário em um agente.

Representação JSON 
{
  "canRun": boolean,
  "canView": boolean,
  "canEdit": boolean,
  "canWithdraw": boolean,
  "canRequestReview": boolean,
  "canDelete": boolean,
  "canProposeUsers": boolean
}
Campos
canRun

boolean

Se o usuário puder executar esse agente.
canView

boolean

Se o usuário pode ver a origem deste agente.
canEdit

boolean

Se o usuário pode editar este agente.
canWithdraw

boolean

Se o usuário pode retirar esse agente.
canRequestReview

boolean

Se o usuário pode pedir uma revisão para este agente.
canDelete

boolean

Se o usuário puder excluir este agente.
canProposeUsers

boolean

Se o usuário pode sugerir outros usuários para compartilhar o agente.

SuggestedPrompt

Uma sugestão de comando para o agente, que será mostrada na página de destino dele.

Representação JSON 
{
  "text": string
}
Campos
text

string

Obrigatório. O texto do comando sugerido. O idioma é Agent.language_code ou ListAvailableAgentViewsRequest.language_code se as traduções estiverem ativadas.

UserAnnotations

Anotações por usuário para um agente, com base em UserAnnotation.

Representação JSON 
{
  "pinned": boolean,
  "viewed": boolean
}
Campos
pinned

boolean

Opcional. Se o agente estiver fixado, ele vai aparecer na parte de cima da lista.
viewed

boolean

Opcional. Se o agente foi visualizado pelo usuário.

AgentSharingState

Possíveis estados de compartilhamento de um agente.

Tipos enumerados
AGENT_SHARING_STATE_UNSPECIFIED O estado de compartilhamento não foi especificado.
NOT_SHARED O agente não foi compartilhado.
PENDING O agente está com revisão pendente.
SHARED O agente é compartilhado com outros usuários.
REJECTED O pedido de compartilhamento do agente foi recusado.