📘 Guia do Usuário Diamond – Introdução

Bem-vindo ao Guia do Usuário do Teemant.

Este guia foi desenvolvido para ajudar você a entender como configurar e operar um espaço de trabalho Teemant, desde a configuração geral até o uso diário. Ele fornece uma visão geral estruturada de cada seção da plataforma e explica a finalidade de cada recurso, sem entrar em detalhes de implementação de baixo nível.

🎯 Objetivo deste guia

O objetivo desta documentação é:

Fornecer a você um modelo mental claro de como o Teemant funciona,
Explique a função de cada componente do espaço de trabalho.
Ajudar administradores, gerentes e construtores a navegar na plataforma com confiança.

Este não é um tutorial passo a passo. Em vez disso, ele se concentra em conceitos, responsabilidades e melhores práticas, para que a documentação permaneça fácil de manter e evolua suavemente com o produto.

Página inicial (Painel de controle)
Contextos de IA
Guias de IA
Mensagens
Eventos
Identificadores
Ferramentas

Visão
Saídas
Documentos
Modelos de Objetos
Configurações do espaço de trabalho
Membros do Espaço de Trabalho
Usuários do Agente do Espaço de Trabalho

Canais do Espaço de Trabalho
Transportes no espaço de trabalho
Tarefas do Espaço de Trabalho
Construtor de Agentes Diamante
Agente Teenant liga para

👥 Para quem é este guia

Este guia destina-se a:

Administradores de espaço de trabalho que gerenciam a configuração e o acesso,
Gerentes que supervisionam usuários, canais e operações,
Construtores de bots que projetam agentes, fluxos e automações.

Dependendo da sua função, algumas seções podem ser mais relevantes do que outras.

🧭 Como ler este guia

O guia segue a estrutura do espaço de trabalho Teemant:

Cada seção corresponde a uma entrada de menu na plataforma.
Você pode ler o texto em ordem cronológica ou acessar diretamente um tópico específico usando o índice abaixo.
Capturas de tela e ícones são usados para ajudar você a reconhecer rapidamente os recursos da interface.

Para casos de uso avançados (integrações personalizadas, APIs ou fluxos de trabalho complexos), documentação ou suporte adicionais podem ser necessários.

🏠 Página inicial (Painel de controle)

A aba Início é o painel de controle do espaço de trabalho.

Oferece uma visão geral da atividade e do uso, como:

número de usuários,
número de bots ou agentes ativos,
indicadores de conversão ou conclusão,
Tendências de atividade ao longo do tempo.

O painel de controle da página inicial é usado para:

monitoramento do uso da plataforma,
Entendendo os níveis de adoção e atividade,
Obtendo uma visão geral rápida do status sem precisar acessar telas de configuração.

Não inclui funcionalidades de configuração ou gestão de dados.

🗃️ Entidades

As entidades representam os bancos de dados reais de dados externos sincronizados dentro do Teemant.

Eles são normalmente usados para:

dados de referência (ex: lojas, locais, unidades organizacionais),
objetos de negócios provenientes de sistemas externos,
Conjuntos de dados compartilhados entre agentes e processos.

Características principais:

Entidades são conjuntos de dados estruturados, não elementos conversacionais.
Eles geralmente são sincronizados de ou para sistemas externos por meio de importações ou tarefas.
Agentes e guias podem ler entidades para validar ou enriquecer as entradas do usuário.

Resumidamente:

👉 As entidades são onde os dados empresariais estruturados residem dentro do Teemant.

🛠️ Construtor

O Builder é onde a inteligência de processos é projetada.

É utilizado para:

Criar guias (lógica, perguntas, validações, fluxos),
Reunir agentes com base nesses guias,
Definir como os diferentes elementos funcionam em conjunto.

Dentro do Construtor, você define:

como um agente se comporta,
Que dados espera,
Que tipos de documentos ele pode processar (e-mails, arquivos, payloads JSON, anexos)?
Como as informações são coletadas, validadas e preparadas.

O Builder é a área central de design da Teemant:

Os guias definem o que coletar e como,
Os agentes combinam guias com dados, documentos e lógica para executar processos reais.

⚙️ Espaço de trabalho

A seção Espaço de Trabalho contém configurações globais e administrativas.

É utilizado para gerenciar:

Configuração geral do espaço de trabalho,
administradores e usuários agentes registrados,
canais de comunicação (ex: WhatsApp, e-mail, outros canais),
Configurações de nível de ambiente (desenvolvimento, teste, produção).

As configurações do espaço de trabalho controlam quem pode acessar a plataforma, por meio de quais canais e com quais permissões.

Aqui não se define nenhuma lógica de negócio — trata-se de algo puramente operacional e administrativo.

🔗 Transportes

Os transportes definem os meios técnicos de transferência de dados entre o Teemant e sistemas externos.

Exemplos incluem:

SFTP push ou pull,
trocas baseadas em arquivos,
transferências via e-mail.

Um meio de transporte responde à pergunta:

👉 “Como os dados se movem fisicamente entre sistemas?”

Não define:

Que dados são trocados?
quando for trocado,
ou como é interpretado.

🔄 Tarefas

As tarefas são usadas para digitalizar, importar ou sincronizar fontes de dados externas.

Eles geralmente:

Monitorar bancos de dados externos ou locais de arquivos,
acionar importações,
Atualizar entidades com dados novos ou alterados.

As tarefas se concentram na ingestão e sincronização de dados, não na interação com o usuário.

Voltar ao topo

🧠 Contextos de IA

Os contextos de IA definem o ambiente comportamental e semântico no qual a IA opera.

Eles fornecem à IA informações básicas, intenções e regras de comunicação, garantindo que as interações permaneçam consistentes, relevantes e alinhadas às expectativas do negócio.

Os contextos de IA são usados por ambos:

agentes conversacionais (chatbots),
e processos de automação de e-mail.

🌐 Contextos Globais

Os Contextos Globais descrevem informações gerais e transversais que se aplicam a toda a organização ou ambiente de trabalho.

Normalmente incluem:

Descrição da empresa ou organização,
regras ou terminologia geral de negócios,
tom geral e estilo de comunicação,
restrições ou pressupostos comuns.

Os contextos globais atuam como uma base comum que pode ser reutilizada por diversos agentes e processos, garantindo a coerência em nível de plataforma.

🤖 Contextos do Agente

Os contextos de agente são específicos para um determinado agente ou caso de uso.

Eles definem:

O que se espera que o agente faça (por exemplo, coletar dados de declaração de incidentes),
Quem são os usuários (funcionários, clientes, parceiros, equipes internas),
Como o agente deve se comunicar (tom, nível de formalidade, requisitos de clareza),
Quaisquer restrições específicas da função ou do processo.

Os contextos dos agentes permitem que a IA adapte seu comportamento dependendo do processo de negócio que ela suporta.

