Agente de Coaching Financeiro de IA

Um coach financeiro multi-agente que analisa o teu orçamento, planeia as tuas poupanças e constrói estratégias de pagamento de dívidas - apresentado como cartões de interface interativa numa aba de relatório separada. Construído com CopilotKit, AG-UI, e o ADK da Google em cima do Next.js.

https://github.com/user-attachments/assets/edd4fa8d-ecc5-4b5d-90ff-27b21af5af94

Conceito Gen UI - componentes renderizados pela ferramenta. Um coach de nível superior direciona cada turno de chat para a ferramenta certa: atualiza o teu perfil financeiro a partir de linguagem natural ("o meu rendimento é $8k"), executa uma única fase (orçamento / poupanças / dívida), ou executa a sequência completa Orçamento→Poupanças→Dívida. Cada chamada de ferramenta transmite uma pílula de estado para o chat enquanto o cartão correspondente se materializa na aba de relatório.

Pré-requisitos

• Node.js 18+
• Python 3.12+
• Chave de API do Google Makersuite (para o agente ADK) (ver https://makersuite.google.com/app/apikey)
• Qualquer um dos seguintes gestores de pacotes:
• npm (padrão)
• pnpm
• yarn
• bun

Começar

1. Instala as dependências (npm, ou pnpm/yarn/bun):

npm install

2. Instala as dependências do Python para o agente ADK:

pip install -r requirements.txt

npm run install:agent

Nota: Isto irá configurar automaticamente um .venv (ambiente virtual) dentro do diretório agent.

Para ativar o ambiente virtual manualmente, podes executar:

source agent/.venv/bin/activate

3. Configura a tua chave de API do Google:

Para utilizar a API do Google, precisas de uma chave de API. Segue os passos abaixo para a configurar:

1. Acede ao Google Cloud Console.
2. Cria um novo projeto ou seleciona um projeto existente.
3. No menu de navegação, vai a "APIs e serviços" > "Biblioteca".
4. Procura a API que precisas e ativa-a.
5. Depois de ativar a API, vai a "APIs e serviços" > "Credenciais".
6. Clica em "Criar credenciais" e seleciona "Chave de API".
7. Copia a chave de API gerada e guarda-a num local seguro.

Agora que tens a tua chave de API, podes utilizá-la nas tuas aplicações.

export GOOGLE_API_KEY="your-google-api-key-here"

4. Inicia o servidor de desenvolvimento:

npm run dev

Este comando irá iniciar tanto os servidores da UI como do agente em simultâneo.

Scripts Disponíveis

Os seguintes scripts também podem ser executados utilizando o teu gestor de pacotes preferido:

• dev - Inicia ambos os servidores da UI e do agente em modo de desenvolvimento
• dev:debug - Inicia os servidores de desenvolvimento com o registo de depuração ativado
• dev:ui - Inicia apenas o servidor da UI do Next.js
• dev:agent - Inicia apenas o servidor do agente ADK
• build - Compila a aplicação Next.js para produção
• start - Inicia o servidor de produção
• install:agent - Instala as dependências Python para o agente

Personalização

O componente principal da UI está em src/app/page.tsx. Podes:

• Modificar as cores e o estilo do tema
• Adicionar novas ações no frontend
• Personalizar a aparência da barra lateral do CopilotKit

📚 Documentação

• ADK Documentation - Aprende mais sobre o ADK e as suas funcionalidades
• CopilotKit Documentation - Explora as capacidades do CopilotKit
• Next.js Documentation - Aprende sobre as funcionalidades e API do Next.js