Atualizar um agente

Salva os campos do rascunho do agente: nome, descrição, prompt, modelo, avatar, etiquetas, metadados, mídias, bases de conhecimento, RAG, variáveis e o estado ativo (isActive, obrigatório: 400 agent_is_active_required). Conversas seguem usando a versão publicada até a próxima publicação.

As ferramentas não vão neste corpo: cada uma é salva em /v1/agents/{id}/tools. Um corpo com internalTools responde 400 agent_tools_moved sem salvar nada. Servidores MCP também são ferramentas (tipo mcp_source, com as ferramentas permitidas): um corpo com mcpCollectionIds responde 400 agent_mcp_collections_moved.

variables são as variáveis iniciais que o agente usa: o nome técnico (letras sem acento, números e _, até 64, sem repetir; lead_name, lead_number e campaign_name são da plataforma) e o valor padrão (sem padrão, a variável é obrigatória). Mandar variables substitui a lista inteira; uma lista vazia tira todas. O nome amigável, a descrição e o tipo moram na declaração do workspace (/conversation-variables), a mesma de fluxos, campanhas e transferências; um nome não declarado vale como texto. Até 50 variáveis.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ID do agente

Body Params

Campos do agente

string
string
boolean
knowledgeBaseIds
array of strings
knowledgeBaseIds
mediaIds
array of strings
mediaIds
string
string
metadata
object
string
string
ragConfig
object
boolean
tags
array of strings
tags
variables
array of objects
variables
Headers
string

Departamento que limita os dados. Quem não participa do departamento recebe 403; donos e administradores escolhem qualquer um.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json