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

# Obter Fluxo do Agente

> Recuperar a configuração do fluxo de conversação de um agente

# Obter Fluxo do Agente

Recupera o modo de conversação atual e a configuração do Fluxo de Conversação do agente. Os agentes podem operar em dois modos: `llm_driven` (padrão — o LLM conduz a conversa livremente, com conhecimento/ações) ou `flow_driven` (um grafo baseado em nós dita o fluxo da conversa).

## Endpoint

```
GET /api/v1/agents/{agent_id}/flow
```

## Parâmetros de caminho

<ParamField path="agent_id" type="string" required>UUID do agente.</ParamField>

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "conversation_mode": "flow_driven",
      "flow_config": {
        "initial_node_id": "node-greet",
        "meta": {
          "name": "Sales Qualification Flow",
          "version": "1.2.0"
        },
        "nodes": [
          {
            "id": "node-greet",
            "type": "say",
            "content": "Hi! Are you the right person to talk about scheduling?",
            "next": "node-qualify"
          },
          {
            "id": "node-qualify",
            "type": "decision",
            "branches": [
              { "match": "yes", "next": "node-book" },
              { "match": "no", "next": "node-transfer" }
            ]
          }
        ],
        "global_functions": [
          { "name": "end_conversation", "description": "Ends the call gracefully" }
        ]
      }
    }
  }
  ```
</ResponseExample>

### Modos de Conversação

* `llm_driven` — o comportamento do agente é regido por conhecimento, voz e ações. `flow_config` é `null`.
* `flow_driven` — um grafo de nós dita cada turno. Use este modo para conversas altamente estruturadas (qualificação, intake, abordagem com script).

## Observações

* O esquema do fluxo é detalhado — veja [Atualizar Fluxo do Agente](/api-reference/endpoints/update-agent-flow) para a referência completa de campos.
* A validação pode ser executada de forma independente com [Validar Fluxo do Agente](/api-reference/endpoints/validate-agent-flow) antes de salvar.