muonuo/Super-ai-agent

O que Super-ai-agent faz?

Baseado em Spring Boot 3.5 + Java 21 + Spring AI + Vue 3, implementa funcionalidades principais como consultoria emocional de IA, agente de pensamento profundo, recuperação de base de conhecimento RAG e chamada a múltiplas ferramentas. Suporta cenários práticos como geração de relatórios de relacionamento, integração de serviços de mapas e processamento de documentos PDF. Arquitetura clara, documentação completa, muito adequado como projeto de aprendizado e portfólio em IA, com baixa barreira de aprendizado.

Funcionalidades

• Consultoria emocional: Diálogo especializado para questões emocionais, gerando relatórios de relacionamento.
• Agente de pensamento profundo: Simula processo de raciocínio aprofundado, fornecendo análises e soluções detalhadas.
• Recuperação RAG: Recupera informações relevantes da base de conhecimento para responder perguntas com mais precisão.
• Chamada a múltiplas ferramentas: Integra serviços como mapas, processamento de PDF, etc.
• Geração de relatórios: Gera automaticamente relatórios detalhados de relacionamento com base na conversa.
• Serviços de mapas: Suporte a consulta de localização, planejamento de rotas e outras funções relacionadas.
• Processamento de PDF: Extrai e analisa conteúdo de documentos PDF.

Tecnologias

• Backend: Spring Boot 3.5, Java 21, Spring AI
• Frontend: Vue 3
• Banco de dados: MySQL, Redis (para cache)
• LLM: Suporte a OpenAI, DeepSeek, etc.

Início rápido

Pré-requisitos

• Java 21+
• Node.js 18+
• MySQL 8.0+
• Redis (opcional, recomendado)

Configuração do backend

1. Clone o repositório:

   git clone https://github.com/muonuo/Super-ai-agent.git
   cd Super-ai-agent/backend
   

2. Configure o arquivo application.yml:

   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/super_ai
       username: root
       password: sua_senha
   ai:
     openai:
       api-key: sua_chave_api
   

3. Execute o backend:

   ./mvnw spring-boot:run
   

Configuração do frontend

1. Navegue até a pasta do frontend:

   cd ../frontend
   

2. Instale as dependências:

   npm install
   

3. Configure o arquivo .env:

   VUE_APP_API_BASE_URL=http://localhost:8080
   

4. Execute o frontend:

   npm run dev
   

Uso

1. Acesse http://localhost:5173 no navegador.
2. Faça login ou registre-se.
3. Selecione o modo de conversa desejado (consultoria emocional, pensamento profundo, etc.).
4. Digite sua mensagem e aguarde a resposta.
5. Para gerar um relatório de relacionamento, use o comando /relatorio.

Estrutura do projeto

Super-ai-agent/
├── backend/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/superai/
│   │   │   │   ├── controller/     # Controladores REST
│   │   │   │   ├── service/        # Lógica de negócio
│   │   │   │   ├── agent/          # Implementação do agente de IA
│   │   │   │   └── config/         # Configurações
│   │   │   └── resources/
│   │   │       └── application.yml
│   └── pom.xml
├── frontend/
│   ├── src/
│   │   ├── views/                  # Páginas Vue
│   │   ├── components/             # Componentes reutilizáveis
│   │   └── api/                    # Chamadas à API
│   └── package.json
└── README.md

Contribuição

Contribuições são bem-vindas! Siga o fluxo padrão:

1. Faça um fork do projeto
2. Crie sua branch de funcionalidade (git checkout -b feature/MinhaFuncionalidade)
3. Faça commit das mudanças (git commit -m 'Adiciona MinhaFuncionalidade')
4. Faça push da branch (git push origin feature/MinhaFuncionalidade)
5. Abra um Pull Request

Licença

Este projeto está sob a licença MIT.