🧩 Papel dos Contextos de IA nos Guias

Ao criar Guias de IA, o criador deve selecionar o Contexto de Agente apropriado.

O contexto selecionado é, portanto:

aplicado durante cada conversa, ou
Utilizado durante os fluxos de trabalho de processamento de e-mails.

O contexto garante que

A IA compreende o seu papel,
As interações permanecem alinhadas com o processo pretendido.
As respostas são consistentes em todos os canais.

Resumidamente:

👉 Os Contextos de IA definem como a IA pensa e se comunica, enquanto os Guias definem o que a IA faz.

Voltar ao topo

🧩 Guias de IA

Os Guias de IA definem as instruções usadas pela IA durante:

conversas ao vivo (chatbots),
e processamento de e-mails (Automação de E-mail).

Um guia descreve quais informações devem ser coletadas ou processadas, como a IA deve se comportar e como os dados são estruturados, mas não define a lógica de transporte ou integração.

Os Guias de IA são executados por Agentes e sempre operam dentro de um Contexto de IA definido.

Tipos de guia

A Teemant oferece diversos tipos de Guias de IA, cada um com uma finalidade específica dentro de um processo.

📥 Guias de Coleta de Dados

Os Guias de Coleta de Dados são utilizados para coletar informações estruturadas com base em um modelo de dados predefinido.

Uma vez definido o modelo de dados (campos, formatos, restrições), um guia pode ser construído com o auxílio de IA.

Cada etapa de um Guia de Coleta de Dados normalmente define:

um nome de exibição (legível para humanos),
um nome de área técnica,
um tipo de campo (texto, número, endereço, data, etc.),
Instruções para o bot explicando como a IA deve coletar ou validar as informações.
Instruções opcionais para o usuário quando uma ação específica for necessária.

As instruções do bot podem incluir:

validações,
dependências em valores coletados anteriormente,
Comportamento condicional.
Os guias de coleta de dados são usados tanto em fluxos de conversação quanto na automação de e-mails.

✅ Guias de lista de verificação

Os Guias de Lista de Verificação são semelhantes aos Guias de Coleta de Dados, mas são projetados para perguntas fechadas.

Eles geralmente definem:

a pergunta exibida,
Opções disponíveis (Sim/Não ou similar),
instruções do bot,
instruções opcionais para o usuário,
Se um comentário é necessário (verdadeiro / falso).

Os guias de listas de verificação são comumente usados para:

verificações de conformidade,
etapas de validação,
confirmações processuais.

🧮 Guias de Campos Calculados

Os Guias de Campos Calculados definem campos que são calculados automaticamente com base em valores coletados anteriormente.

Eles:

confiar apenas nas instruções do bot,
nunca exigir entrada do usuário,
não são exibidas aos usuários.

Os campos calculados podem ser usados em diferentes etapas de um processo para:

valores agregados,
calcular totais,
obter resultados intermediários.
Esses campos são internos ao processo, mas podem ser usados posteriormente para saídas ou integrações.

Estrutura da interface do guia

Cada Guia de IA está organizado em três abas principais:

📄 Detalhes

A aba Detalhes contém as configurações gerais do guia, tais como:

nome de exibição,
tipo de guia,
contexto de IA associado,
agente vinculado,
descrição.

Esta aba define o que é o guia.

🛠️ Construir

A aba "Construir" é onde a lógica do guia é definida.

Exibe:

a lista de campos ou perguntas à esquerda,
As instruções e o auxílio da IA são apresentados à direita.
Esta aba define o comportamento do guia.

✉️ Resposta (somente automação de e-mail)

A aba Resposta é usada exclusivamente para Automação de E-mail.

Permite a configuração de:

um modelo de resposta por e-mail,
arquivos de modelo anexados,
assinatura de e-mail.
Esta aba define como a IA responde por e-mail assim que o processamento estiver concluído ou quando forem necessárias informações adicionais.

Resumo

Resumidamente:

Os contextos de IA definem como a IA pensa e se comunica.
Os Guias de IA definem o que a IA deve coletar, calcular ou validar.
Os agentes executam guias dentro de um processo.
Os modelos de resposta aplicam-se apenas a interações por e-mail.

Se você quiser, podemos fazer o seguinte:

Para uma versão resumida, basta clicar em "Visão Geral Rápida".
ou alinhe a redação exatamente com os rótulos do menu para manter a consistência em todas as páginas de Ajuda.

Voltar ao topo

💬 Mensagens

As mensagens são mensagens predefinidas, não geradas por IA, que podem ser enviadas durante uma conversa.

São mensagens codificadas, o que significa:

Eles não são gerados pela IA.
Eles não utilizam raciocínio de IA nem contexto.
Eles não são traduzidos automaticamente.

As mensagens são normalmente usadas para pontos de comunicação fixos em um processo.

Objetivo das mensagens

As mensagens são elaboradas para:

Enviar confirmações (por exemplo, confirmação de fim de conversa),
Exibir informações padronizadas,
Assegure-se de que a redação seja exata onde não se deseja variabilidade.

Elas oferecem uma maneira de transmitir mensagens controladas e determinísticas juntamente com interações orientadas por IA.

Como as mensagens são usadas

As mensagens podem ser acionadas:

em etapas específicas de uma conversa,
ao final de um processo,
como notificações do sistema durante uma interação.

Eles são comumente usados em conjunto com:

Guias de IA (que lidam com lógica dinâmica),
Agentes (que orquestram o fluxo).

Características principais

As mensagens são estáticas.
São específicos para cada idioma e, se necessário, devem ser criados separadamente para cada idioma.
Eles garantem controle total sobre a redação, o tom e o texto sensível a questões legais ou de conformidade.

Resumidamente:

👉 As mensagens complementam as interações de IA, fornecendo blocos de comunicação fixos e confiáveis onde a variabilidade não é aceitável.

Voltar ao topo

⚡ Eventos

Os eventos representam ocorrências internas do sistema geradas durante a execução de processos.

Elas têm como objetivo capturar momentos significativos no ciclo de vida de uma conversa, na execução de um agente ou em um fluxo de processamento de dados. Os eventos podem ser acionados automaticamente pela plataforma com base em condições predefinidas ou na atividade do sistema.

Esta seção será usada posteriormente para descrever como os eventos são definidos, registrados e aproveitados no Teemant para dar suporte a cenários de monitoramento, automação ou integração.

Nesta fase, os eventos devem ser considerados marcadores técnicos que refletem o que acontece dentro da plataforma durante a execução do processo.

Voltar ao topo

🔑 Identificadores

Os identificadores são números de referência cronológicos únicos gerados pelo Teemant para identificar cada interação processada.

Eles são usados para rastrear:

conversas,
fluxos de processamento de e-mail,
e os registros comerciais resultantes trocados com sistemas externos.

Um identificador funciona como a referência técnica de uma instância de processo do início ao fim.

