O chat de IA nativo do Hedhog (AiService, POST /ai/chat) conversa diretamente com OpenAI e Google Gemini — esses são os dois únicos provedores que o módulo core suporta hoje.

Status: ✅ Implementado — OpenAI e Gemini funcionam através de /ai/chat.

1. Crie um Perfil de Integração (tipo AI, provedor openai ou gemini) com uma api_key em Settings → Integration Profiles
2. Vá em Settings → Configurations → General, encontre AI Configuration e aponte ai-openai-profile-id e/ou ai-gemini-profile-id para esse perfil
3. Chame POST /ai/chat com { message, provider } (provider tem padrão openai) e confirme que você recebe uma resposta real de volta

1. Crie um Perfil de Integração do tipo AI, provedor openai ou gemini, com uma api_key na sua config
2. Vá em Settings → Configurations → General, encontre a seção AI Configuration e defina o campo correspondente — ai-openai-profile-id (OpenAI Profile) ou ai-gemini-profile-id (Gemini Profile) — para esse perfil
3. O AiService lê qualquer que seja o perfil configurado para o provedor solicitado pelo chamador (data.provider tem padrão openai) e chama a API correspondente diretamente

Se nem ai-openai-profile-id nem ai-gemini-profile-id estiverem definidos, o servidor registra um aviso na inicialização ("No AI profiles configured") mas ainda assim sobe — as chamadas para /ai/chat simplesmente falham até você configurar pelo menos um.

data.model é opcional em POST /ai/chat — se você omiti-lo, o AiService recorre a:

---

Console: platform.openai.com

1. Vá em API keys e crie uma nova chave secreta
2. Opcionalmente, crie um projeto e restrinja a chave a ele, e defina limites de uso em Settings → Limits para que um bug em algum lugar não consuma todo o seu orçamento

---

Console: aistudio.google.com ou console.cloud.google.com

1. No AI Studio, clique em Get API key para o caminho mais rápido, ou no GCP habilite a Generative Language API e crie credenciais se precisar que a chave esteja vinculada a um projeto de faturamento

---

Ambos os provedores cobram por token (entrada + saída) diretamente na sua conta — o Hedhog não adiciona nenhuma margem. Defina um modelo por caso de uso em vez de deixar tudo apontando para a opção mais cara:

• Alta qualidade / tarefas complexas: gpt-4o, gemini-1.5-pro
• Equilibrado / padrão: gpt-4o-mini, gemini-1.5-flash
• Alto volume / tarefas simples: gpt-3.5-turbo, gemini-2.0-flash

---

• Chame /ai/chat com provider: "openai" e confirme que você recebe uma resposta real de volta, não um 400
• Chame novamente com provider: "gemini" e confirme o mesmo

---