Swagger Agent

🎨 Design Moderno

Interface com gradientes, efeitos glass, animações suaves e design responsivo que funciona perfeitamente em desktop, tablet e mobile.

🛠️ Painel de Ferramentas

Visualize todas as APIs disponíveis organizadas por projeto. Clique em qualquer ferramenta para ver exemplos de como usá-la.

💬 Chat Inteligente

Conversa natural com suporte a markdown, emojis e indicadores de digitação. Sessões únicas para cada usuário.

🚀 Chat Inteligente

Interface conversacional que permite interagir com APIs usando linguagem natural. Streaming em tempo real e suporte a markdown.

• Conversação natural com APIs
• Streaming de respostas em tempo real
• Suporte completo a Markdown

💻 Interface Gráfica

Interface web moderna e responsiva com design profissional. Funciona perfeitamente em desktop, tablet e mobile.

• Design responsivo e moderno
• Visualização de ferramentas disponíveis
• Interface intuitiva e amigável
• Suporte completo a dispositivos móveis

🛠️ Ferramentas Dinâmicas

Geração automática de ferramentas a partir de especificações OpenAPI. Cada endpoint se torna uma ferramenta que o LLM pode usar.

• Geração automática de ferramentas
• Suporte completo a OpenAPI 3.0

🤖 Modelos de Linguagem (LLMs)

Large Language Models (LLMs) são sistemas de IA treinados em enormes volumes de texto para compreender e gerar linguagem humana. Funcionam como um "cérebro digital" que leu milhões de livros e conversas.

• GPT-4 (OpenAI) - online
• Ollama - Modelos locais gratuitos
• Claude (Anthropic) - online
• Gemini (Google) - online

🛠️ Ferramentas (Function Calling)

Imagine um LLM como um cérebro muito inteligente que precisa de "mãos" para interagir com o mundo real. Essas "mãos" são as ferramentas (tools) ou function calling.

• OpenAI Function Calling Guide
• Cada endpoint OpenAPI vira uma ferramenta
• LLM decide quando e como usar cada ferramenta

📋 OpenAPI (Swagger)

OpenAPI é um padrão para descrever APIs REST de forma estruturada. É como um "manual de instruções" detalhado da sua API, legível por humanos e máquinas.

• Especificação Oficial OpenAPI
• Swagger Editor Online
• Petstore Demo (usado no projeto)
• Padrão da indústria para documentar APIs

🍃 Spring Boot

Spring Boot é o framework Java mais popular para criar aplicações robustas. Elimina a complexidade de configuração, permitindo focar na lógica de negócio.

• Site Oficial Spring Boot
• Spring Initializr - Gerador de projetos
• Autoconfiguração inteligente
• Servidor web embutido (Tomcat)

🧠 Spring AI

Spring AI é o framework oficial da Spring para integração com modelos de IA. Fornece abstrações simples para trabalhar com LLMs, eliminando a complexidade de integração.

• Site Oficial Spring AI
• Documentação Completa
• Suporte a múltiplos provedores (OpenAI, Ollama, etc.)
• Function calling nativo

🤖 Provedores de IA

Suporte nativo para múltiplos provedores de IA, desde soluções em nuvem até modelos locais. Flexibilidade total para escolher o que melhor se adapta ao seu caso de uso.

• OpenAI: GPT-4, GPT-3.5-turbo (nuvem)
• Ollama: Llama, Mistral, Qwen (local)
• Anthropic: Claude (nuvem)
• Google: Gemini (nuvem)

Opção 1: Usar OpenAI (Padrão)

Ideal para começar rapidamente. Requer uma chave de API e conexão com a internet.

# Método 1: Via Variáveis de Ambiente
export OPENAI_API_KEY="sua_chave_openai_aqui"
export AI_PROVIDER=openai # Opcional (padrão)

# Método 2: Via application.yml
app:
  ai:
    provider: openai
spring:
  ai:
    openai:
      api-key: "sua_chave_openai_aqui"

# Após configurar, execute:
./mvnw spring-boot:run

Opção 2: Usar Modelo Local (Ollama)

Perfeito para uso offline, maior privacidade e experimentação com modelos abertos.

# 1. Inicie o Ollama (se ainda não estiver rodando)
docker run -d --name ollama -p 11434:11434 ollama/ollama:latest
docker exec -it ollama ollama pull qwen2.5:0.5b

# 2. Configure a aplicação
export AI_PROVIDER=ollama
export SPRING_AI_OLLAMA_CHAT_OPTIONS_MODEL="qwen2.5:0.5b"

# 3. Execute a aplicação
./mvnw spring-boot:run

💬 Chat Síncrono

POST /api/chat
Content-Type: application/json

{
  "message": "Quais pets estão disponíveis?",
  "sessionId": "sessao-123"
}

Endpoint principal para conversas síncronas. Retorna resposta completa após processamento.

🛠️ Listar Ferramentas

GET /api/tools

# Retorna todas as ferramentas dinâmicas
# geradas a partir das especificações OpenAPI

Lista todas as ferramentas disponíveis com suas descrições e parâmetros.

🌊 Chat Streaming

POST /api/chat/stream
Content-Type: application/json
Accept: text/event-stream

{
  "message": "Explique como funciona o Spring AI",
  "sessionId": "sessao-456"
}

Endpoint para respostas em streaming (Server-Sent Events). Ideal para interfaces em tempo real.

💬 ChatClient API

Utilizamos a API fluente do Spring AI para comunicação com modelos de IA, similar ao WebClient. Suporte a OpenAI, Ollama e outros provedores com troca fácil de componentes.

🛠️ Function Calling

Implementamos o sistema de Tools/Function Calling do Spring AI, permitindo que o modelo execute ferramentas dinâmicas geradas a partir de especificações OpenAPI.

🧠 Memória de Conversa

Aproveitamos o sistema de Chat Conversation Memory do Spring AI para manter contexto entre mensagens e sessões únicas para cada usuário.