Finalidade dos Identificadores

Os identificadores são usados para:

Identificar exclusivamente uma conversa ou instância de processamento de e-mail,
Garantir a rastreabilidade em todo o ciclo de vida do processo.
faça referência ao mesmo caso em sistemas de informação externos,
Facilitar auditorias, monitoramento e resolução de problemas.

Elas fornecem uma chave de referência estável compartilhada entre o Teemant, os usuários e os sistemas externos.

Estrutura do identificador

Um identificador é definido usando uma máscara, que pode incluir:

um contador incremental,
elementos de data ou hora,
Um prefixo fixo que identifica o processo ou ambiente.

Exemplo de estrutura:

prefixo (ex: DEMO),
número incremental,
ano ou data e hora.

Isso permite que os identificadores sejam:

legível,
classificável,
e únicas ao longo do tempo.

Quando os identificadores são gerados

Os identificadores são gerados no final de um processo, imediatamente antes de:

As notificações por e-mail são enviadas.
Os dados são exportados para sistemas de informação externos.
As mensagens de confirmação finais são entregues.

Isso garante que:

Todos os dados coletados ou calculados foram finalizados.
O identificador reflete um processo concluído.
O mesmo identificador pode ser reutilizado de forma consistente em todas as saídas, notificações e integrações.

Papel no acompanhamento de processos

Uma vez gerado, o identificador pode ser:

incluídos em e-mails ou notificações,
incorporados em arquivos ou cargas úteis exportados,
Armazenado em sistemas externos como chave de referência.

Resumidamente:

👉 Os identificadores tornam cada interação rastreável, auditável e vinculável entre sistemas.

Voltar ao topo

🧰 Ferramentas

As ferramentas são aplicações externas que podem ser acionadas de dentro do Teemant durante um processo.

Elas permitem que a Teemant amplie suas capacidades, delegando ações específicas a aplicativos especializados de terceiros, enquanto mantém o processo geral orquestrado pela Teemant.

Finalidade das ferramentas

As ferramentas são utilizadas quando um processo requer uma ação que:

não pode ser executado diretamente pela IA,
deve ser tratado por um sistema externo certificado ou especializado,
Requer interação do usuário fora da interface conversacional.

Os casos de uso típicos incluem:

captura de fotos certificadas e criptografadas,
coletar uma assinatura digital em um smartphone,
Executar ações regulamentadas ou que exijam conformidade com as normas.

Como as ferramentas são usadas nos processos

Uma ferramenta pode ser:

acionado em uma etapa específica durante uma conversa,
invocado como parte de um processo baseado em e-mail,
incorporado ao fluxo de trabalho do agente.

Quando acionada, a função redireciona ou guia o usuário para o aplicativo externo, e o resultado é então retornado ao Teemant para que o processo continue.

Integração e parcerias

Todas as ferramentas requerem:

uma integração técnica com a Teemant,
e são fornecidas por parceiros certificados pela Teemant.

Isso garante:

segurança e integridade de dados,
conformidade com os requisitos regulamentares,
troca confiável de informações entre sistemas.

Diversas aplicações externas podem ser integradas ao longo do tempo, dependendo das necessidades do negócio e das soluções disponíveis dos parceiros.

Resumo

Resumidamente:

👉 As ferramentas permitem que a Teemant interaja com aplicativos externos para executar ações especializadas que vão além da IA conversacional, mantendo-se totalmente integrada ao fluxo geral do processo.

Voltar ao topo

👁️ Visão

Visão – Inteligência de Documentos e Imagens

O módulo Vision gerencia a extração de informações de documentos e imagens dentro do Teemant.

A Vision é um agente de IA independente, especializado em ler, analisar e interpretar documentos ou imagens para produzir dados estruturados e utilizáveis.

A tecnologia Vision vai além do OCR básico: ela combina extração visual com compreensão e validação orientadas por IA.

Visão como um agente de IA especializado

Cada Visão é configurada como um agente de IA dedicado com suas próprias características:

Propósito,
Contexto do documento,
Modelo de extração,
Lógica de processamento de IA.

O agente Vision é responsável por:

Leitura de documentos ou imagens (PDFs, digitalizações, fotos),
Extração de informações brutas usando OCR ou análise de imagem,
Aplicando a lógica de IA da Teemant aos dados extraídos para interpretá-los, normalizá-los e estruturá-los.

Essa camada adicional de processamento de IA permite que o Vision lide com layouts complexos, conteúdo manuscrito e informações ambíguas.

Contexto do documento

Cada visão está associada a um contexto de documento.

O Contexto do Documento define:

O tipo de documento que está sendo processado (ex: boletim de ocorrência, certificado, fatura, formulário manuscrito),
O significado semântico do documento,
A estrutura e a lógica de negócios esperadas.

Esse contexto orienta o agente Vision para que ele saiba:

Que informações procurar,
Como interpretar os valores extraídos,
Como aplicar regras específicas do domínio durante o processamento.

Fluxo de Extração, Processamento e Validação

O fluxo de trabalho Vision segue sempre o mesmo princípio:

Extração: O texto bruto e as informações visuais são extraídos do documento ou da imagem usando um mecanismo de OCR ou de visão computacional.
O Process Teemant AI processa o conteúdo extraído campo por campo:

Mapeia dados para campos estruturados,
Aplica formatação e normalização.
Interpreta valores ambíguos ou parciais.

Validar (opcional) Durante uma conversa, o agente Vision pode interagir com o usuário para:

Confirme os valores extraídos.
Solicitar informações em falta,
Corrija ou refine os dados.

Esta etapa de validação é particularmente útil para documentos manuscritos ou digitalizações de baixa qualidade.

Fornecedores de serviços de visão

O Teemant suporta vários backends de visão, dependendo do caso de uso:

O Microsoft Document Intelligence é normalmente usado para documentos complexos, estruturados ou manuscritos, com modelos treinados sob medida.

O Mistral OCR realiza OCR direto via API, sendo mais fácil de integrar, porém geralmente menos confiável para documentos complexos.

Plataformas Vision adicionais poderão ser integradas no futuro.

Independentemente do fornecedor, a lógica do Vision permanece a mesma: extrair → processar com IA → validar opcionalmente com o usuário.

Visão em processos de ponta a ponta

Os agentes de visão são projetados para serem integrados a fluxos de trabalho mais amplos do Teemant, incluindo:

Guias de coleta de dados,
Declarações de incidentes ou reclamações,
Automação de e-mail,
Exportações estruturadas para sistemas de informação.

Ao transformar documentos não estruturados em dados estruturados e validados, o Vision desempenha um papel fundamental na automatização de processos que envolvem grande volume de documentos dentro da Teemant.

Voltar ao topo

📤 Saídas

O módulo Outputs gerencia todos os fluxos de saída do Teemant. Ele define como os dados, documentos e notificações produzidos pelos agentes de IA são entregues a sistemas, aplicativos e usuários externos.

