# Equipa de Agentes ao Vivo para Reivindicações de Seguro

> Uma aplicação de entrada de reivindicações de seguro orientada por voz que permite ao reclamante falar naturalmente enquanto o agente constrói um pacote de reivindicação estruturado em tempo real. A interface do utilizador mostra a conversa ao vivo, os factos da reivindicação extraídos, orientações para o operador, itens em falta e uma transferência pronta para o ajustador.

- Fonte: https://doutorai.pt/apps/insurance-claim-live-agent-team
- Categoria: Agentes de Voz
- Dificuldade: Médio
- Modelos: Gemini
- Frameworks: Google ADK
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: GOOGLE_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# Equipa de Agentes ao Vivo para Reivindicações de Seguro

Uma aplicação de registo de reivindicações de seguro com foco na voz que permite ao reclamante falar de forma natural enquanto o agente constrói um pacote de reivindicação estruturado em tempo real. A interface do utilizador mostra a conversa ao vivo, os factos extraídos da reivindicação, a orientação do operador, os itens em falta e a transferência pronta para o ajustador.

Isto é concebido como um fluxo de trabalho realista para a primeira notificação de perda (FNOL): o reclamante não precisa de preencher um formulário rígido, e o operador não precisa de traduzir manualmente uma conversa confusa em campos de reivindicação.

![Arquitetura da Equipa de Agentes ao Vivo para Reivindicações de Seguro](/assets/apps-img/97d2aa9ff6241d3a.png)

## Funcionalidades

### Registo de Reivindicações por Voz + Texto

- Conversa nativa por voz com o agente de registo de reivindicações
- Transcrição em tempo real para turnos do reclamante e do agente
- Alternativa de entrada de texto para detalhes da reivindicação digitados
- Respostas de áudio ao vivo do agente

### Pacote de Reivindicação em Tempo Real

- Extrai automaticamente o nome do reclamante, método de contacto, número da apólice, tipo de perda, data, localização, descrição, detalhes de segurança, evidências e números de relatório
- Atualiza o estado da reivindicação à medida que a conversa avança
- Destaca informações em falta ou incertas
- Constrói um pacote de transferência para o ajustador enquanto a chamada ainda está a decorrer

### Orientação do Operador

- Mostra a disposição atual da reivindicação
- Sugere a próxima melhor pergunta ou confirmação
- Lista itens bloqueadores antes da transferência
- Separa o resumo voltado para o operador do registo de auditoria de nível inferior

### Roteamento Específico de Seguro

- Trata de danos por água em casa, colisões automóveis, roubo/perda de propriedade, reivindicações de viagem, exemplos de reembolso médico e reivindicações pouco claras
- Aplica verificações determinísticas de evidências e documentos
- Sinaliza lesões, segurança, habitabilidade, cronologia, SIU e sinais de escalonamento
- Evita prometer cobertura, pagamento ou responsabilidade

## Motor da Aplicação

A aplicação combina voz ao vivo, um gráfico ADK, extração estruturada e regras de seguro determinísticas:

| Camada | Modelo / Motor | Propósito |
| --- | --- | --- |
| Voz ao vivo | `gemini-3.1-flash-live-preview` | Conversa de voz para voz, respostas de áudio e transcrição |
| Gráfico ADK | `root_agent` em `agent.py` | Fonte de verdade para normalização, classificação, validação, roteamento e geração de pacotes de reivindicação |
| Extração estruturada | `gemini-3-flash-preview` | Converte linguagem confusa de reivindicação em factos estruturados de reivindicação dentro do gráfico ADK |
| Regras de negócio | Python FunctionNodes + Pydantic | Verificações determinísticas de campos em falta, portões de evidência, roteamento de segurança, sinais de SIU e saída de pacotes de transferência |
| Backend da Aplicação | FastAPI | Serve o frontend, gere áudio WebSocket e chama `run_claim_workflow()` de `agent.py` após cada turno do reclamante |
| Frontend | HTML, CSS, JavaScript | Cockpit profissional escuro ao vivo para voz, transcrição, estado da reivindicação e transferência |

## Como Funciona

`agent.py` é responsável pelo fluxo de trabalho de reivindicações em produção. Expõe o `root_agent` do ADK e um helper `run_claim_workflow()` que executa o gráfico programaticamente para a aplicação ao vivo.

`server.py` é responsável pelo transporte web ao vivo. Gere a sessão do navegador, o stream de áudio Gemini Live, transcrições e rotas FastAPI. Não duplica a lógica de extração, classificação, evidência, roteamento ou pacotes.

O fluxo da aplicação ao vivo é:

```text
Claimant speaks or types
        |
        v
server.py captures the turn
        |
        v
run_claim_workflow() executes root_agent
        |
        v
ADK graph runs LLM nodes + deterministic FunctionNodes
        |
        v
server.py renders the returned claim state in the UI
```

## Estrutura do Projeto

```text
insurance_claim_live_agent_team/
|-- agent.py
|-- schemas.py
|-- policies.py
|-- examples.py
|-- requirements.txt
|-- .env.example
|-- assets/
|   `-- insurance-claim-live-agent-team-architecture.png
|-- live_demo/
|   |-- index.html
|   |-- styles.css
|   |-- app.js
|   `-- server.py
`-- README.md
```

## Como Começar

A partir do diretório da aplicação:

```bash
cd voice_ai_agents/insurance_claim_live_agent_team
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
```

```markdown
Edita o ficheiro `.env` e define a tua chave de API do Google:
```

```bash
GOOGLE_GENAI_USE_VERTEXAI=False
GOOGLE_API_KEY=your-google-api-key
```

## Executar a Aplicação

Inicia o servidor backend e o servidor frontend:

```bash
python -m uvicorn live_demo.server:app --reload --host 127.0.0.1 --port 4177
```

```markdown
# Abrir a aplicação:

Para abrir a aplicação, segue os seguintes passos:

1. Certifica-te de que a aplicação está instalada no teu dispositivo.
2. Localiza o ícone da aplicação na tua área de trabalho ou no menu de aplicações.
3. Clica duas vezes no ícone para iniciar a aplicação.

# Configuração inicial:

Após abrir a aplicação pela primeira vez, ser-te-á pedido que completes a configuração inicial:

- **Criar uma conta**: Se ainda não tens uma conta, segue as instruções para criar uma.
- **Iniciar sessão**: Se já tens uma conta, insere as tuas credenciais para iniciar sessão.

# Navegação na aplicação:

Uma vez dentro da aplicação, poderás navegar pelas diferentes secções:

- **Dashboard**: Aqui encontrarás uma visão geral das tuas atividades.
- **Definições**: Acede às definições para personalizar a tua experiência.
- **Ajuda**: Consulta a secção de ajuda para obter suporte adicional.

# Comandos úteis:

Aqui estão alguns comandos que poderás achar úteis:

- `comando1`: Descrição do comando 1.
- `comando2`: Descrição do comando 2.
- `comando3`: Descrição do comando 3.

# Resolução de problemas:

Se encontrares problemas ao usar a aplicação, tenta as seguintes soluções:

- Reinicia a aplicação.
- Verifica a tua ligação à internet.
- Consulta a secção de ajuda para mais informações.

# Contacto:

Se precisares de assistência adicional, não hesites em contactar o suporte através do seguinte endereço: [suporte@exemplo.com](mailto:suporte@exemplo.com).
```

```text
http://127.0.0.1:4177/index.html
```

```markdown
# Guia de Instalação do Projecto

## Pré-requisitos

Antes de começares, assegura-te de que tens os seguintes pré-requisitos instalados:

- [Node.js](https://nodejs.org/) (versão 14 ou superior)
- [npm](https://www.npmjs.com/) (geralmente incluído com o Node.js)
- [Git](https://git-scm.com/)

## Clonar o Repositório

Primeiro, clona o repositório para a tua máquina local:

```bash
git clone https://github.com/usuario/projeto.git
```

Navega para o diretório do projeto:

```bash
cd projeto
```

## Instalação das Dependências

Instala as dependências necessárias utilizando o npm:

```bash
npm install
```

## Executar o Projecto

Para iniciar o servidor de desenvolvimento, utiliza o seguinte comando:

```bash
npm start
```

O projecto estará disponível em `http://localhost:3000`.

## Estrutura do Projecto

A estrutura do projecto é a seguinte:

```
projeto/
├── src/
│   ├── components/
│   ├── pages/
│   └── App.js
├── public/
│   └── index.html
├── package.json
└── README.md
```

## Contribuição

Se desejas contribuir para este projecto, segue os seguintes passos:

1. Cria um fork do repositório.
2. Cria uma nova branch para a tua funcionalidade ou correção de bug:
   ```bash
   git checkout -b minha-funcionalidade
   ```
3. Faz as tuas alterações e commit:
   ```bash
   git commit -m "Adiciona nova funcionalidade"
   ```
4. Faz push da tua branch:
   ```bash
   git push origin minha-funcionalidade
   ```
5. Cria um Pull Request.

## Licença

Este projecto está licenciado sob a Licença MIT. Consulta o ficheiro [LICENSE](LICENSE) para mais informações.
```

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/insurance-claim-live-agent-team