Skip to main content
Glama

Update agent profile

update_agent_profile
DestructiveIdempotent

Altera um agente da conta (veja list_agent_profiles). Mande só os campos que mudam.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "agent_profile_id": "<agent_profile_id>"
    },
    "name": "update_agent_profile"
  }
}

Input Schema

NameRequiredDescriptionDefault
nomeNoNome do agente, como a equipe vê: "Recepção", "Vendas", "Financeiro" (até 40)
ativoNo"não" tira o agente de cena: as conversas dele voltam para o agente de entrada
botaoNoTexto do botão deste agente no menu de setores (até 20 caracteres). "" = usa o nome
ordemNoPosição na lista (número)
equipeNoLista JSON com ids das pessoas da equipe (list_agent_profiles devolve "membros") que atendem este agente. Quem for marcado vê no Chat só as conversas dos agentes em que está, mais as passadas para ela; dono e gerente sempre veem tudo. "[]" tira todo mundo
entradaNo"sim" = recebe as conversas novas (só um agente pode ser de entrada; marcar este desmarca o anterior). Sem agente de entrada, as conversas novas ficam com o agente principal
numerosNoLista JSON com ids dos números de WhatsApp (list_agent_profiles → numeros) em que este agente trabalha, ou "todos" (padrão). A passagem entre agentes e o menu de setores ficam só entre os agentes do mesmo número
produtosNoLista JSON com ids de produto (list_products) que este agente oferece, ou "todos"
entrada_emNoLista JSON com ids dos números em que este agente é o de ENTRADA: recebe as conversas novas que chegam por ele e as que o Radar começa por ele (cadência, automação, n8n, API). Troca o de entrada anterior daquele número. "[]" tira de todos. Só números em que ele trabalha
order_fieldsNoCampos personalizados próprios, no mesmo formato de update_agent_config.order_fields, ou "herdar" para usar os da conta
etapa_entradaNoVários funis: id da etapa (list_pipeline_stages) onde o agente põe o contato SEM etapa que ele atende. Vazio = não põe no funil (padrão). Contato que já está no funil não muda.
etiqueta_baseNoEtiqueta da base deste agente, ex.: "financeiro". Documentos com a etiqueta "agente:financeiro" só este agente vê; documentos sem etiqueta de agente valem para todos. "" tira
quando_passarNoQuando os OUTROS agentes devem passar a conversa para este, ex.: "dúvidas de boleto, nota fiscal e pagamento" (até 300)
system_promptNoJeito de atender deste agente (tom, ordem da conversa). Sem preço e sem horário: preço fica em Produtos, horário no agente principal. Vazio = usa o system_prompt do agente principal
target_user_idNo(Só o admin da plataforma) userId da conta a operar
agent_profile_idYesid do agente

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / etapa_entrada
      Added value: +{
      +  "description": "Vários funis: id da etapa (list_pipeline_stages) onde o agente põe o contato SEM etapa que ele atende. Vazio = não põe no funil (padrão). Contato que já está no funil não muda.",
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • addedInput schema / properties / entrada_em
      Added value: +{
      +  "description": "Lista JSON com ids dos números em que este agente é o de ENTRADA: recebe as conversas novas que chegam por ele e as que o Radar começa por ele (cadência, automação, n8n, API). Troca o de entrada anterior daquele número. \"[]\" tira de todos. Só números em que ele trabalha",
      +  "type": "string"
      +}
    • addedInput schema / properties / numeros
      Added value: +{
      +  "description": "Lista JSON com ids dos números de WhatsApp (list_agent_profiles → numeros) em que este agente trabalha, ou \"todos\" (padrão). A passagem entre agentes e o menu de setores ficam só entre os agentes do mesmo número",
      +  "type": "string"
      +}
  3. Changed2 schema fields changed
    • addedInput schema / properties / botao
      Added value: +{
      +  "description": "Texto do botão deste agente no menu de setores (até 20 caracteres). \"\" = usa o nome",
      +  "type": "string"
      +}
    • addedInput schema / properties / equipe
      Added value: +{
      +  "description": "Lista JSON com ids das pessoas da equipe (list_agent_profiles devolve \"membros\") que atendem este agente. Quem for marcado vê no Chat só as conversas dos agentes em que está, mais as passadas para ela; dono e gerente sempre veem tudo. \"[]\" tira todo mundo",
      +  "type": "string"
      +}
  4. Added

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and idempotentHint=true, and the description adds the non-obvious partial-update contract (only changed fields need to be sent). However, it does not surface any of the destructive side effects (clearing equipe with '[]', swapping the entry agent, removing a base label), all of which are buried in individual parameter descriptions rather than the main text.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences with no filler, and the partial-update instruction is front-loaded after the purpose. Given the 16-parameter surface it is arguably too terse, but nothing written is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive, 16-parameter mutation with no output schema, the description relies almost entirely on annotations and per-parameter text. An agent reading only the description would not know that partial updates can silently remove team members, change the entry agent, or detach WhatsApp numbers, nor how this differs from update_agent_config.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every one of the 16 parameters already carries detailed semantics, including the nested relations to list_agent_profiles, list_products, and list_pipeline_stages. The description only adds the general rule that unchanged fields may be omitted, which is the correct baseline for full schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Altera um agente da conta') and points to list_agent_profiles as the discovery counterpart. It does not distinguish itself from close siblings such as update_agent_config, set_agent_menu, or create_agent_profile, so the agent must infer the boundary from the schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Mande só os campos que mudam' gives a clear partial-update rule and 'veja list_agent_profiles' tells the agent to read before writing. There is no guidance on when to use this instead of update_agent_config (which the order_fields parameter explicitly references) or which changes are risky.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources