Observações no SmartFlow
As observações fornecem feedback em tempo real para o seu assistente de IA durante as conversas. Elas permitem que os SmartFlows comuniquem resultados de volta para a IA.
O Que São Observações?
Quando um SmartFlow é executado (acionado por uma Ferramenta de Conversação), ele pode enviar observações de volta para a IA. A IA usa essas observações para:
- Fornecer respostas informadas aos usuários
- Exibir dados recuperados de sistemas externos
- Confirmar que as ações foram concluídas com sucesso
- Lidar com erros de forma elegante
Como Funciona
Usuário faz pergunta → IA aciona SmartFlow → SmartFlow executa →
Observação enviada → IA lê observação → IA responde ao usuário
Exemplo:
- Usuário: "Qual é o status do meu pedido #12345?"
- IA aciona o SmartFlow "Verificar Status do Pedido"
- SmartFlow chama a API de eCommerce
- SmartFlow envia observação:
{"status": "shipped", "tracking": "ABC123"} - IA responde: "Seu pedido #12345 foi enviado! Rastreamento: ABC123"
Configurando Observações
Use o nó de ação Definir Observação em seu SmartFlow:
| Campo | Descrição |
|---|---|
| Observação | Texto ou dados JSON a serem enviados para a IA |
| Variáveis | Use {{variavel}} para incluir dados dinâmicos |
Exemplo de configuração:
{
"status": "{{apiResponse.orderStatus}}",
"tracking": "{{apiResponse.trackingNumber}}",
"estimatedDelivery": "{{apiResponse.eta}}"
}
Melhores Práticas
Mantenha as Observações Concisas
A IA processa observações como contexto. Mantenha-as focadas:
// Bom
{"found": true, "productName": "Blue Widget", "price": 29.99}
// Muito verboso
{"query": "...", "timestamp": "...", "requestId": "...", "fullResponse": {...}}
Lidar com Erros
Sempre inclua tratamento de erros em suas observações:
// Sucesso
{"success": true, "data": {...}}
// Erro
{"success": false, "error": "Pedido não encontrado"}
Use Dados Estruturados
JSON é preferido em relação ao texto simples para dados complexos:
{
"tickets": [
{"id": "JIRA-123", "status": "Em Andamento"},
{"id": "JIRA-124", "status": "Concluído"}
],
"total": 2
}
Casos de Uso Comuns
| Caso de Uso | Observação Contém |
|---|---|
| Consulta de pedido | Status, rastreamento, data de entrega |
| Agendamento de compromisso | Confirmação, data/hora, detalhes |
| Pesquisa de conhecimento | Artigos relevantes, resumos |
| Consulta de CRM | Informações do cliente, histórico |
| Verificação de inventário | Níveis de estoque, disponibilidade |
Relacionados
- Ação Definir Observação — Referência do nó
- Gatilho da Ferramenta de Conversação — Como a IA aciona fluxos
- Ação Solicitação de IA — Solicitar processamento da IA