Os resultados podem incluir:

Notificações por e-mail com conteúdo estruturado ou não estruturado
Exportação de arquivos (JSON, arquivos de mídia, arquivos ZIP, documentos gerados)
Transferências SFTP
APIs, webhooks e outros conectores de saída usados para integrar o Teemant com sistemas de informação empresariais.

Cada configuração de saída permite definir:

O mecanismo de transporte (servidor de e-mail, SFTP, endpoint de API, webhook, etc.)
Os documentos e formatos de dados a serem enviados
O conteúdo e a estrutura das notificações ou das cargas úteis exportadas.
Se o servidor de e-mail padrão do Teemant ou um servidor de transporte dedicado for utilizado.

Os resultados são normalmente acionados ao final de um processo, após a coleta de dados, o processamento por IA, as validações e a geração de identificadores terem sido concluídos. Eles garantem que os resultados sejam entregues de forma confiável, rastreável e pronta para integração.

Este módulo representa a camada final de entrega do Teemant, permitindo uma comunicação perfeita entre fluxos de trabalho orientados por IA e sistemas externos.

Voltar ao topo

📄 Documentos

A seção Documentos centraliza todo o conteúdo produzido, enviado ou gerenciado pelo Teemant ao longo de um processo. Ela abrange e-mails, documentos técnicos (como JSON) e arquivos de mídia (fotos, anexos, documentos gerados).

Os documentos são normalmente usados por saídas (notificações por e-mail, exportações SFTP, APIs, webhooks, conectores de saída) e podem incluir variáveis dinâmicas provenientes de conversas, processamento de IA e lógica de negócios.

✉️ E-mails

Os e-mails são o tipo de documento mais comum no Teemant.

Eles estão acostumados a:

notificar os usuários finais,
confirmar uma declaração ou ação,
comunicar com as equipes internas,
ou transmitir informações a parceiros.

Cada documento de e-mail define:

destinatários (Para / Cc / Cco),
um sujeito dinâmico (por exemplo, usando {app.identifier}),
um corpo de conteúdo personalizável,
e um mecanismo de modelagem.

Mecanismos de modelagem disponíveis

Freemarker: Um mecanismo de modelos padrão e poderoso, ideal para e-mails complexos com condições, loops e formatação HTML avançada.
Mecanismo de modelos Teemant: Um mecanismo interno mais simples, projetado para criar rapidamente e-mails claros e fáceis de manter, com inserção de variáveis descomplicada.

As variáveis (por exemplo, {app.accidentDate}, {user.email}…) são resolvidas automaticamente no momento do envio, com base nos dados coletados e processados pelo Teemant.

🧾 JSON e conteúdo técnico

Os documentos não se limitam a e-mails.

O Teemant também gerencia documentos JSON usados para:

Injeção de dados em sistemas de informação,
exportações estruturadas,
Integrações via APIs, webhooks e conectores de saída.

Esses documentos estruturados garantem trocas de dados confiáveis, consistentes e padronizadas com sistemas externos.

📎 Mídia e arquivos

A categoria Mídia agrupa todos os arquivos manipulados durante um processo:

fotos,
documentos enviados pelo usuário,
arquivos gerados automaticamente,
Resultados do Vision (OCR, análise de imagem),
anexos enviados por e-mail ou exportados.

Os arquivos de mídia podem ser:

armazenado,
analisado,
exportados através de saídas (e-mail, SFTP, API, webhooks, etc.),
ou vinculado a uma conversa, um identificador ou um processo de negócios.

🎯 Resumo

A seção Documentos é a base para todo o conteúdo técnico e de saída do Teemant.

Isso permite que você:

Centralizar e-mails e documentos,
padronizar formatos,
Injetar dinamicamente dados gerados por IA e dados conversacionais,
e garantir uma integração perfeita com sistemas externos.

Voltar ao topo

🧱 Modelos de Objetos

Os Modelos de Objeto definem a camada de dados estruturados do Teemant. Eles são usados para modelar dados de referência, dados operacionais e objetos de configuração específicos do espaço de trabalho que são compartilhados entre agentes, processos e integrações.

Elas servem a dois propósitos principais.

1️⃣ Modelos de Dados de Referência e de Negócio (Sincronização de Dados)

Os modelos de objetos são usados para construir bancos de dados estruturados que representam dados de referência ou de negócios exigidos pelos processos do Teemant, por exemplo:

Lojas, agências, subsidiárias
Veículos, produtos, contratos, políticas
Qualquer conjunto de dados de referência externo usado durante conversas, processamento de documentos ou roteamento.

Esses modelos podem então ser:

Sincronizado com sistemas de informação externos
Mantive-me atualizado usando:
Transportes → como os dados são trocados (SFTP, APIs, conectores, etc.)
Tarefas → quando e com que frequência a sincronização é executada (sob demanda, agendada, incremental, etc.)

Isso permite que a Teemant trabalhe com dados empresariais confiáveis e em tempo real, garantindo que os agentes de IA sempre contem com informações consistentes e atualizadas.

2️⃣ Objetos de Configuração do Espaço de Trabalho (Propriedades Dinâmicas do Espaço de Trabalho)

Os modelos de objeto também podem definir propriedades personalizadas no nível do espaço de trabalho.

Esses não são conjuntos de dados de referência, mas sim objetos de configuração associados a um espaço de trabalho, como:

Destinatários especiais de e-mail (ex: e-mail de RC, e-mail de escalonamento, e-mail de parceiros)
Identificadores, códigos ou parâmetros comerciais específicos de um espaço de trabalho.
Qualquer propriedade personalizada que deva aparecer nas Configurações do Espaço de Trabalho.

Uma vez definido:

Esses campos ficam automaticamente disponíveis na configuração do Espaço de Trabalho.
Eles podem ser reutilizados em diversas aplicações:
Documentos e notificações
Saídas
Guias de IA
Automações e lógica de roteamento

Isso faz dos Modelos de Objeto uma maneira poderosa de estender o Teemant sem código personalizado, simplesmente modelando novas propriedades estruturadas.

Tipos de campos suportados

Os modelos de objeto suportam um conjunto controlado de tipos de campo para garantir consistência e interoperabilidade, incluindo:

corda
inteiro
número
e-mail
data
localização
contente

Esses tipos de dados são projetados para serem totalmente compatíveis com processamento de IA, modelos de documentos, exportações e integrações.

Por que os modelos de objetos são importantes

Os modelos de objetos são a base da arquitetura de dados da Teemant:

Eles estruturam a forma como os dados são armazenados, compartilhados e sincronizados.
Eles conectam agentes de IA com sistemas empresariais.
Eles permitem que os espaços de trabalho sejam personalizados de forma organizada e escalável.

Resumindo, os Modelos de Objetos transformam o Teemant em uma plataforma de IA orientada a dados, e não apenas em uma plataforma conversacional.

