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,

  // 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 legível do agente. 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.

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 de 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 puder retirar esse agente.

canRequestReview

boolean

Se o usuário pode pedir uma análise 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

Um comando sugerido para o agente, que será mostrado 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.