AgentView

Données permettant d'afficher un agent.

Représentation 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.
}
Champs
name

string

Nom de ressource de l'agent. Format : projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}

displayName

string

Obligatoire. Nom à afficher de l'agent. La langue est Agent.language_code ou ListAvailableAgentViewsRequest.language_code si les traductions sont activées.

description

string

Obligatoire. Description de l'agent lisible par l'humain. Un LLM peut l'utiliser pour sélectionner automatiquement un agent afin de répondre à une requête utilisateur et générer la première version des étapes de l'agent, que l'utilisateur peut modifier. La langue est Agent.language_code ou ListAvailableAgentViewsRequest.language_code si les traductions sont activées.

icon

object (Image)

Facultatif. Icône représentant l'agent dans l'UI.

agentType

enum (AgentType)

Uniquement en sortie. Type de l'agent.

agentOrigin

enum (AgentOrigin)

Immuable. Origine de l'agent.

state

enum (State)

Uniquement en sortie. État de l'agent.

userPermissions

object (UserPermissions)

Autorisations de l'utilisateur pour cet agent.

suggestedPrompts[]

object (SuggestedPrompt)

Facultatif. Requêtes suggérées pour l'agent, à afficher sur la page de destination de l'agent.

customPlaceholderText

string

Texte d'espace réservé personnalisé qui s'affiche dans la zone de texte avant que l'utilisateur ne saisisse du texte.

Champ d'union agent_state_reason. Raison pour laquelle l'agent est dans son état actuel. agent_state_reason ne peut être qu'un des éléments suivants :
suspensionReason

string

Raison pour laquelle l'agent a été suspendu. Défini uniquement si l'état est SUSPENDED.

rejectionReason

string

Raison pour laquelle l'agent a été refusé. Défini uniquement si l'état est "PRIVATE" et qu'il a été atteint après un refus.

deploymentFailureReason

string

Raison de l'échec du déploiement de l'agent. Défini uniquement si l'état est DEPLOYMENT_FAILED.

AgentType

Type de l'agent.

Enums
AGENT_TYPE_UNSPECIFIED Le type d'agent n'est pas spécifié.
NO_CODE Agent sans code.
HTTP Agent HTTP.
ADK Agent ADK.
MANAGED Agent géré par Google.
A2A Agent A2A.
DIALOGFLOW Agent Dialogflow.
LOW_CODE Agent nécessitant peu de code.

UserPermissions

Autorisations de l'utilisateur sur un agent.

Représentation JSON
{
  "canRun": boolean,
  "canView": boolean,
  "canEdit": boolean,
  "canWithdraw": boolean,
  "canRequestReview": boolean,
  "canDelete": boolean,
  "canProposeUsers": boolean
}
Champs
canRun

boolean

Si l'utilisateur peut exécuter cet agent.

canView

boolean

Si l'utilisateur peut afficher la source de cet agent.

canEdit

boolean

Si l'utilisateur peut modifier cet agent.

canWithdraw

boolean

Si l'utilisateur peut retirer cet agent.

canRequestReview

boolean

Indique si l'utilisateur peut demander un examen de cet agent.

canDelete

boolean

Si l'utilisateur peut supprimer cet agent.

canProposeUsers

boolean

Si l'utilisateur peut proposer d'autres utilisateurs avec lesquels partager l'agent.

SuggestedPrompt

Suggestion de requête pour l'agent, à afficher sur la page de destination de l'agent.

Représentation JSON
{
  "text": string
}
Champs
text

string

Obligatoire. Texte de la suggestion de requête. La langue est Agent.language_code ou ListAvailableAgentViewsRequest.language_code si les traductions sont activées.