Voltar ao topo

🧱 Configurações do espaço de trabalho

Um espaço de trabalho representa um inquilino lógico no Teemant. Ele define os limites funcionais, técnicos e organizacionais dentro dos quais agentes, dados, integrações e usuários operam. Na prática, um espaço de trabalho geralmente corresponde a um ambiente (desenvolvimento, teste, produção) ou a uma unidade de negócios ou cliente específico.

Meio Ambiente e Governança (Principal)

A aba Principal centraliza a configuração essencial do espaço de trabalho:

Nome, localidade e fuso horário

Essas configurações definem como o conteúdo é localizado (idioma, formatos de data) e como a lógica baseada em tempo (eventos, tarefas, notificações) é avaliada.

Boa prática: múltiplos espaços de trabalho

É altamente recomendável criar espaços de trabalho separados para:

Desenvolvimento (experimentação e configuração),
Testes / UAT (validação e aprovação comercial),
Produção (operações reais, usuários finais). Isso garante isolamento, segurança e implantações controladas.

Espaço de trabalho público

Quando um espaço de trabalho é marcado como Público, ele se torna acessível aos usuários finais, dependendo do canal:

WhatsApp: qualquer usuário com uma conta Meta WhatsApp,
Microsoft Teams / Google Chat: usuários autorizados a instalar o aplicativo Teemant. Isso é especialmente útil para cenários de grande escala ou com usuários abertos.

Endereços de e-mail de contato padrão Os endereços de e-mail de contato definidos aqui atuam como destinatários globais alternativos para notificações e saídas (e-mails, alertas, exportações) quando nenhum destino mais específico for configurado.

Fornecedores e serviços de IA

A aba Fornecedores é onde o espaço de trabalho se conecta ao seu ecossistema tecnológico:

As chaves de API para LLMs, mecanismos de OCR, IA de Visão/Documentação e outros serviços de IA são configuradas aqui.
Os clientes podem:
trazer suas próprias chaves de API, ou
Dependem das chaves fornecidas pela Teemant, dependendo da configuração e do acordo.
Essa configuração se aplica a todo o espaço de trabalho e é reutilizada por agentes, Vision, processamento de documentos e recursos de automação.

Configurações de negócios específicas do espaço de trabalho (modelos de objeto)

A terceira aba (por exemplo, “Auchan Gestionnaires” nas capturas de tela) ilustra como os Modelos de Objeto são usados no nível do espaço de trabalho:

Esses objetos definem propriedades personalizadas do próprio espaço de trabalho, tais como:
endereços de e-mail de destinatários especiais (por exemplo, RC Email, DAB Email),
campos de configuração específicos do negócio,
Quaisquer metadados específicos do domínio exigidos pelos fluxos de trabalho ou resultados.

Uma vez definidos, esses campos aparecem diretamente nas configurações do espaço de trabalho e podem ser referenciados por:
agentes,
documentos e modelos,
saídas (e-mails, APIs, exportações),
integrações.

Resumindo, o espaço de trabalho não é apenas um contêiner: é a camada de configuração central que interliga ambientes, usuários, provedores de IA, regras de negócios e integrações, garantindo consistência e controle em toda a plataforma Teemant.

Voltar ao topo

👥 Membros do Espaço de Trabalho

Os membros do Workspace são os administradores de um Workspace (inquilino). Eles são responsáveis por configurar, gerenciar e governar como o Teemant é usado em um determinado ambiente.

Os membros são usuários internos (suas equipes, parceiros ou integradores), não usuários finais que interagem com chatbots ou e-mails.

Funções e permissões

Cada membro do espaço de trabalho pode ter uma ou mais das seguintes funções:

Administrador
Acesso total à configuração do espaço de trabalho
É possível gerenciar configurações, provedores, usuários, canais, saídas, documentos, etc.
Não é possível criar agentes de IA
Gerente
Permite gerenciar usuários, canais, configurações e configurações operacionais.
Não é possível criar agentes de IA
Construtor de Bots
Só é possível criar e configurar agentes de IA (Guias de IA, contextos, fluxos).
Sem acesso à administração em nível de espaço de trabalho.

Essa separação de funções garante governança clara, segurança e implantações controladas.

Melhores práticas

Espaço de trabalho de desenvolvimento
Conceda todas as funções (Administrador, Gerente, Construtor de Bots)
Este é o único lugar onde agentes de IA são projetados e configurados.
Espaços de trabalho para teste e produção
Funções apenas de Administrador e/ou Gerente de Subvenções
Não é permitida a criação de agentes.
Os agentes são implantados aqui, não criados.
Um espaço de trabalho por aplicação cliente.
É altamente recomendável manter as configurações isoladas.
Melhora a segurança, a facilidade de manutenção e a clareza de implementação.

Por que isso é importante

Esta abordagem:

Impede alterações acidentais na produção.
Impõe um ciclo de vida limpo de compilação → teste → implantação.
Facilita muito as auditorias, o suporte e a resolução de problemas.
Alinhado com as práticas de TI e DevOps de nível empresarial.

Os membros do espaço de trabalho definem quem pode fazer o quê, enquanto os agentes de IA definem o que o sistema faz.

Voltar ao topo

👥 Usuários do Agente do Espaço de Trabalho (Usuários Finais)

Os usuários agentes são os usuários finais que podem acessar e interagir com os agentes da Teemant (chatbots, automação de e-mail, etc.) dentro de um espaço de trabalho.

Eles não são administradores e não configuram a plataforma. Sua função é exclusivamente utilizar os agentes por meio dos canais de interação habilitados.

🔐 Regras de Acesso

O acesso aos agentes depende da visibilidade do espaço de trabalho:

Espaço de trabalho privado (padrão). Somente usuários explicitamente definidos como Usuários Agentes podem ver e interagir com os agentes.

Espaço de trabalho público. Todos os usuários que têm acesso ao canal podem interagir com os agentes:
WhatsApp: qualquer usuário autenticado no Meta WhatsApp
Microsoft Teams: usuários autorizados a instalar/usar o aplicativo Teemant
Google Chat: usuários autorizados no Google Workspace

Cada usuário agente pode ser:

Ativado ou desativado
Associado a um ou mais canais
Configurado com informações de idioma e contato.

📱 Melhores práticas específicas para cada canal

O controle de acesso deve seguir a lógica de cada canal:

O gerenciamento de acesso ao Microsoft Teams / Google Chat / e-mail geralmente é feito pela equipe de TI do cliente ou pelo provedor de identidade (Azure AD, Google Workspace, sistemas de e-mail, etc.).

WhatsApp: Como o WhatsApp geralmente é aberto ao público, a autenticação deve ser tratada internamente ao processo, por exemplo:
ID de funcionário ou agente
Número da placa do veículo
Número da apólice ou do contrato
Verificação baseada em documentos (RG, formulário, foto, etc.)

