> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tigyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows & Agentes

> Como os fluxos de conversa são definidos na Tig.ai

Na Tig.ai, o que você vê como um **agente** no painel é chamado de **workflow** na API. São a mesma coisa — um workflow é a definição subjacente e agente é o nome de produto para essa definição.

<Note>
  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".
</Note>

## O modelo de grafo

Um workflow é um **grafo direcionado** — um conjunto de nós conectados por arestas.

```mermaid theme={null}
graph LR
    A[Start Call] -->|Chamador cumprimenta| B[Qualificar Intenção]
    B -->|Quer suporte| C[Agente de Suporte]
    B -->|Quer vendas| D[Agente de Vendas]
    C -->|Problema resolvido| E[End Call]
    D -->|Demonstração agendada| E
```

**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ó

| Tipo         | O que faz                                                                                                       |
| ------------ | --------------------------------------------------------------------------------------------------------------- |
| `startCall`  | Ponto de entrada para chamadas telefônicas. A primeira coisa que o agente diz quando uma chamada se conecta     |
| `agentNode`  | Uma etapa de conversa com tecnologia de LLM. O bloco de construção principal                                    |
| `globalNode` | Define instruções que se aplicam a todos os nós de agente (por exemplo, tom, idioma, comportamento de fallback) |
| `endCall`    | Encerra a chamada                                                                                               |
| `trigger`    | Ponto de entrada para execuções disparadas por API (não telefônicas)                                            |
| `webhook`    | Dispara uma requisição HTTP quando alcançado — use para atualizações de CRM, notificações etc.                  |
| `qa`         | Executa análise de qualidade automatizada na chamada concluída                                                  |

## Arestas e transições

Uma aresta conecta dois nós e é disparada quando sua condição é satisfeita:

<img src="https://mintcdn.com/callguard/w-VUnJAq_m6hhmzP/images/edge.png?fit=max&auto=format&n=w-VUnJAq_m6hhmzP&q=85&s=4a19f00fa3b88946d39df217f0a56ff2" alt="Configuração de aresta" style={{border: "1px solid #d1d5db", borderRadius: "8px", maxWidth: "100%"}} width="1009" height="1251" data-path="images/edge.png" />

`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 o `workflow_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.

Consulte o [Schema de Definição de Workflow](/pt/developer/workflow-schema) para a referência completa de campos.