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:
co-authored by
Claude Sonnet 5
parent
c9ffc580d6
commit
da3b38551f
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user