Essa lógica de autenticação geralmente é implementada no Guia de IA e no fluxo de conversa, e não no nível do canal.

✅ Práticas Recomendadas

Mantenha os usuários agentes estritamente separados dos membros do espaço de trabalho (administradores, gerentes, construtores).
Utilize espaços de trabalho privados para implantações controladas.
Delegue o controle de identidade e acesso aos sistemas do cliente sempre que possível.
Projete etapas de autenticação explícitas em fluxos de conversação, especialmente para canais públicos como o WhatsApp.

Resumindo, os Usuários Agentes definem quem pode interagir com a IA, enquanto os Membros do Espaço de Trabalho definem quem pode configurá-la.

Voltar ao topo

🔌 Canais do Espaço de Trabalho

Os canais definem como os usuários interagem com os agentes da Teemant e onde as mensagens, e-mails ou conversas são recebidas e enviadas.

Cada canal representa uma integração concreta com uma plataforma de comunicação externa, como WhatsApp, Microsoft Teams, Google Chat, sistemas de e-mail ou ferramentas de chat ao vivo.

Um espaço de trabalho pode ter vários canais ativados simultaneamente, permitindo que os mesmos agentes de IA operem de forma consistente em diferentes pontos de contato.

💬 Canais de bate-papo (conversacionais)

📱 WhatsApp

Os canais do WhatsApp conectam o Teemant às contas Meta do WhatsApp Business usando um número de telefone dedicado.

Como funciona:

Qualquer usuário autenticado no WhatsApp pode entrar em contato com o bot através do número configurado.
A visibilidade do espaço de trabalho (público ou privado) determina se é necessário controle de acesso adicional.
Na maioria dos casos de uso reais, a autenticação é tratada dentro do fluxo de IA, e não pelo próprio WhatsApp (por exemplo, ID do funcionário, número do crachá, placa do veículo, ID do documento, etc.).
O WhatsApp é normalmente usado para usuários externos ou para um público amplo.

Boas práticas:

Utilize autenticação conversacional dentro da lógica do agente quando dados sensíveis estiverem envolvidos.

💼 Microsoft Teams

Os canais do Microsoft Teams permitem que os agentes da Teemant operem dentro de um tenant da Microsoft.

Como funciona:

O acesso é restrito a usuários autenticados no locatário do Teams configurado.
O ID do locatário do Teams define o escopo dos usuários autorizados.
Ideal para uso interno (suporte de TI, RH, operações, assistentes internos).

Boas práticas:

Deixe que o Teams gerencie a identidade e o acesso; evite duplicar a lógica de autenticação dentro do bot, a menos que seja necessário.

💬 Google Chat

Os canais do Google Chat conectam o Teemant a um domínio do Google Workspace.

Como funciona:

Somente usuários autenticados no domínio do Google configurado podem acessar o bot.
O controle de acesso é gerenciado naturalmente pelas permissões do Google Workspace.
Ideal para assistentes internos corporativos.

🧑‍💻 Bate-papo ao vivo (Chatwoot)

Os canais LiveChat conectam o Teemant a plataformas de bate-papo de terceiros, como o Chatwoot.

Como funciona:

O Teemant funciona como uma camada de IA por trás do sistema de chat ao vivo.
A IA pode automatizar respostas de primeiro nível, coleta de dados e triagem.
Agentes humanos podem assumir as conversas quando necessário.

Boas práticas:

Utilize as integrações do LiveChat para fluxos de trabalho híbridos com IA e suporte humano.

📧 Canais de e-mail

📩 Google Mail

Os canais do Google Mail permitem que o Teemant leia, classifique e responda a e-mails de uma caixa de correio alvo.

Conceitos-chave:

São necessárias credenciais OAuth (ID do Cliente, Segredo, Token de Atualização).
Os e-mails são processados por agentes de IA para classificação, extração de dados e elaboração de respostas.
A gestão de consentimento garante a conformidade com a autorização do usuário.

📬 Microsoft Mail

Os canais do Microsoft Mail integram-se com as caixas de correio do Microsoft 365.

Como funciona:

Os e-mails são recebidos, analisados e encaminhados para o agente de IA apropriado.
Os agentes podem extrair dados estruturados, atualizar o sistema de informação e gerar respostas.
É necessário o consentimento explícito do usuário antes de ativar o processamento de IA.

Casos de uso típicos:

Automação de e-mail
Declarações de incidentes
Solicitações de clientes ou parceiros
Automação de processos administrativos

⚙️ Princípios de Configuração de Canal

Cada canal possui:
Um estado (ativado / desativado)
Uma descrição para fins de documentação e clareza.
Um modo de rascunho para configurar com segurança antes de entrar em funcionamento.

Os canais podem ser adicionados independentemente e ativados progressivamente.
A mesma lógica de agente pode ser reutilizada em vários canais.

✅ Melhores Práticas

Ambientes separados (Desenvolvimento / Teste / Produção) devem ter seus próprios canais.
Dê preferência à autenticação nativa da plataforma (Teams, Google Chat, Mail).
Para canais abertos como o WhatsApp, implemente a autenticação dentro da conversa com IA.
Mantenha a configuração do canal minimalista; a complexidade deve residir nos Guias de IA e na lógica do Agente, não no próprio canal.

Voltar ao topo

🔁 Transportes no Espaço de Trabalho

Os transportes definem como os dados e documentos são exportados do Teemant para sistemas externos.

Eles são a ponte técnica entre o Teemant e seus sistemas de informação, data lakes, ERPs, CRMs ou ferramentas operacionais.

Normalmente, as tarefas utilizam um meio de transporte para determinar quando, como e onde os dados são enviados.

📦 Para que servem os transportes?

Os meios de transporte permitem que você:

Exportar dados estruturados (JSON, metadados, modelos de objetos)
Exportar documentos (PDFs, imagens, arquivos ZIP)
Sincronizar bases de dados de referência com sistemas externos
Envie dados automaticamente ou de acordo com uma programação.

Eles são mais comumente usados para:

Integrações de sistemas
Sincronização de dados
Relatórios e arquivamento
Automação operacional

📁 Transferência de Arquivos (SFTP / FTP) 📤

Os protocolos de transferência de arquivos são usados para enviar arquivos para servidores externos, geralmente servidores de back-end corporativos.

Características principais:

Suporta SFTP / FTP
Os dados podem ser exportados como:
JSON
Documentos
Arquivos ZIP (recomendados para exportações em lote)
Autenticação segura por meio de conta e senha.
Caminho de destino configurável

Casos de uso típicos:

Exporte conjuntos de dados diários ou horários para um sistema ERP.
Sincronizar bancos de dados de referência
Enviar dados estruturados para sistemas legados
Linhas de processamento em lote

Exemplo:

Exporte todos os documentos processados e metadados como um arquivo ZIP para um servidor SFTP todas as noites.

