docs: registra workflows de exemplo de AI Agent para agendamento (Klingo, ClinicAll, SysLife)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Gustavo
2026-08-11 16:39:30 -03:00
co-authored by Claude Sonnet 5
parent c9ffc580d6
commit da3b38551f
+56
View File
@@ -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.