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.

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:

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 é:

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

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:

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

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

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

Executar a Aplicação

Inicia o servidor backend e o servidor frontend:

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

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).

http://127.0.0.1:4177/index.html

Guia de Instalação do Projecto

Pré-requisitos

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

• Node.js (versão 14 ou superior)
• npm (geralmente incluído com o Node.js)
• Git

Clonar o Repositório

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

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

Navega para o diretório do projeto:

cd projeto

Instalação das Dependências

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

npm install

Executar o Projecto

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

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:

git commit -m "Adiciona nova funcionalidade"

4. Faz push da tua branch:

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.