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,
  "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.
}
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.
userAnnotations

object (UserAnnotations)

Facultatif. Annotations par utilisateur de l'appelant actuel pour l'agent.
agentSharingState

enum (AgentSharingState)

Uniquement en sortie. État de partage de l'agent.
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 no-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
}
Fields
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.

UserAnnotations

Annotations par utilisateur pour un agent, basées sur UserAnnotation.

Représentation JSON 
{
  "pinned": boolean,
  "viewed": boolean
}
Champs
pinned

boolean

Facultatif. Indique si l'agent est épinglé. Si c'est le cas, il s'affiche en haut de la liste des agents.
viewed

boolean

Facultatif. Indique si l'utilisateur a consulté l'agent.

AgentSharingState

États de partage possibles d'un agent.

Enums
AGENT_SHARING_STATE_UNSPECIFIED L'état de partage n'est pas spécifié.
NOT_SHARED L'agent n'est pas partagé.
PENDING L'agent est en attente d'examen.
SHARED L'agent est partagé avec d'autres utilisateurs.
REJECTED La demande de partage de l'agent a été refusée.