AgentView

Die Daten zum Anzeigen eines Agents.

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,

  // 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 Agents. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}
displayName

string

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

string

Erforderlich. 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 Agent in der Benutzeroberfläche darstellt.
agentType

enum (AgentType)

Nur Ausgabe. Der Typ des KI-Agenten.
agentOrigin

enum (AgentOrigin)

Nicht veränderbar. Der Ursprung des Agents.
state

enum (State)

Nur Ausgabe. Der Status des Agents.
userPermissions

object (UserPermissions)

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

object (SuggestedPrompt)

Optional. Die vorgeschlagenen Prompts für den Agent, die auf der Landingpage des Agents angezeigt werden sollen.
customPlaceholderText

string

Der benutzerdefinierte Platzhaltertext, der im Textfeld angezeigt wird, bevor der Nutzer Text eingibt.
Union-Feld agent_state_reason. Der Grund, warum sich der Agent im aktuellen Status befindet. Für agent_state_reason ist nur einer der folgenden Werte zulässig:
suspensionReason

string

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

string

Der Grund, warum der Agent abgelehnt wurde. Wird nur festgelegt, wenn der Status „PRIVATE“ lautet und durch Ablehnung erreicht wurde.
deploymentFailureReason

string

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

AgentType

Der Typ des KI-Agenten.

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

UserPermissions

Die Berechtigungen des Nutzers für einen Agent.

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 kann.
canView

boolean

Gibt an, ob der Nutzer die Quelle dieses Agents sehen kann.
canEdit

boolean

Gibt an, ob der Nutzer diesen Agent bearbeiten kann.
canWithdraw

boolean

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

boolean

Gibt an, ob der Nutzer eine Überprüfung für diesen Agent anfordern kann.
canDelete

boolean

Gibt an, ob der Nutzer diesen Agent löschen kann.
canProposeUsers

boolean

Wenn der Nutzer andere Nutzer vorschlagen kann, für die der Agent freigegeben werden soll.

SuggestedPrompt

Ein vorgeschlagener Prompt für den Agenten, der auf der Landingpage des 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.