AgentView

Data untuk menampilkan Agen.

Representasi 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.
}
Kolom
name

string

Nama resource agen. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}
displayName

string

Wajib. Nama tampilan agen. Bahasa ini adalah Agent.language_code, atau ListAvailableAgentViewsRequest.language_code jika terjemahan diaktifkan.
description

string

Wajib. Deskripsi agen yang dapat dibaca manusia. Hal ini dapat digunakan oleh LLM untuk otomatis memilih agen yang akan merespons kueri pengguna dan membuat versi pertama langkah-langkah untuk agen yang dapat diubah oleh pengguna. Bahasa ini adalah Agent.language_code, atau ListAvailableAgentViewsRequest.language_code jika terjemahan diaktifkan.
icon

object (Image)

Opsional. Ikon yang merepresentasikan agen di UI.
agentType

enum (AgentType)

Hanya output. Jenis agen.
agentOrigin

enum (AgentOrigin)

Tidak dapat diubah. Asal Agen.
state

enum (State)

Hanya output. Status Agen.
userPermissions

object (UserPermissions)

Izin pengguna untuk Agen ini.
suggestedPrompts[]

object (SuggestedPrompt)

Opsional. Perintah yang disarankan untuk agen, yang akan ditampilkan di halaman landing agen.
customPlaceholderText

string

Teks placeholder kustom yang muncul di kotak teks sebelum pengguna memasukkan teks apa pun.
userAnnotations

object (UserAnnotations)

Opsional. Anotasi per pengguna dari pemanggil saat ini untuk agen.
agentSharingState

enum (AgentSharingState)

Hanya output. Status berbagi agen.
Kolom union agent_state_reason. Alasan mengapa agen berada dalam statusnya saat ini. agent_state_reason hanya ada berupa salah satu diantara berikut:
suspensionReason

string

Alasan agen ditangguhkan. Hanya disetel jika statusnya SUSPENDED.
rejectionReason

string

Alasan agen ditolak. Hanya disetel jika statusnya adalah PRIVATE, dan sampai ke sana melalui penolakan.
deploymentFailureReason

string

Alasan deployment agen gagal. Hanya disetel jika statusnya adalah DEPLOYMENT_FAILED.

AgentType

Jenis agen.

Enum
AGENT_TYPE_UNSPECIFIED Jenis agen tidak ditentukan.
NO_CODE Agen tanpa kode.
HTTP Agen HTTP.
ADK Agen ADK.
MANAGED Agen terkelola Google.
A2A Agen A2A.
DIALOGFLOW Agen Dialogflow.
LOW_CODE Agen low-code.

UserPermissions

Izin pengguna pada Agen.

Representasi JSON 
{
  "canRun": boolean,
  "canView": boolean,
  "canEdit": boolean,
  "canWithdraw": boolean,
  "canRequestReview": boolean,
  "canDelete": boolean,
  "canProposeUsers": boolean
}
Kolom
canRun

boolean

Jika pengguna dapat menjalankan Agen ini.
canView

boolean

Jika pengguna dapat melihat sumber Agen ini.
canEdit

boolean

Jika pengguna dapat mengedit Agen ini.
canWithdraw

boolean

Jika pengguna dapat menarik Agen ini.
canRequestReview

boolean

Jika pengguna dapat meminta peninjauan untuk Agen ini.
canDelete

boolean

Jika pengguna dapat menghapus Agen ini.
canProposeUsers

boolean

Jika pengguna dapat menyarankan pengguna lain untuk berbagi Agen.

SuggestedPrompt

Perintah yang disarankan untuk agen, yang akan ditampilkan di halaman landing agen.

Representasi JSON 
{
  "text": string
}
Kolom
text

string

Wajib. Teks perintah yang disarankan. Bahasa ini adalah Agent.language_code, atau ListAvailableAgentViewsRequest.language_code jika terjemahan diaktifkan.

UserAnnotations

Anotasi per pengguna untuk Agen, berdasarkan UserAnnotation.

Representasi JSON 
{
  "pinned": boolean,
  "viewed": boolean
}
Kolom
pinned

boolean

Opsional. Apakah agen disematkan atau tidak, agen yang disematkan akan ditampilkan di bagian atas daftar agen.
viewed

boolean

Opsional. Apakah agen telah dilihat oleh pengguna.

AgentSharingState

Kemungkinan status berbagi Agen.

Enum
AGENT_SHARING_STATE_UNSPECIFIED Status berbagi tidak ditentukan.
NOT_SHARED Agen tidak dibagikan.
PENDING Agen sedang menunggu peninjauan.
SHARED Agen dibagikan kepada pengguna lain.
REJECTED Permintaan berbagi agen ditolak.