AgentView

에이전트를 표시하기 위한 데이터입니다.

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.
}
필드
name

string

에이전트의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}

displayName

string

필수 항목입니다. 에이전트의 표시 이름입니다. 이 언어는 Agent.language_code이거나 번역이 사용 설정된 경우 ListAvailableAgentViewsRequest.language_code입니다.

description

string

필수 항목입니다. 인간이 읽을 수 있는 에이전트 설명입니다. 이는 LLM이 사용자 쿼리에 응답할 에이전트를 자동으로 선택하고 사용자가 수정할 수 있는 에이전트 단계의 첫 번째 버전을 생성하는 데 사용될 수 있습니다. 이 언어는 Agent.language_code이거나 번역이 사용 설정된 경우 ListAvailableAgentViewsRequest.language_code입니다.

icon

object (Image)

(선택사항) UI에서 에이전트를 나타내는 아이콘입니다.

agentType

enum (AgentType)

출력 전용입니다. 에이전트 유형입니다.

agentOrigin

enum (AgentOrigin)

변경할 수 없습니다. 에이전트의 출처입니다.

state

enum (State)

출력 전용입니다. 상담사의 상태입니다.

userPermissions

object (UserPermissions)

이 에이전트에 대한 사용자의 권한입니다.

suggestedPrompts[]

object (SuggestedPrompt)

(선택사항) 에이전트 방문 페이지에 표시할 에이전트의 추천 프롬프트입니다.

customPlaceholderText

string

사용자가 텍스트를 입력하기 전에 텍스트 상자에 표시되는 맞춤 자리표시자 텍스트입니다.

통합 필드 agent_state_reason. 상담사가 현재 상태인 이유입니다. agent_state_reason은 다음 중 하나여야 합니다.
suspensionReason

string

상담사가 정지된 이유입니다. 상태가 SUSPENDED인 경우에만 설정됩니다.

rejectionReason

string

에이전트가 거부된 이유입니다. 상태가 비공개이고 거부를 통해 도달한 경우에만 설정됩니다.

deploymentFailureReason

string

에이전트 배포가 실패한 이유입니다. 상태가 DEPLOYMENT_FAILED인 경우에만 설정됩니다.

AgentType

에이전트 유형입니다.

열거형
AGENT_TYPE_UNSPECIFIED 에이전트 유형이 지정되지 않았습니다.
NO_CODE 노 코드 에이전트
HTTP HTTP 에이전트입니다.
ADK ADK 에이전트
MANAGED Google 관리 에이전트입니다.
A2A A2A 에이전트입니다.
DIALOGFLOW Dialogflow 에이전트입니다.
LOW_CODE 로우 코드 에이전트

UserPermissions

에이전트에 대한 사용자의 권한입니다.

JSON 표현
{
  "canRun": boolean,
  "canView": boolean,
  "canEdit": boolean,
  "canWithdraw": boolean,
  "canRequestReview": boolean,
  "canDelete": boolean,
  "canProposeUsers": boolean
}
필드
canRun

boolean

사용자가 이 에이전트를 실행할 수 있는지 여부입니다.

canView

boolean

사용자가 이 에이전트의 소스를 볼 수 있는지 여부입니다.

canEdit

boolean

사용자가 이 상담사를 수정할 수 있는지 여부입니다.

canWithdraw

boolean

사용자가 이 상담사를 철회할 수 있는지 여부입니다.

canRequestReview

boolean

사용자가 이 상담사의 검토를 요청할 수 있는지 여부입니다.

canDelete

boolean

사용자가 이 에이전트를 삭제할 수 있는지 여부입니다.

canProposeUsers

boolean

사용자가 에이전트를 공유할 다른 사용자를 제안할 수 있는지 여부입니다.

SuggestedPrompt

에이전트 방문 페이지에 표시할 에이전트용 추천 프롬프트입니다.

JSON 표현
{
  "text": string
}
필드
text

string

필수 항목입니다. 추천 프롬프트의 텍스트입니다. 이 언어는 Agent.language_code이거나 번역이 사용 설정된 경우 ListAvailableAgentViewsRequest.language_code입니다.