Method: projects.locations.collections.engines.assistants.agents.rejectAgent

공개적으로 제공되는 에이전트를 거부합니다. 에이전트의 state가 PRIVATE로 변경됩니다. 상태가 DISABLED인 에이전트에서만 호출할 수 있으며, 그렇지 않으면 오류가 반환됩니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/engines/*/assistants/*/agents/*}:rejectAgent

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 거부할 에이전트의 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}

쿼리 파라미터

매개변수
rejectionReason

string

필수 항목입니다. 에이전트를 거부하는 이유입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 Agent의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

자세한 내용은 Authentication Overview에서 확인하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • discoveryengine.agents.manage

자세한 내용은 IAM 문서를 참조하세요.