MCP: AI agents
View and adjust the workspace's AI agents: model, instructions, guardrails and Dcision. 9 tools.
Tools in this area, generated from the server code. The descriptions come from that code, in Portuguese. To connect, see the XBASE MCP.
get-agent
Detalhe de um agente do workspace: nome, status, modelo, fallback e as instruções completas.
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
get-agent-dcision
Pré-decisão Dcision do agente: ligada?, modo (shadow = Observar, route = Executar), origem das decisões (source: "workspace" = Integrações → Dcision do workspace; "api_key" = key própria), decisão, final da key e se a origem workspace está disponível (workspaceSourceAvailable).
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
get-agent-guardrails
Guardrails do agente (docs: Guardrails do agente). Entrada: profanity, pii, promptInjection (Dcision), inputLength, htmlSanitizer. Saída (revisão da resposta antes do envio): objective, grounding (sem base/alucinação), nonAnswer, contradictsRules, profanity, email/phone/sensitiveNumber (com "allowed"), maxLength e holdingMessage. Cada um com enabled e action. Também diz se a XBASE está conectada ao Dcision (dcisionAvailable).
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
list-agent-guardrail-reviews
Revisões dos guardrails do agente (mais recentes primeiro): veredito, o que reprovou, resposta barrada, considerações e o que aconteceu (sent, retried, held_handoff, record_only…). Use verdict "rejected" para ver só as reprovadas. Paginação por cursor (nextCursor).
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
verdict | no | — |
stage | no | — |
limit | no | — |
cursor | no | — |
remove-agent-fallback-model
Remove um modelo de fallback do agente (o agente deixa de usar esse modelo quando o principal falha).
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
modelRef | yes | Referência do modelo de fallback (como aparece em get-agent) |
update-agent
Edita um agente do workspace: nome, descrição, instruções (substitui o texto inteiro), status ou modelo (modelId). Só os campos enviados mudam.
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
name | no | — |
description | no | — |
instructions | no | Instruções completas (substitui as atuais) |
status | no | — |
modelId | no | ID do modelo do catálogo |
update-agent-dcision
Liga/desliga a pré-decisão Dcision do agente, escolhe o modo (shadow = Observar, route = Executar), a origem das decisões e a decisão. Origem "workspace": roda as decisões criadas e publicadas em Integrações → Dcision do próprio workspace, sem API key. Origem "api_key": roda as decisões da API key do Dcision do agente; a key só é enviada se for trocar (sem ela, mantém a salva). Trocar a origem não apaga a key salva. Ativar exige a decisão publicada (deploy) na origem escolhida.
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
enabled | yes | — |
mode | yes | — |
source | no | Origem das decisões: "workspace" = as decisões do próprio workspace, criadas e publicadas em Integrações → Dcision (usa a conexão da XBASE com o Dcision, sem API key); "api_key" = as de um workspace próprio em app.dcision.io, pela API key dele. Ausente mantém a origem salva. |
decisionSlug | yes | — |
apiKey | no | — |
update-agent-guardrails
Liga/desliga guardrails do agente. Manda só o que muda (o resto é mantido), ex.: { output: { grounding: { enabled: true, action: "record" } } }. Saída: action "record" = Só registrar (a resposta sai e a revisão é gravada; comece por aqui) ou "retry" = Reprovar e reexecutar (resposta reprovada não sai; o agente responde de novo uma vez; 2ª reprovada grave → holdingMessage + Atendimento Humano). Ligar um guardrail do Dcision cria as decisões padrão no Dcision do workspace. Agente externo: só os de saída.
| Parameter | Required | Description |
|---|---|---|
agentId | yes | ID do agente (veja get-agents-by-workspace) |
input | no | — |
output | no | — |
holdingMessage | no | Mensagem de espera (2ª resposta reprovada grave) |
get-agents-by-workspace
Lista agentes de IA do workspace com filtros por status e categoria. Retorna nome, descrição, instruções e tags. Use antes de criar tarefas.
| Parameter | Required | Description |
|---|---|---|
workspaceId | yes | ID único do workspace onde os agentes estão configurados |
status | no | Filtrar por status: ACTIVE (agentes ativos e prontos), INACTIVE (agentes desativados), DRAFT (agentes em desenvolvimento) |
category | no | Filtrar por categoria: sales (vendas), support (suporte), marketing, development, etc. |
limit | no | Número máximo de agentes a retornar (padrão: 50, máximo: 100) |