Skip to content

Commit b51c15d

Browse files
tlgimenesclaude
tlgimenes
and
claude
authored
docs(automations): add automations documentation page (EN + PT-BR) (#2700)
Add new Automations docs page covering unattended agent runs with cron/event triggers. Update concepts, agents pages, and navigation to reference automations. Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 78373b8 commit b51c15d

7 files changed

Lines changed: 219 additions & 2 deletions

File tree

‎apps/docs/client/src/content/2026-03-10/en/mcp-mesh/agents.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,4 +98,4 @@ Agents provide focused capabilities with clear advantages:
9898

9999
---
100100

101-
**Next steps**: Learn about [Virtual MCPs](/en/mcp-mesh/virtual-mcps) to understand the foundation, or explore [decopilot](/en/mcp-mesh/decopilot/overview) to see how agents are spawned dynamically.
101+
**Next steps**: Learn about [Virtual MCPs](/en/mcp-mesh/virtual-mcps) to understand the foundation, explore [decopilot](/en/mcp-mesh/decopilot/overview) to see how agents are spawned dynamically, or set up [Automations](/en/mcp-mesh/automations) for unattended agent execution on schedules and events.

‎apps/docs/client/src/content/2026-03-10/en/mcp-mesh/automations.mdx‎

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
---
2+
title: Automations
3+
description: Unattended AI agent runs triggered by schedules or events
4+
icon: Zap
5+
---
6+
7+
import Callout from "../../../../components/ui/Callout.astro";
8+
9+
<Callout type="info">
10+
Automations is an experimental feature. Enable it in **Settings → Account → Preferences → experimentalAutomations**.
11+
</Callout>
12+
13+
## What Are Automations?
14+
15+
Automations are **unattended agent runs** — AI agents that execute on a schedule or in response to events, without a human in the loop. Each automation configures:
16+
17+
- **Agent** — which [Virtual MCP](/en/mcp-mesh/virtual-mcps) (agent) to run
18+
- **Messages** — the prompt/instructions the agent receives each run
19+
- **Model** — which AI model and credentials to use
20+
- **Triggers** — when the automation fires (cron schedule, connection event, or manual)
21+
22+
Automations run in **passthrough mode**, meaning all tool calls are auto-approved. This is what makes them unattended — but it also means you should scope agent tools carefully.
23+
24+
**Automations vs Decopilot**: [Decopilot](/en/mcp-mesh/decopilot/overview) is interactive — a human converses with the agent and approves actions. Automations are fire-and-forget: the agent runs, completes its task, and the result appears in [Monitoring](/en/mcp-mesh/monitoring).
25+
26+
## When to Use Automations
27+
28+
- **Scheduled tasks** — daily reports, periodic data syncs, cleanup jobs
29+
- **Event-driven workflows** — new order → fulfillment, new ticket → triage, deployment → notification
30+
- **Any workflow that should run without human approval**
31+
32+
## Creating an Automation
33+
34+
1. Navigate to **Automations** in the sidebar
35+
2. Click **New Automation**
36+
3. Choose an [agent](/en/mcp-mesh/agents) — the Virtual MCP that will execute
37+
4. Write the prompt/messages — what the agent should do each run
38+
5. Select a model and credentials
39+
6. Set temperature (default 0.5)
40+
7. Add one or more triggers (cron or event)
41+
8. Activate the automation
42+
43+
## Triggers
44+
45+
### Cron Triggers
46+
47+
Cron triggers run the automation on a recurring schedule using standard cron expression syntax. All times are in **UTC**.
48+
49+
| Expression | Schedule |
50+
|---|---|
51+
| `0 9 * * *` | Daily at 9:00 AM UTC |
52+
| `0 */6 * * *` | Every 6 hours |
53+
| `0 9 * * 1` | Every Monday at 9:00 AM UTC |
54+
| `*/5 * * * *` | Every 5 minutes |
55+
56+
**Minimum interval**: 60 seconds. Expressions that resolve to intervals shorter than 60 seconds are rejected.
57+
58+
**Crash-safe scheduling**: The system records `last_run_at` for each trigger. If the server restarts, missed runs are detected and fired on the next poll cycle (every 30 seconds).
59+
60+
### Event Triggers
61+
62+
Event triggers fire the automation when a connected MCP server publishes a matching event.
63+
64+
- The connection must implement `TRIGGER_CONFIGURE` (so the mesh can register/unregister interest in events)
65+
- You specify the **connection**, **event type**, and optional **params** for filtering
66+
- **Fail-atomic**: if configuring the trigger on the connection fails, the trigger is not created
67+
- When the automation is deactivated or deleted, event triggers are disabled on their connections (best-effort)
68+
69+
**Param filtering**: If you specify params, only events whose data contains all matching key-value pairs will fire the automation. Extra fields in the event data are ignored.
70+
71+
## Running and Testing
72+
73+
- Use the **AUTOMATION_RUN** tool or the UI to manually trigger a run at any time
74+
- Each run creates a thread visible in [Monitoring](/en/mcp-mesh/monitoring)
75+
- Runs that error are marked as failed in the thread
76+
77+
## Safety and Limits
78+
79+
<Callout type="warning">
80+
Automations run in passthrough mode — all tool calls are auto-approved. Scope your agent's tools carefully to prevent unintended actions.
81+
</Callout>
82+
83+
- **Per-automation concurrency**: Maximum 3 concurrent runs per automation. Additional triggers are skipped until a slot opens.
84+
- **Global concurrency**: Maximum 10 concurrent automation runs across the entire system.
85+
- **Run timeout**: Each run is capped at 5 minutes.
86+
- **Recursion prevention**: Event trigger chains are limited to a depth of 3. If an automation's actions trigger events that fire other automations, the chain stops after 3 levels.
87+
- **Payload limit**: Event data is capped at 1 MB. Larger payloads are truncated to mitigate prompt injection risks.
88+
- **Creator validation**: If the automation's creator leaves the organization, the automation is automatically deactivated.
89+
90+
## Automation MCP Tools
91+
92+
These tools are available for managing automations programmatically via the MCP interface:
93+
94+
| Tool | Description |
95+
|---|---|
96+
| `AUTOMATION_CREATE` | Create a new automation with agent, messages, model, and triggers |
97+
| `AUTOMATION_GET` | Get a single automation by ID with full configuration |
98+
| `AUTOMATION_LIST` | List all automations in the current organization |
99+
| `AUTOMATION_UPDATE` | Update automation fields (partial update supported) |
100+
| `AUTOMATION_DELETE` | Delete an automation and disable its event triggers |
101+
| `AUTOMATION_TRIGGER_ADD` | Add a cron or event trigger to an automation |
102+
| `AUTOMATION_TRIGGER_REMOVE` | Remove a trigger from an automation |
103+
| `AUTOMATION_RUN` | Manually trigger an automation run |
104+
105+
---
106+
107+
**Next steps**: Learn about [Agents](/en/mcp-mesh/agents) to understand how to design the Virtual MCPs that automations execute, or explore [Monitoring](/en/mcp-mesh/monitoring) to track automation runs.

‎apps/docs/client/src/content/2026-03-10/en/mcp-mesh/concepts.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ icon: BookOpen
1111
- **Connection**: a configured upstream MCP endpoint (usually HTTP), optionally with stored credentials. See [Connections](/en/mcp-mesh/connections).
1212
- **Virtual MCP**: aggregates tools/resources/prompts from connected servers into a single MCP. See [Virtual MCPs](/en/mcp-mesh/virtual-mcps).
1313
- **Agent**: single-purpose Virtual MCPs optimized for specific tasks. See [Agents](/en/mcp-mesh/agents).
14+
- **Automation**: unattended agent runs on a schedule or event trigger. See [Automations](/en/mcp-mesh/automations).
1415
- **Project**: Virtual MCPs to organize project-specific tools, resources, prompts, and config. See [Projects](/en/mcp-mesh/projects).
1516

1617
## Understanding Agents vs. Projects

‎apps/docs/client/src/content/2026-03-10/pt-br/mcp-mesh/agents.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,4 +98,4 @@ Agentes fornecem capacidades focadas com vantagens claras:
9898

9999
---
100100

101-
**Próximos passos**: Aprenda sobre [MCPs Virtuais](/pt-br/mcp-mesh/virtual-mcps) para entender a fundação, ou explore o [decopilot](/pt-br/mcp-mesh/decopilot/overview) para ver como agentes são iniciados dinamicamente.
101+
**Próximos passos**: Aprenda sobre [MCPs Virtuais](/pt-br/mcp-mesh/virtual-mcps) para entender a fundação, explore o [decopilot](/pt-br/mcp-mesh/decopilot/overview) para ver como agentes são iniciados dinamicamente, ou configure [Automações](/pt-br/mcp-mesh/automations) para execução autônoma de agentes em agendamentos e eventos.

‎apps/docs/client/src/content/2026-03-10/pt-br/mcp-mesh/automations.mdx‎

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
---
2+
title: Automações
3+
description: Execuções autônomas de agentes IA disparadas por agendamentos ou eventos
4+
icon: Zap
5+
---
6+
7+
import Callout from "../../../../components/ui/Callout.astro";
8+
9+
<Callout type="info">
10+
Automações é um recurso experimental. Ative em **Configurações → Conta → Preferências → experimentalAutomations**.
11+
</Callout>
12+
13+
## O Que São Automações?
14+
15+
Automações são **execuções autônomas de agentes** — agentes de IA que executam em um agendamento ou em resposta a eventos, sem intervenção humana. Cada automação configura:
16+
17+
- **Agente** — qual [MCP Virtual](/pt-br/mcp-mesh/virtual-mcps) (agente) executar
18+
- **Mensagens** — o prompt/instruções que o agente recebe em cada execução
19+
- **Modelo** — qual modelo de IA e credenciais usar
20+
- **Gatilhos** — quando a automação dispara (agendamento cron, evento de conexão ou manual)
21+
22+
Automações executam em **modo passthrough**, o que significa que todas as chamadas de ferramentas são auto-aprovadas. É isso que as torna autônomas — mas também significa que você deve definir cuidadosamente o escopo das ferramentas do agente.
23+
24+
**Automações vs Decopilot**: O [Decopilot](/pt-br/mcp-mesh/decopilot/overview) é interativo — um humano conversa com o agente e aprova ações. Automações são disparar-e-esquecer: o agente executa, completa sua tarefa, e o resultado aparece no [Monitoramento](/pt-br/mcp-mesh/monitoring).
25+
26+
## Quando Usar Automações
27+
28+
- **Tarefas agendadas** — relatórios diários, sincronizações periódicas, tarefas de limpeza
29+
- **Fluxos orientados a eventos** — novo pedido → processamento, novo ticket → triagem, deploy → notificação
30+
- **Qualquer fluxo que deve executar sem aprovação humana**
31+
32+
## Criando uma Automação
33+
34+
1. Navegue até **Automações** na barra lateral
35+
2. Clique em **Nova Automação**
36+
3. Escolha um [agente](/pt-br/mcp-mesh/agents) — o MCP Virtual que será executado
37+
4. Escreva o prompt/mensagens — o que o agente deve fazer em cada execução
38+
5. Selecione um modelo e credenciais
39+
6. Defina a temperatura (padrão 0.5)
40+
7. Adicione um ou mais gatilhos (cron ou evento)
41+
8. Ative a automação
42+
43+
## Gatilhos
44+
45+
### Gatilhos Cron
46+
47+
Gatilhos cron executam a automação em um agendamento recorrente usando sintaxe padrão de expressão cron. Todos os horários são em **UTC**.
48+
49+
| Expressão | Agendamento |
50+
|---|---|
51+
| `0 9 * * *` | Diariamente às 9:00 UTC |
52+
| `0 */6 * * *` | A cada 6 horas |
53+
| `0 9 * * 1` | Toda segunda-feira às 9:00 UTC |
54+
| `*/5 * * * *` | A cada 5 minutos |
55+
56+
**Intervalo mínimo**: 60 segundos. Expressões que resultam em intervalos menores que 60 segundos são rejeitadas.
57+
58+
**Agendamento à prova de falhas**: O sistema registra `last_run_at` para cada gatilho. Se o servidor reiniciar, execuções perdidas são detectadas e disparadas no próximo ciclo de verificação (a cada 30 segundos).
59+
60+
### Gatilhos de Evento
61+
62+
Gatilhos de evento disparam a automação quando um servidor MCP conectado publica um evento correspondente.
63+
64+
- A conexão deve implementar `TRIGGER_CONFIGURE` (para que o mesh possa registrar/desregistrar interesse em eventos)
65+
- Você especifica a **conexão**, **tipo de evento** e **parâmetros** opcionais para filtragem
66+
- **Fail-atomic**: se a configuração do gatilho na conexão falhar, o gatilho não é criado
67+
- Quando a automação é desativada ou excluída, os gatilhos de evento são desabilitados nas conexões (melhor esforço)
68+
69+
**Filtragem por parâmetros**: Se você especificar parâmetros, apenas eventos cujos dados contenham todos os pares chave-valor correspondentes dispararão a automação. Campos extras nos dados do evento são ignorados.
70+
71+
## Executando e Testando
72+
73+
- Use a ferramenta **AUTOMATION_RUN** ou a interface para disparar uma execução manualmente a qualquer momento
74+
- Cada execução cria um thread visível no [Monitoramento](/pt-br/mcp-mesh/monitoring)
75+
- Execuções com erro são marcadas como falhas no thread
76+
77+
## Segurança e Limites
78+
79+
<Callout type="warning">
80+
Automações executam em modo passthrough — todas as chamadas de ferramentas são auto-aprovadas. Defina cuidadosamente o escopo das ferramentas do seu agente para prevenir ações indesejadas.
81+
</Callout>
82+
83+
- **Concorrência por automação**: Máximo de 3 execuções simultâneas por automação. Gatilhos adicionais são ignorados até que um slot abra.
84+
- **Concorrência global**: Máximo de 10 execuções simultâneas de automação em todo o sistema.
85+
- **Timeout de execução**: Cada execução é limitada a 5 minutos.
86+
- **Prevenção de recursão**: Cadeias de gatilhos de evento são limitadas a uma profundidade de 3. Se as ações de uma automação disparam eventos que ativam outras automações, a cadeia para após 3 níveis.
87+
- **Limite de payload**: Dados de evento são limitados a 1 MB. Payloads maiores são truncados para mitigar riscos de injeção de prompt.
88+
- **Validação do criador**: Se o criador da automação sair da organização, a automação é automaticamente desativada.
89+
90+
## Ferramentas MCP de Automação
91+
92+
Estas ferramentas estão disponíveis para gerenciar automações programaticamente via interface MCP:
93+
94+
| Ferramenta | Descrição |
95+
|---|---|
96+
| `AUTOMATION_CREATE` | Criar uma nova automação com agente, mensagens, modelo e gatilhos |
97+
| `AUTOMATION_GET` | Obter uma automação por ID com configuração completa |
98+
| `AUTOMATION_LIST` | Listar todas as automações na organização atual |
99+
| `AUTOMATION_UPDATE` | Atualizar campos da automação (atualização parcial suportada) |
100+
| `AUTOMATION_DELETE` | Excluir uma automação e desabilitar seus gatilhos de evento |
101+
| `AUTOMATION_TRIGGER_ADD` | Adicionar um gatilho cron ou evento a uma automação |
102+
| `AUTOMATION_TRIGGER_REMOVE` | Remover um gatilho de uma automação |
103+
| `AUTOMATION_RUN` | Disparar manualmente uma execução de automação |
104+
105+
---
106+
107+
**Próximos passos**: Aprenda sobre [Agentes](/pt-br/mcp-mesh/agents) para entender como projetar os MCPs Virtuais que as automações executam, ou explore o [Monitoramento](/pt-br/mcp-mesh/monitoring) para acompanhar execuções de automações.

‎apps/docs/client/src/content/2026-03-10/pt-br/mcp-mesh/concepts.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ icon: BookOpen
1111
- **Conexão**: um endpoint MCP upstream configurado (geralmente HTTP), opcionalmente com credenciais armazenadas. Veja [Conexões](/pt-br/mcp-mesh/connections).
1212
- **MCP Virtual**: agrega ferramentas/recursos/prompts de servidores conectados em um único MCP. Veja [MCPs Virtuais](/pt-br/mcp-mesh/virtual-mcps).
1313
- **Agente**: MCPs Virtuais de propósito único otimizados para tarefas específicas. Veja [Agentes](/pt-br/mcp-mesh/agents).
14+
- **Automação**: execuções autônomas de agentes em agendamento ou gatilho de evento. Veja [Automações](/pt-br/mcp-mesh/automations).
1415
- **Projeto**: MCPs Virtuais para organizar ferramentas, recursos, prompts e configurações específicas de projeto. Veja [Projetos](/pt-br/mcp-mesh/projects).
1516

1617
## Entendendo Agentes vs. Projetos

‎apps/docs/client/src/utils/navigation.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ export async function getNavigationLinks(
3737
"mcp-mesh/virtual-mcps",
3838
"mcp-mesh/projects",
3939
"mcp-mesh/agents",
40+
"mcp-mesh/automations",
4041

4142
// 6. Decopilot
4243
"mcp-mesh/decopilot/overview",

0 commit comments

Comments
 (0)