From da3b38551f7d1776bcec737cdedc58a2542de40b Mon Sep 17 00:00:00 2001 From: Gustavo Date: Tue, 11 Aug 2026 16:39:30 -0300 Subject: [PATCH] docs: registra workflows de exemplo de AI Agent para agendamento (Klingo, ClinicAll, SysLife) Co-Authored-By: Claude Sonnet 5 --- docs/n8n-agendamento-runbook.md | 56 +++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/docs/n8n-agendamento-runbook.md b/docs/n8n-agendamento-runbook.md index 7060ad8..97355dd 100644 --- a/docs/n8n-agendamento-runbook.md +++ b/docs/n8n-agendamento-runbook.md @@ -921,3 +921,59 @@ resolver autenticação (só pendente no Klingo — sem clínica de teste — e no ClinicAll — sem mecanismo documentado; o SysLife já está resolvido), provisionar banco Postgres + credencial, e então ativar os workflows de lembrete e de AI Agent de exemplo. + +## 22. Workflows de exemplo de AI Agent para Agendamento (Klingo, ClinicAll, SysLife) + +**Data:** 11/08/2026. Ver design completo em +`docs/superpowers/specs/2026-08-11-workflows-exemplo-agente-agendamento-design.md` +e plano em +`docs/superpowers/plans/2026-08-11-workflows-exemplo-agente-agendamento.md`. + +**Motivação**: os MCP Servers de agendamento do Klingo, ClinicAll e +SysLife (seção 14) existiam há tempo, mas nenhum tinha um workflow de +agente cliente — diferente da confirmação de agenda (seções 18-20), que +já nasceu com seu próprio exemplo. Esta seção fecha essa lacuna, +seguindo exatamente o mesmo esqueleto dos exemplos de confirmação +(webhook Z-PRO/GChat → `AI Agent` com `OpenAI Chat Model` real + +`Postgres Chat Memory` placeholder), mas conectando nas tools de +**agendamento** — decisão explícita do usuário de manter os dois +propósitos (agendar vs. confirmar) em agentes de exemplo separados por +enquanto, mesmo padrão do Z-PRO em produção (que também só tem +agendamento). + +**Correção de contagem de tools**: durante o brainstorming desta +feature, o Klingo tinha sido citado por engano como tendo 8 tools de +agendamento (confundindo com as 6 tools da API de Telefonia usada na +confirmação, seção 18). Conferido direto no design real +(`docs/superpowers/specs/2026-08-11-mcp-server-nativo-n8n-klingo-design.md`): +o MCP de agendamento do Klingo tem só **2 tools** +(`consultar_horarios`, `agendar`). ClinicAll tem 8, SysLife tem 7 — +esses dois já estavam corretos. + +**Limitação real do Klingo, herdada por este exemplo**: +`consultar_horarios` sempre retorna `SLOT_MAPPING_UNAVAILABLE` — a API +do Klingo responde com sucesso, mas não documenta publicamente o +formato de cada horário individual, então `agendar` (que exige um +`slotId`) não tem como ser alimentado por essa integração hoje. Decisão +explícita do usuário: construir o exemplo mesmo assim, com o +`systemMessage` avisando o agente pra informar essa indisponibilidade +ao paciente em vez de inventar um horário — não é um bug desta +implementação, é uma lacuna documentada da API do Klingo (já registrada +na seção 14.1). + +| Provider | Workflow de exemplo | Tools conectadas | MCP Server consumido | +| --- | --- | --- | --- | +| Klingo | `Agendamento - GChat - Klingo (exemplo)` (`ToilBwbsSdXMCvCI`) | 2 (`consultar_horarios`, `agendar`) | `3eiFEnfOTLnutP78` | +| ClinicAll | `Agendamento - GChat - ClinicAll (exemplo)` (`6E7dXKtG68mN8Xkv`) | 8 (todas) | `igaKjoHcPNYRAxPS` | +| SysLife | `Agendamento - GChat - SysLife (exemplo)` (`6tylTUf0CAWTnrhD`) | 7 (todas) | `TYu78UqIUr2yCBHK` | + +Diferente dos exemplos de confirmação (que filtravam tools específicas +via `includeTools`), o `MCP Client Tool` dos três usa `include: "all"` +— o agente de agendamento precisa de todas as tools do provider pra +completar um fluxo de ponta a ponta. Nenhum sub-workflow de tool foi +criado ou modificado — só os 3 workflows de agente e a conexão via +`MCP Client Tool` aos servidores já existentes. + +Validados estruturalmente (0 erros nos três), deixados **inativos de +propósito** — sem clínica real de nenhum dos três providers nem +credencial Postgres válida, ativá-los só geraria execuções com erro.