ai

O submódulo AI fornece um gateway unificado para interagir com large language models de múltiplos provedores. Em vez de acoplar sua aplicação a um único fornecedor de IA, o HedHog abstrai as APIs específicas de cada provedor por trás de uma interface comum, tornando simples alternar entre os modelos GPT da OpenAI e o Google Gemini sem alterar o código da aplicação. Provedores e modelos são resolvidos a partir de Integration Profiles ou de variáveis de ambiente, com as sobrescritas em nível de agente tendo precedência sobre os padrões globais.

O submódulo oferece dois modos de interação. O chat direto envia uma mensagem única ao provedor padrão e retorna uma única resposta. Os AI Agents são entidades nomeadas e configuradas de forma persistente, armazenadas no banco de dados — cada agente carrega seu próprio provedor, modelo, system prompt (instruções) e identificador slug. Isso permite que equipes de produto definam assistentes com propósitos específicos — um agente de análise de dados, um bot de suporte ao cliente, um pipeline de geração de conteúdo — que permanecem consistentes entre implantações sem embutir configuração no código do cliente.

Tanto o endpoint de chat direto quanto o de chat com agente aceitam um parâmetro opcional file_id. Quando fornecido, a API recupera o arquivo do submódulo File e inclui seu conteúdo como contexto na requisição ao LLM, viabilizando fluxos de sumarização de documentos, revisão de código e extração de conteúdo sem construir um pipeline de ingestão separado.

Todas as operações de IA também são expostas como ferramentas MCP (core.ai.*), o que significa que qualquer assistente de IA compatível com MCP — Claude Desktop, Cursor, um agente personalizado — pode gerenciar agentes e enviar mensagens pela mesma superfície controlada por permissões usada pelos chamadores HTTP.