AgentView

Os dados para apresentar 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 a apresentar 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. Isto pode ser usado por um GML para selecionar automaticamente um agente para responder a uma consulta do utilizador e gerar a primeira versão dos passos para o agente que pode ser modificada pelo utilizador. 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 IU.

agentType

enum (AgentType)

Apenas saída. O tipo de agente.

agentOrigin

enum (AgentOrigin)

Imutável. A origem do agente.

state

enum (State)

Apenas saída. O estado do agente.

userPermissions

object (UserPermissions)

As autorizações do utilizador para este agente.

suggestedPrompts[]

object (SuggestedPrompt)

Opcional. Os comandos sugeridos para o agente, a serem apresentados na página de destino do agente.

customPlaceholderText

string

O texto do marcador de posição personalizado que aparece na caixa de texto antes de o utilizador introduzir texto.

Campo de união agent_state_reason. O motivo pelo qual o agente se encontra no estado atual. agent_state_reason só pode ser uma das seguintes opções:
suspensionReason

string

O motivo pelo qual o agente foi suspenso. Definido apenas se o estado for SUSPENSO.

rejectionReason

string

O motivo pelo qual o agente foi rejeitado. Apenas definido se o estado for PRIVATE e tiver chegado a esse estado através da rejeição.

deploymentFailureReason

string

O motivo pelo qual a implementação do agente falhou. Definido apenas se o estado for DEPLOYMENT_FAILED.

AgentType

O tipo de agente.

Enumerações
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 gerido pela Google.
A2A Agente A2A.
DIALOGFLOW Agente Dialogflow.
LOW_CODE Agente de pouco código.

UserPermissions

As autorizações do utilizador num agente.

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

boolean

Se o utilizador pode executar este agente.

canView

boolean

Se o utilizador conseguir ver a origem deste agente.

canEdit

boolean

Se o utilizador puder editar este agente.

canWithdraw

boolean

Se o utilizador puder retirar este agente.

canRequestReview

boolean

Se o utilizador pode pedir uma revisão para este agente.

canDelete

boolean

Se o utilizador pode eliminar este agente.

canProposeUsers

boolean

Se o utilizador pode propor outros utilizadores com quem partilhar o agente.

SuggestedPrompt

Um comando sugerido para o agente, a apresentar na página de destino do agente.

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.