✉️ Transporte de e-mail

O recurso de transporte por e-mail permite que a Teemant envie dados ou documentos por e-mail.

Características principais:

Configuração SMTP (host, porta, criptografia)
Autenticação por meio de conta de e-mail
Suporta anexos
Pode ser usado para notificações ou entrega de dados.

Casos de uso típicos:

Enviar relatórios ou exportações para usuários corporativos
Notificar as equipes quando os dados forem atualizados.
Integrações leves sem sistema de backend

🌐 Webhooks 🔔

Os webhooks permitem o envio de notificações push em tempo real para sistemas externos.

Características principais:

Pontos de extremidade HTTP(S)
Entrega orientada a eventos
Cargas úteis enviadas em JSON
Autenticação segura (cabeçalhos, tokens)

Casos de uso típicos:

Acionar fluxos de trabalho em plataformas externas
Notifique os sistemas subsequentes instantaneamente
Integre com ferramentas de automação (Zapier, Make, APIs personalizadas)

Exemplo:

Ao processar um documento, notifique imediatamente um sistema externo com seus metadados.

🔌 APIs REST 🧩

As APIs REST permitem que sistemas externos obtenham ou recebam dados programaticamente.

Características principais:

Pontos de extremidade REST padrão
Autenticação segura (chaves de API, OAuth, tokens)
Suporta troca de dados estruturados
Projetado para integrações escaláveis

Casos de uso típicos:

Integração de sistemas em tempo real
Aplicações externas que consultam dados do Teemant
Orquestração e automação avançadas

🧠 Como os Transportes Funcionam com Modelos de Objetos e Tarefas

Os meios de transporte não são usados sozinhos:

Os modelos de objetos definem quais dados existem.
Os transportes definem como e para onde os dados são enviados.
As tarefas definem quando e com que frequência os dados são sincronizados.

Juntos, eles formam um pipeline completo de sincronização de dados.

✅ Melhores Práticas

✔ Use SFTP ZIP para exportações de dados em grande escala ou em lote ✔ Use Webhooks para integrações em tempo real ✔ Use APIs REST para sistemas avançados ou interativos ✔ Separe os transportes por ambiente (Desenvolvimento/Teste/Produção) ✔ Sempre teste os transportes antes de publicá-los em produção

🧭 Resumo

Os transportes são a espinha dorsal das integrações do Teemant.

Eles garantem que os dados produzidos dentro do Teemant fluam de forma confiável, segura e automática para o ecossistema da sua empresa.

Eles foram projetados para serem:

Flexível
Escalável
Pronto para uso empresarial

Voltar ao topo

⏱️ Tarefas do Espaço de Trabalho

As tarefas do espaço de trabalho são usadas para configurar operações automatizadas ou sob demanda que são executadas no nível do espaço de trabalho. Elas são normalmente usadas para importar ou exportar dados, sincronizar dados de referência ou executar processos técnicos recorrentes vinculados ao sistema de informação.

🔁 O que é uma tarefa?

Uma tarefa representa uma ação repetível executada pelo Teemant, geralmente baseada em:

um escopo de dados (Entidade, Modelo de Objeto, documentos, etc.)
um meio de transporte (SFTP, e-mail, API, webhook, …)
um cronograma ou gatilho

Exemplo mostrado na captura de tela:

Loja de Importados
Entidade: Loja
Transporte: Importação SFTP
Agendador: ATIVADO

Isso significa que a Teemant importará periodicamente dados da loja (estabelecimento comercial) de um sistema externo usando SFTP.

🧩 Casos de uso típicos

As tarefas são comumente usadas para:

📥 Importação de dados
Dados de referência (lojas, produtos, usuários, contratos, etc.)
Dados de configuração ou dados mestres provenientes de sistemas externos
📤 Exportação de dados
Saídas estruturadas (JSON, ZIP, documentos)
Enviar dados coletados ou processados por IA de volta para a SI
🔄 Tarefas de sincronização
Mantenha os modelos de objetos do Teemant alinhados com os bancos de dados externos.
Atualização periódica de dados compartilhados
⚙️ Outras operações programadas
Processamento em lote
Limpeza, consolidação ou futuros trabalhos automatizados

O sistema foi projetado para ser extensível, de modo que outros tipos de tarefas recorrentes ou acionadas por gatilhos possam ser adicionados ao longo do tempo.

🧠 Como as tarefas funcionam com os transportes

As tarefas não movem dados por si só — elas dependem dos Transportes:

Um meio de transporte define como os dados são trocados (SFTP, e-mail, API, webhook, etc.).
Uma tarefa define quando e o que é trocado.

Essa separação permite:

Reutilizar o mesmo transporte em várias tarefas
Alterar horários sem mexer nas configurações de conectividade

▶️ Execução manual vs. execução agendada

As tarefas podem ser:

Agendado (execução regular, dependendo da configuração)
Acionado manualmente (usando a ação Executar)

Isso é especialmente útil para:

Testando importações/exportações
Sincronizações pontuais
Solução de problemas de produção

Melhores práticas

🔧 Configurar tarefas principalmente em espaços de trabalho de desenvolvimento
🧪 Validar o comportamento em ambientes de teste
🚀 Mantenha as tarefas de produção limitadas, estáveis e monitoradas.
📦 Utilize um espaço de trabalho por aplicação cliente para isolar tarefas e fluxos de dados.

Voltar ao topo

🧠 Construtor de Agentes da Teemant — Visão Geral

O Teemant Agents Builder é o ambiente de design principal da plataforma. É onde os agentes de IA são criados, estruturados, orquestrados e publicados.

Um Agente Teemant não é apenas um chatbot.

👉 Trata-se de um processo de IA de nível empresarial, capaz de orientar usuários, aplicar lógica de negócios, interagir com sistemas e produzir resultados estruturados.

🧩 Tipos de agentes: Processos vs. Navegadores

⚙️ Processos (Processos de Negócio)

Os processos são agentes completos e autônomos projetados para:

Coletar informações estruturadas
Guiar os usuários passo a passo
Aplicar regras e cálculos de negócios
Gerar saídas (JSON, documentos, exportações, emails, etc.)

Casos de uso típicos

Declaração de incidente ou reclamação
Relatório de danos
Declaração de responsabilidade

Os processos representam fluxos de negócios de ponta a ponta.

🧭 Navegadores (Outros)

Os navegadores são agentes de orquestração.

Eles não finalizam um processo de negócios, mas estão acostumados a:

Qualifique a situação do usuário.
Autenticar ou identificar usuários
Direcione os usuários para o subprocesso correto.
Dividir fluxos com base em condições ou opções

Casos de uso típicos

verificação da apólice de seguro
Escolhendo o tipo de incidente
Roteamento entre cenários “com terceiros / sem terceiros”

💡 Em uma aplicação completa, os navegadores atuam como blocos de construção que conectam e organizam múltiplos processos.

