AgentView

Die Daten zum Anzeigen eines KI-Agenten.

JSON-Darstellung 
{
  "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.
}
Felder
name

string

Ressourcenname des KI-Agenten. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}
displayName

string

Erforderlich. Anzeigename des KI-Agenten. Die Sprache ist entweder Agent.language_code oder ListAvailableAgentViewsRequest.language_code, wenn Übersetzungen aktiviert sind.
description

string

Erforderlich. Eine menschenlesbare Beschreibung des KI-Agenten. Dies kann von einem LLM verwendet werden, um automatisch einen KI-Agenten auszuwählen, der auf eine Nutzeranfrage antworten soll, und um die erste Version der Schritte für den KI-Agenten zu generieren, die vom Nutzer geändert werden kann. Die Sprache ist entweder Agent.language_code oder ListAvailableAgentViewsRequest.language_code, wenn Übersetzungen aktiviert sind.
icon

object (Image)

Optional. Das Symbol, das den KI-Agenten in der Benutzeroberfläche darstellt.
agentType

enum (AgentType)

Nur Ausgabe. Der Typ des KI-Agenten.
agentOrigin

enum (AgentOrigin)

Nicht veränderbar. Der Ursprung des KI-Agenten.
state

enum (State)

Nur Ausgabe. Der Status des KI-Agenten.
userPermissions

object (UserPermissions)

Die Berechtigungen des Nutzers für diesen KI-Agenten.
suggestedPrompts[]

object (SuggestedPrompt)

Optional. Die vorgeschlagenen Prompts für den KI-Agenten, die auf der Landingpage des KI-Agenten angezeigt werden sollen.
customPlaceholderText

string

Der benutzerdefinierte Platzhaltertext, der im Textfeld angezeigt wird, bevor der Nutzer Text eingibt.
userAnnotations

object (UserAnnotations)

Optional. Pro-Nutzer-Annotationen des aktuellen Anrufers für den KI-Agenten.
agentSharingState

enum (AgentSharingState)

Nur Ausgabe. Der Freigabestatus des KI-Agenten.
Union-Feld agent_state_reason. Der Grund für den aktuellen Status des KI-Agenten. Für agent_state_reason ist nur einer der folgenden Werte zulässig:
suspensionReason

string

Der Grund für die Sperrung des KI-Agenten. Wird nur festgelegt, wenn der Status SUSPENDED ist.
rejectionReason

string

Der Grund, warum der KI-Agent abgelehnt wurde. Wird nur festgelegt, wenn der Status PRIVATE ist und durch Ablehnung erreicht wurde.
deploymentFailureReason

string

Der Grund, warum die Bereitstellung des KI-Agenten fehlgeschlagen ist. Wird nur festgelegt, wenn der Status DEPLOYMENT_FAILED ist.

AgentType

Der Typ des KI-Agenten.

Enums
AGENT_TYPE_UNSPECIFIED Der Typ des KI-Agenten ist nicht angegeben.
NO_CODE No‑Code-KI-Agent.
HTTP HTTP-KI-Agent.
ADK ADK-KI-Agent.
MANAGED Von Google verwalteter KI-Agent.
A2A A2A-KI-Agent.
DIALOGFLOW Dialogflow KI-Agent.
LOW_CODE Low-Code-KI-Agent.

UserPermissions

Die Berechtigungen des Nutzers für einen KI-Agenten.

JSON-Darstellung 
{
  "canRun": boolean,
  "canView": boolean,
  "canEdit": boolean,
  "canWithdraw": boolean,
  "canRequestReview": boolean,
  "canDelete": boolean,
  "canProposeUsers": boolean
}
Felder
canRun

boolean

Gibt an, ob der Nutzer diesen KI-Agenten ausführen darf.
canView

boolean

Gibt an, ob der Nutzer die Quelle dieses KI-Agenten sehen darf.
canEdit

boolean

Gibt an, ob der Nutzer diesen KI-Agenten bearbeiten darf.
canWithdraw

boolean

Wenn der Nutzer diesen KI-Agenten zurückziehen darf.
canRequestReview

boolean

Gibt an, ob der Nutzer eine Überprüfung für diesen KI-Agenten anfordern darf.
canDelete

boolean

Gibt an, ob der Nutzer diesen KI-Agenten löschen darf.
canProposeUsers

boolean

Gibt an, ob der Nutzer andere Nutzer vorschlagen darf, für die der KI-Agent freigegeben werden soll.

SuggestedPrompt

Ein vorgeschlagener Prompt für den KI-Agenten, der auf der Landingpage des KI-Agenten angezeigt werden soll.

JSON-Darstellung 
{
  "text": string
}
Felder
text

string

Erforderlich. Der Text des vorgeschlagenen Prompts. Die Sprache ist entweder Agent.language_code oder ListAvailableAgentViewsRequest.language_code, wenn Übersetzungen aktiviert sind.

UserAnnotations

Pro-Nutzer-Annotationen für einen KI-Agenten, basierend auf UserAnnotation.

JSON-Darstellung 
{
  "pinned": boolean,
  "viewed": boolean
}
Felder
pinned

boolean

Optional. Gibt an, ob der KI-Agent angepinnt wurde. Angepinnte KI-Agenten werden oben in der KI-Agenten-Liste angezeigt.
viewed

boolean

Optional. Gibt an, ob der Nutzer den KI-Agenten aufgerufen hat.

AgentSharingState

Mögliche Freigabestatus eines KI-Agenten.

Enums
AGENT_SHARING_STATE_UNSPECIFIED Der Freigabestatus ist nicht angegeben.
NOT_SHARED Der KI-Agent wird nicht freigegeben.
PENDING Die Prüfung des KI-Agenten steht noch aus.
SHARED Der KI-Agent wird für andere Nutzer freigegeben.
REJECTED Die Anfrage zur Freigabe des KI-Agenten wurde abgelehnt.