Em qualquer lugar em que a API disser
workflow, pense “agente”. Em qualquer lugar em que a API disser workflow_definition, pense “a lógica de conversa dentro do seu agente”.O modelo de grafo
Um workflow é um grafo direcionado — um conjunto de nós conectados por arestas. Nós são as etapas da conversa. Cada nó tem um prompt que diz ao LLM o que dizer e fazer naquele ponto. Arestas são as transições entre nós. Cada aresta tem uma condição — uma descrição em linguagem natural de quando avançar. O LLM avalia se a condição foi atendida com base na conversa até o momento.Tipos de nó
Arestas e transições
Uma aresta conecta dois nós e é disparada quando sua condição é satisfeita:
transition_speech é opcional — se definido, o agente fala essa mensagem antes de avançar para o próximo nó.
Versionamento
Toda vez que você atualiza oworkflow_definition de um workflow, a Tig.ai salva uma nova versão mantendo o histórico. A versão atual é sempre a que roda. As versões antigas são mantidas para auditoria.
Criando workflows
Existem duas maneiras de criar um workflow pela API:- A partir de uma definição — forneça você mesmo o grafo completo de nós/arestas. Ideal para geração programática.
- A partir de um template — descreva o caso de uso em linguagem natural e a Tig.ai gera o grafo inicial usando um LLM. Ideal para começar rapidamente.