🧱 Aba Principal — Configuração do Agente

A aba Principal define a identidade e o comportamento de um agente.

📛 Identificação

Nome: identificador técnico (único, estável)
Nome de exibição: nome legível para humanos mostrado nos canais e na interface do usuário.

✅ Boas práticas:

Utilize convenções de nomenclatura rigorosas, incluindo escopo, versão e finalidade.

🌍 Contextos de IA

O contexto global define o ambiente geral:
empresa ou organização
vocabulário e terminologia
regras globais
tom geral

O contexto do agente define a missão específica do agente:
o que o agente deve alcançar
quem são os usuários
tom de comunicação
dados a coletar

👉 Esses contextos influenciam diretamente o comportamento da IA durante conversas e processamento de e-mails.

🚀 Modo de lançamento

FLOW_ONLY O agente é usado apenas dentro de outro processo → não é diretamente visível para os usuários finais.

DIRETO O agente pode ser acessado diretamente de um canal → visível como ponto de entrada para os usuários

💡 Esta configuração determina se o agente é:

um componente interno
ou um ponto de entrada voltado para o usuário

🧬 Aba Fluxo — Orquestração de Processos

A aba Fluxo fornece uma representação visual da lógica do agente.

Cada bloco representa:

outro agente
um navegador
uma etapa de cálculo
um identificador
uma mensagem fim
uma ação de exportação ou e-mail

🔗 Lógica de Fluxo

Etapas sequenciais
Ramificações condicionais
Árvores de decisão complexas

👉 É aqui que a inteligência de negócios e a orquestração são verdadeiramente implementadas.

📡 Publicação e Disponibilidade

📤 Publicar / Cancelar publicação

Publicar: ativa o agente
Despublicar: desativa-o instantaneamente.

Uma vez publicado, o agente torna-se acessível:

através dos canais configurados
de acordo com seu Modo de Inicialização
Respeitar as regras de acesso ao espaço de trabalho

📦 Exportar/Importar (arquivos .tee)

Os agentes podem ser:

exportados como arquivos .tee
importado para outros espaços de trabalho

Isso permite:

modelos e reutilização
controle de versão
padronização entre projetos
implantações mais rápidas

💡 Os arquivos .tee são um recurso fundamental do ecossistema Teemant.

🧠 Melhores Práticas

🏷️ Convenções de nomenclatura rigorosas

Inclua sempre:

escopo funcional
versão
função de agente

Isso é fundamental para:

manutenção
escalabilidade
legibilidade de fluxos complexos

🧩 Arquitetura Modular

Mantenha as agências pequenas e especializadas.
Navegadores de Reutilização
Centralizar a lógica compartilhada

👉 Quanto mais simples for cada agente, mais robusto se torna o sistema como um todo.

🧩 Resumo

O Construtor de Agentes Teemant permite que você:

Projetar processos de negócios complexos baseados em IA
orquestrar jornadas de usuário inteligentes
Conectar IA a sistemas empresariais
implantar em vários canais
Industrializar e replicar casos de uso de IA

👉 É uma plataforma de design de processos de negócios com inteligência artificial, não apenas um criador de chatbots.

Voltar ao topo

📞 Chamadas do Agente Teemant (Processos Reutilizáveis)

🔍 Visão geral

As chamadas de agentes do Teemant são processos invocáveis projetados para serem reutilizados em um ou vários agentes. Elas representam blocos de processos independentes que podem ser invocados a partir de diferentes fluxos, em vez de serem duplicados.

Considere-os como uma lógica de negócios compartilhada que pode ser chamada sempre que necessário.

🧩 Por que as ligações de agentes são importantes

As chamadas de agentes são particularmente úteis quando:

🔁 O mesmo processo deve ser executado várias vezes
🧠 A lógica é complexa e deve residir em um único lugar.
🧱 Você quer arquiteturas de agentes limpas e fáceis de manter
🔄 Vários agentes ou fluxos dependem da mesma regra de negócio

Exemplos típicos:

Etapas de autenticação ou identificação
verificação da apólice de seguro
lógica de qualificação de danos
Verificações de elegibilidade
Circunstâncias (amigável vs. responsável, etc.)

🏗️ Como funcionam as ligações de agentes

Uma chamada de agente é:

Um processo, não um agente conversacional completo.
Não exposto diretamente aos usuários
Acionado por outro agente ou fluxo
Executado com o contexto atual

📌 Ele se comporta como uma chamada de função dentro de um fluxo de trabalho conversacional maior.

🧠 Modelo de Execução

Um agente principal chega a um ponto em que a lógica compartilhada se faz necessária.
Isso chama uma chamada de agente.
A ligação do agente:
Utiliza o contexto atual
Executa seu processo interno
O controle é devolvido ao agente que fez a chamada.

➡️ Sem interrupções para o usuário, sem lógica duplicada.

🧭 Casos de uso típicos

Caso de uso: Por que usar uma chamada de agente? 🔐 Autenticação: Mesma verificação usada em vários fluxos. 🧾 Consulta de política: Compartilhada entre vários tipos de sinistros. 🚗 Circunstâncias: Lógica amigável versus lógica de terceiros. 📄 Validação de documentos: Regras de validação reutilizáveis. 🔁 Verificações em várias etapas: Lógica de decisão centralizada.

🧱 Melhores Práticas em Arquitetura

✅ Uma chamada de agente = Uma responsabilidade

Mantenha o foco nas ligações dos agentes.
Evite misturar navegação da interface do usuário com a lógica principal.
Dê-lhes nomes muito explícitos.

📌 Exemplo de convenção de nomenclatura:

FLOT6x-AMIABLE-CALL
FLOT6x-CIRCUNSTÂNCIA-CHAMADA
IDENTIFICADOR DE POLÍTICA FLOT1.0

A clareza na nomenclatura é fundamental quando os fluxos de dados se tornam grandes.

🔄 Relacionamento com Agentes da Teemant

ComponentRole🤖 AgenteTeemantAgente voltado para o usuário ou de orquestração🧭 NavegadorGuia os usuários para subprocessos📞 Chamada de AgenteProcesso invocável reutilizável

➡️ Os navegadores decidem para onde ir ➡️ As chamadas do agente executam a lógica compartilhada

🚀 Implantação e disponibilidade

As chamadas do agente são:
📦 Publicado como agentes regulares
🔌 Disponível para qualquer agente no espaço de trabalho
Uma vez publicados, eles podem ser reutilizados imediatamente.
As atualizações são aplicadas automaticamente em todos os locais onde são utilizadas.

🧠 Principais conclusões

📞 Chamadas de agentes = Blocos de processo reutilizáveis
🔁 Evite duplicação, melhore a consistência
🧩 Essencial para sistemas de agentes complexos e de grande escala
🏗️ Um pilar da arquitetura limpa da Teemant

Voltar ao topo