# Agente de Coaching Financeiro de IA

> Um coach financeiro multi-agente que analisa o seu orçamento, planeia as suas poupanças e constrói estratégias de pagamento de dívidas - apresentadas 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 de Next.js.

- Fonte: https://doutorai.pt/apps/ai-financial-coach-agent-generative-ui
- Categoria: Interfaces Generativas
- Dificuldade: Avançado
- 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

# AI Financial Coach Agent

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](https://github.com/CopilotKit/CopilotKit), [AG-UI](https://github.com/ag-ui-protocol/ag-ui), e o [ADK](https://google.github.io/adk-docs/) 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](https://pnpm.io/installation)
  - [yarn](https://classic.yarnpkg.com/lang/en/docs/install/)
  - [bun](https://bun.sh/)

## Começar

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

```bash
npm install
```

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

```bash
pip install -r requirements.txt
```
```

```bash
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:

```bash
> source agent/.venv/bin/activate
> ```

```markdown
# 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](https://console.cloud.google.com/).
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.
```

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

```markdown
4. Inicia o servidor de desenvolvimento:
```

```bash
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](https://google.github.io/adk-docs/) - Aprende mais sobre o ADK e as suas funcionalidades
- [CopilotKit Documentation](https://docs.copilotkit.ai) - Explora as capacidades do CopilotKit
- [Next.js Documentation](https://nextjs.org/docs) - Aprende sobre as funcionalidades e API do Next.js

## 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/ai-financial-coach-agent-generative-ui