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

Suspende um agente. Continua disponível para visualização, mas não para utilização. O state do agente passa a ser SUSPENDED. Pode ser chamado num agente no estado ENABLED. Caso contrário, devolve um erro.

Pedido HTTP

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

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do agente a suspender. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/agents/{agent}

Parâmetros de consulta

Parâmetros
suspensionReason

string

Obrigatório. O motivo da suspensão do agente. Esta informação vai ser apresentada aos utilizadores do agente.

Corpo do pedido

O corpo do pedido tem de estar vazio.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância de Agent.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte o Authentication Overview.