Voltar
Ageniqx Ageniqx Guia do produto
EN ES PT
Guia do produto

Tudo que você precisa para construir com o Ageniqx.

Uma referência completa para criar agentes de IA, automatizar fluxos de trabalho, implantar em múltiplos canais e escalar seu negócio — sem escrever uma única linha de código.

Introdução

O Ageniqx é uma plataforma de agentes de IA que permite criar, implantar e gerenciar automações inteligentes no seu negócio — sem necessidade de programação. Você projeta agentes usando um canvas visual, os conecta às suas ferramentas existentes e os ativa em canais como WhatsApp, e-mail e chat na web.

Os agentes podem responder perguntas de clientes, rotear solicitações, enviar e-mails, atualizar registros de CRM, analisar documentos e muito mais — funcionando 24 horas por dia sem intervenção manual.

O que torna o Ageniqx diferente? Ao contrário dos chatbots baseados em regras, os agentes do Ageniqx entendem linguagem natural, raciocinam em fluxos de trabalho de múltiplas etapas e podem usar ferramentas externas — alimentados pelos modelos mais recentes da OpenAI, Anthropic e Google.

Conceitos principais

ConceitoO que é
AgenteUm trabalhador de IA com um papel definido, instruções e acesso a ferramentas. Vive dentro de um Workspace.
App AgênticoUm fluxo de trabalho de múltiplas etapas que orquestra um ou mais agentes, gatilhos e ações em um canvas visual.
WorkspaceO ambiente compartilhado da sua organização — contém agentes, apps, integrações e membros da equipe.
CanalA superfície onde seu agente interage com os usuários: WhatsApp, E-mail, Chat Web ou API.
FerramentaUma capacidade que o agente pode invocar — ex.: Enviar E-mail, Pesquisar na Web, Atualizar CRM, Gerar PDF.
ExecuçãoUma única execução de um agente ou app agêntico, disparada por um evento, agendamento ou mensagem do usuário.

Primeiros passos

Começar com o Ageniqx leva menos de cinco minutos. Veja o caminho do zero até seu primeiro agente ativo:

1. Crie sua conta

Acesse app.ageniqx.com/register e cadastre-se com seu e-mail. Após a verificação do e-mail, você será solicitado a criar seu primeiro Workspace.

2. Configure seu Workspace

Um Workspace é o contêiner da sua organização. Dê um nome a ele (ex.: "Bella Vita Spa"), escolha seu idioma principal e, opcionalmente, preencha seu Perfil da empresa — isso dá aos seus agentes contexto sobre sua empresa, serviços e tom de voz.

Painel do Ageniqx mostrando a lista de agentes e o resumo do workspace

O painel do Ageniqx — sua base de operações para gerenciar agentes, apps e configurações do workspace.

3. Conecte um provedor de IA

Acesse Configurações → Ambiente e adicione pelo menos uma chave de API de provedor de IA. O Ageniqx suporta OpenAI, Anthropic e Google Gemini. Você precisa de apenas um para começar — recomendamos o GPT-4o Mini para a maioria dos casos de uso (rápido, acessível e preciso).

4. Crie seu primeiro agente

Clique em Novo agente no painel. Você pode começar do zero ou escolher na Galeria de templates — agentes pré-construídos para cenários comuns como suporte ao cliente, assistente de vendas, agendamento de compromissos e mais.

Dica: Se não souber por onde começar, a galeria de templates filtra por setor (Varejo, Saúde, Imóveis, etc.) e caso de uso. A maioria dos templates está pronta para produção com algumas pequenas personalizações.

Assistente de configuração

Na primeira vez que você faz login, o Ageniqx te guia por um assistente de 5 etapas. Leva cerca de 3 minutos e ao final você terá um agente funcionando pronto para testar. Você pode executá-lo novamente a qualquer momento em Configurações → Geral.

Etapa 1 — Boas-vindas

Uma visão geral rápida do que você vai configurar: dados da empresa, provedor de IA e seu primeiro template de agente. Clique em Criar meu primeiro agente para começar.

Etapa 1 do assistente — Boas-vindas ao Ageniqx

Tela de boas-vindas do assistente de configuração com uma visão geral de 4 etapas.

Etapa 2 — Sua empresa

Conte ao Ageniqx sobre sua empresa. Esse contexto é usado para preencher automaticamente seu Perfil da empresa e ajustar as respostas do agente.

  • Nome da empresa — o nome público da sua organização.
  • Setor — escolha o mais próximo (Restaurante, Varejo, Saúde, Imóveis, Consultoria, Educação, Hospitalidade, Beleza / Bem-estar ou Outro).
  • Descrição breve — o que você faz e quem você atende (opcional mas recomendado).
  • País e cidade — usado pelos agentes para respostas localizadas (opcional).
Etapa 2 do assistente — Dados da empresa

Formulário de dados da empresa — nome, setor, descrição, localização.

Etapa 3 — Provedor de IA

O AgeniqxAI está selecionado por padrão e não requer chave de API — está incluído em todos os planos. Se você tiver suas próprias chaves de API, escolha entre OpenAI, Azure OpenAI, Anthropic, Google Gemini, DeepSeek, Perplexity ou xAI (Grok). Você sempre pode adicionar ou alterar provedores posteriormente em Configurações → Ambiente.

Etapa 3 do assistente — Seleção do provedor de IA

Etapa do provedor de IA mostrando o AgeniqxAI pré-selecionado com todos os provedores suportados.

Etapa 4 — Agente inicial

Escolha um template pré-construído para começar seu primeiro agente. O assistente recomenda templates com base no seu setor. Três opções são exibidas:

  • Agente FAQ de clientes — responde perguntas sobre horários, preços e políticas.
  • Agente de qualificação de leads — captura detalhes de prospects e agenda acompanhamentos.
  • Coletor de feedback — coleta avaliações e reclamações pós-serviço.

Você também pode pular essa etapa e começar do zero no Construtor de agentes.

Etapa 4 do assistente — Seletor de template de agente inicial

Seletor de templates com recomendações por setor. O Agente FAQ de clientes está pré-selecionado.

Etapa 5 — Tudo pronto

Um resumo de tudo que foi configurado: nome da empresa, provedor de IA e o agente inicial criado como rascunho. Daqui você pode ir diretamente ao Construtor de agentes para personalizar, ver todos os seus agentes ou acessar o Launchpad.

Etapa 5 do assistente — Configuração concluída

A tela «Está tudo pronto!» mostrando a empresa configurada, o provedor e o agente inicial.

Dica: O agente inicial é criado como rascunho — não ficará acessível aos clientes até que você o publique. Reserve um momento para abri-lo no Construtor, revisar o prompt do sistema e clicar em Publicar.

Gestão do Workspace

Um Workspace é o contêiner compartilhado dos agentes, apps, integrações e membros da sua organização. Tudo que você constrói vive dentro de um workspace e todo o faturamento é rastreado no nível do workspace.

Configurações do workspace do Ageniqx mostrando a aba Membros com o gerenciamento da equipe

Configurações do Workspace — gerencie membros da equipe, convites, chaves de API, canais e provedores de IA em um só lugar.

Abas de configuração

AbaO que você pode fazer
GeralRenomear o workspace, alterar o ícone, excluir o workspace.
MembrosVer todos os membros, alterar funções (Proprietário / Editor), remover membros.
ConvitesEnviar convites por e-mail e gerenciar convites pendentes.
Provedores LLMConectar chaves de API da OpenAI, Anthropic ou Google. Cada workspace pode ter até 2 provedores adicionais além do modelo AgeniqxAI integrado.
Padrões da plataformaDefinir o modelo de IA e o idioma padrão para todos os novos agentes neste workspace.
Chaves de APIGerar e revogar chaves de API para acesso programático.
WebhooksRegistrar webhooks de saída para notificar seus sistemas sobre eventos do agente.
CanaisConectar canais de comunicação (WhatsApp, E-mail, Chat Widget, etc.) e atribuí-los a agentes.

Funções

Há duas funções de membro no Ageniqx:

  • Proprietário — acesso total: criar agentes, gerenciar faturamento, convidar/remover membros, alterar configurações. Cada workspace deve ter pelo menos um Proprietário.
  • Editor — pode construir e publicar agentes e apps, mas não pode alterar o faturamento, convidar membros ou modificar chaves de API.
Dica: Quando você convida um colega, ele recebe um e-mail com um link para entrar. Os convites expiram após 7 dias. Você pode reenvá-los na aba Convites.

Perfil da empresa

O Perfil da empresa é o contexto compartilhado da sua empresa — uma base de conhecimento estruturada que todos os seus agentes recebem automaticamente em tempo de execução. Em vez de copiar e colar as informações da sua empresa no prompt de cada agente, você as define uma vez aqui e elas se propagam por toda parte.

Página de Perfil da empresa do Ageniqx mostrando o editor de contexto com abas de Geral, Serviços, Horários, Marca e FAQs

Perfil da empresa — a fonte única de verdade injetada no contexto de cada agente em tempo de execução.

Seções do perfil

AbaO que preencher
GeralNome da empresa, slogan, descrição, logo, informações de contato (telefone, e-mail, site) e redes sociais.
Serviços e preçosSeus produtos ou serviços com nomes, descrições, preços e durações.
Horários e localizaçãoHorário de funcionamento para cada dia da semana, endereço físico e link para mapa.
Marca e públicoTom de voz (formal, casual, amigável), público-alvo e diretrizes de personalidade da marca.
FAQs e políticasPerguntas frequentes, política de cancelamento, política de devolução e outras políticas que seus agentes devem conhecer.

Prévia do contexto do agente

No lado direito da página de Perfil da empresa você encontrará a Prévia do contexto do agente — ela mostra o texto exato que é injetado no prompt do sistema de cada agente. Ela é atualizada em tempo real enquanto você preenche o formulário, para que você possa ver precisamente quais informações seus agentes terão acesso.

Melhorar com IA: O campo de descrição tem um botão «Melhorar com IA» que reescreve seu texto em um formato profissional e amigável para agentes — economizando tempo na engenharia de prompts. Requer pelo menos um provedor LLM conectado.

Seu primeiro agente

Ao criar um agente você define quatro coisas: sua identidade, suas instruções, seu modelo de IA e suas ferramentas.

Identidade do agente

Dê ao seu agente um nome (visível para os usuários finais), um avatar opcional e uma descrição. Por exemplo: Nome: Amaya — Descrição: Agente de suporte ao cliente para o Bella Vita Spa.

Instruções do sistema

Esta é a diretiva principal do agente — escrita em linguagem simples. Boas instruções são específicas e dizem ao agente exatamente o que pode e o que não pode fazer.

Exemplo de prompt do sistema

Você é Amaya, a assistente virtual do Bella Vita Spa. Seu papel é responder perguntas sobre serviços, preços e disponibilidade. Seja sempre calorosa e profissional. Se perguntada sobre conselhos médicos, recuse educadamente e encaminhe para um médico. Nunca revele preços internos além do que está listado na sua base de conhecimento.
Construtor de agentes do Ageniqx mostrando o editor de prompt do sistema e o seletor de modelo

O construtor de agentes — configure identidade, instruções, modelo de IA e ferramentas em um só lugar.

Escolha um modelo de IA

Cada agente usa um modelo de IA. Você pode alterá-lo a qualquer momento. Veja a seção Provedores de IA para uma comparação completa.

Atribua ferramentas

As ferramentas permitem que seu agente realize ações além de simplesmente responder com texto — como verificar disponibilidade, enviar um e-mail de confirmação ou atualizar um registro de CRM. Você pode adicionar ferramentas no construtor de agentes ou criar as suas próprias na seção Ferramentas.

Teste antes de publicar

Use a prévia de chat integrada (barra lateral direita do construtor) para testar seu agente antes de ativá-lo em um canal. A prévia mostra o histórico completo de mensagens e permite iterar rapidamente no seu prompt do sistema.

Canvas do agente

Cada agente tem dois modos de edição acessíveis na parte superior do construtor: Formulário (campos estruturados) e Canvas (grafo visual de nós). O Canvas é a visão no nível do agente — mostra como os componentes internos do agente estão conectados, e é diferente do canvas do Construtor de fluxos usado para os Trabalhadores Digitais com múltiplos agentes.

Canvas do agente do Ageniqx mostrando o painel de Blocos de entrada à esquerda e o grafo de nós conectados à direita

O Canvas do agente — visualize e conecte os Blocos de entrada (LLM, Prompt do sistema, Ferramentas, Servidores MCP, Base de conhecimento, Funcionalidades) para um único agente.

Painel esquerdo — Blocos de entrada e Templates

O painel esquerdo tem duas seções:

  • Blocos de entrada — arraste qualquer bloco para o canvas para adicioná-lo ao agente: LLM e Modelo, Prompt do sistema, Ferramentas, Servidores MCP, Base de conhecimento e Funcionalidades.
  • Templates — configurações de agente pré-construídas que você pode soltar no canvas como ponto de partida (ex.: Agendamento de consultas, Bot FAQ, Redator de conteúdo).

Nós do canvas

Cada bloco no canvas é um nó. Todos os nós alimentam o nó central do agente (exibido com o nome do seu agente), que então envia a saída para o nó de Saída do chat. O fluxo é sempre: Blocos de entrada → Agente → Saída.

Clique em qualquer nó para abrir sua configuração no painel direito. Por exemplo, clicar no nó LLM e Modelo permite alterar o modelo de IA, a temperatura e os limites de tokens sem sair do canvas.

Testar agente

O botão azul Testar agente no canto superior direito abre um painel de chat ao vivo diretamente no canvas. As alterações feitas nos nós são aplicadas imediatamente — você pode ajustar um prompt do sistema e testar o efeito sem salvar nem trocar de visualização.

Canvas vs Formulário: A visualização de Formulário é ideal para edições rápidas (nome, instruções, ferramentas). A visualização Canvas é ideal para entender visualmente e reestruturar a arquitetura de um agente — especialmente útil ao trabalhar com múltiplos blocos de entrada ou configurações complexas de ferramentas.

Construtor de fluxos

Os Apps Agênticos permitem encadear múltiplas etapas em fluxos de trabalho automatizados usando um canvas visual de arrastar e soltar. Cada etapa é um — um gatilho, uma ação de agente de IA, uma chamada de ferramenta ou uma ramificação condicional.

Canvas de fluxo de trabalho do Ageniqx mostrando nós conectados em um Pipeline de Lead para Reserva

O canvas de fluxo de trabalho — conecte nós para construir automações de múltiplas etapas visualmente.

Criar um App Agêntico

Na barra lateral, acesse Apps Agênticos → Novo app. Você chegará a um canvas vazio com um nó Gatilho padrão. A partir daí:

  • Clique em + em qualquer nó para adicionar uma etapa conectada.
  • Arraste nós para reorganizar o layout.
  • Clique em qualquer nó para abrir seu painel de configuração à direita.
  • Conecte nós arrastando de uma saída até uma entrada.

Executar um fluxo de trabalho

Os fluxos de trabalho podem ser disparados manualmente (para testes), em um agendamento, por um webhook de entrada, ou quando uma mensagem do usuário chega em um canal conectado. O tipo de gatilho é definido no primeiro nó.

Painel Inspetor: Selecione qualquer nó para ver suas propriedades em tempo real — modelo, temperatura, hora da última execução e status — no painel Inspetor no lado direito do canvas.

Tipos de nó

Cada fluxo de trabalho é composto por nós. Cada tipo de nó tem um papel distinto:

Lista de Trabalhadores Digitais do Ageniqx mostrando pipelines automatizados de múltiplos agentes

Trabalhadores Digitais — pipelines de múltiplas etapas pré-construídas e personalizadas em um relance.

Tipo de nóPropósitoExemplo
GatilhoInicia o fluxo de trabalho. Cada app tem exatamente um gatilho.Nova mensagem do WhatsApp, cron agendado, webhook de entrada
Agente IAExecuta um modelo de IA com instruções. Pode chamar ferramentas durante o raciocínio.«Classifique este ticket de suporte» / «Rascunhe uma resposta»
Enviar E-mailEnvia um e-mail por uma conta do Gmail ou SMTP conectada.E-mail de confirmação após uma reserva
Atualizar CRMCria ou atualiza contatos, negócios ou notas em um CRM conectado.Salvar novo lead de uma conversa no WhatsApp
CondiçãoRamifica o fluxo com base em uma expressão booleana.Rotear clientes VIP de forma diferente
AtrasoPausa a execução por um tempo especificado.Aguardar 24 h e enviar um acompanhamento
NotificaçãoPosta uma mensagem em um canal da equipe (Slack, Teams, etc.).Alertar a equipe de vendas sobre um lead quente
Requisição HTTPChama qualquer API externa via GET, POST, PUT ou DELETE.Buscar estoque em tempo real do seu ERP
DocumentoRecupera contexto da sua base de conhecimento carregada.Buscar a resposta FAQ relevante

Conectar nós

Arraste do conector circular na borda direita de um nó até a borda esquerda do próximo nó. Uma conexão transporta os dados de saída do nó de origem para a entrada do nó de destino. Você pode referenciar saídas de nós anteriores em qualquer campo usando a sintaxe {{node.fieldName}}.

Provedores de IA

O Ageniqx é agnóstico quanto ao modelo. Cada agente pode usar um modelo de IA diferente e você pode trocar de modelo sem alterar nada mais. Para adicionar uma chave de provedor, acesse Configurações → Ambiente → Provedores de IA.

Configurações de provedores de IA mostrando OpenAI, Anthropic e Google Gemini

Configurações do ambiente — conecte suas próprias chaves de API de provedor de IA.

ProvedorModeloMelhor paraVelocidade
AgeniqxAIIntegradoUso geral — sem chave de API, incluído em todos os planosRápido
OpenAIGPT-4oRaciocínio complexo, código, uso de ferramentasRápido
OpenAIGPT-4o MiniTarefas de alto volume e baixo custoMuito rápido
OpenAIo3 / o4-miniRaciocínio profundo, planejamentoMais lento
AnthropicClaude 3.5 SonnetDocumentos longos, instruções detalhadasRápido
AnthropicClaude 3 HaikuRespostas rápidas e econômicas para clientesMuito rápido
GoogleGemini 2.0 FlashTarefas multimodais, janelas de contexto grandesRápido
GoogleGemini 1.5 ProContexto de 1M tokens, análise de documentos longosModerado
Recomendação: Comece com GPT-4o Mini para a maioria dos agentes — é rápido e econômico. Atualize para GPT-4o ou Claude 3.5 Sonnet quando precisar de raciocínio mais robusto ou lidar com instruções complexas de múltiplas etapas.

Temperatura e Máximo de tokens

Temperatura (0–1) controla criatividade vs. consistência. Use 0–0,3 para agentes factuais (suporte, FAQ) e 0,6–0,9 para tarefas criativas (redação, brainstorming). Máximo de tokens limita o comprimento da resposta por mensagem.

Canais

Os canais são as superfícies por meio das quais seus agentes se comunicam com os usuários finais. O Ageniqx suporta quatro tipos de canal — você pode ativar múltiplos canais no mesmo agente.

Painel de configuração de canais mostrando opções de WhatsApp, E-mail e Chat Web

Configuração de canais — conecte WhatsApp, E-mail ou incorpore um widget de chat na web.

CanalConfiguração necessáriaMelhor para
WhatsAppConta Meta Business API + número de telefoneSuporte ao cliente, notificações, qualificação de leads
E-mailOAuth do Gmail ou credenciais SMTPConsultas recebidas, acompanhamentos automatizados
Chat WebCole um script de uma linha no seu siteWidget de chat ao vivo em qualquer site
APIChave API REST do AgeniqxIntegrações personalizadas, apps mobile, ferramentas internas

WhatsApp

Conecte via Meta Cloud API. Você precisará de uma conta Meta Business verificada e um número de telefone dedicado. Em Configurações → Canais → WhatsApp, cole seu ID de número de telefone, ID da conta do WhatsApp Business e token de usuário do sistema. O Ageniqx gerencia automaticamente todo o roteamento de mensagens e a verificação de webhooks.

Widget de Chat Web

O widget do Ageniqx é um snippet JavaScript leve que você cola uma vez no <head> do seu site. Ele renderiza um botão e painel de chat personalizáveis. Você pode controlar a cor de destaque, posição, mensagem de boas-vindas e qual agente lida com as conversas.

Snippet de incorporação

<script
  src="https://ageniqx.app/widget/ageniqx-widget.js"
  data-agent-id="YOUR_AGENT_ID"
  data-workspace-id="YOUR_WORKSPACE_ID"
  defer>
</script>
Dica: O widget funciona em qualquer site baseado em HTML — WordPress, Webflow, Squarespace, Shopify e desenvolvimentos personalizados. Nenhuma alteração no lado do servidor é necessária.

Ferramentas e integrações

As ferramentas ampliam suas capacidades dos agentes com o mundo real. Um agente com acesso às ferramentas certas pode navegar na web, ler e escrever e-mails, atualizar um banco de dados, gerar documentos e muito mais.

Biblioteca de ferramentas do Ageniqx mostrando as integrações disponíveis

A biblioteca de ferramentas — explore, conecte e atribua ferramentas aos seus agentes.

Ferramentas integradas

FerramentaO que faz
Enviar E-mail (Gmail)Envia e-mails de uma conta do Gmail conectada.
Ler E-mailLê mensagens não lidas de uma caixa de entrada conectada.
Pesquisa na WebPesquisa na web e retorna resultados resumidos.
Pesquisa de documentosRealiza busca semântica na sua base de conhecimento carregada.
Calendário — Criar eventoAgenda um evento em um Google Calendar conectado.
Calendário — Verificar disponibilidadeConsulta horários livres/ocupados em um intervalo de datas.
Atualizar CRMCria ou atualiza registros de contato/negócio em um CRM conectado.
Gerar PDFCria um PDF formatado a partir de um template e valores de campos.
Requisição HTTPRealiza chamadas GET/POST/PUT/DELETE arbitrárias para qualquer API REST.
WhatsApp — Enviar mensagemEnvia mensagens proativas do WhatsApp para um contato.

Conectar integrações

A maioria das ferramentas requer autorização de um serviço externo. Acesse Configurações → Integrações e conecte sua conta do Google para as ferramentas do Gmail e Calendário, ou cole chaves de API para CRM e outros serviços. Uma vez conectadas, as ferramentas ficam disponíveis para atribuir a qualquer agente no workspace.

Servidores MCP

O Ageniqx também suporta o Model Context Protocol (MCP) — um ecossistema crescente de servidores de ferramentas construídos pela comunidade cobrindo bancos de dados, APIs, e-mail, calendários e mais. Veja a seção Servidores MCP abaixo para um guia completo.

Templates e biblioteca

O Hub de Templates (barra lateral → Templates) é um catálogo curado de recursos prontos para instalar no seu workspace com um clique. Ele contém três abas:

AbaO que contém
Templates de agentesMais de 30 agentes pré-construídos organizados por caso de uso (Atendimento ao cliente, Vendas, Marketing, Agendamento, Retenção, Operações, Conteúdo, Finanças). Cada card mostra tempo de configuração, avaliações, ferramentas necessárias e um atalho Instalar com um clique.
Biblioteca de promptsPrompts do sistema, personas, instruções, padrões de cadeia de pensamento e blocos de formato de saída curados. Os prompts usam variáveis de template como {{agent_name}} e {{company_name}} que são preenchidas automaticamente na instalação.
Trabalhadores DigitaisTemplates de fluxos de trabalho de múltiplas etapas pré-construídos para automações comuns (Lead para Reserva, Escalada de suporte, etc.). Instale como ponto de partida e conecte aos seus próprios agentes.
Hub de Templates — aba Templates de agentes mostrando 30 templates com categorias e botões de instalação

Aba Templates de agentes — mais de 30 templates filtráveis por categoria. Cada card mostra avaliações, tempo estimado de configuração e ferramentas necessárias.

Hub de Templates — aba Biblioteca de prompts mostrando prompts do sistema com variáveis de template

Biblioteca de prompts — prompts prontos para uso com variáveis. Clique em Usar prompt para inseri-lo no campo de prompt do sistema do seu agente.

Exportar e importar agentes

Qualquer agente que você construiu pode ser exportado como um arquivo JSON e reimportado no mesmo ou em outro workspace. Isso é útil para backups, compartilhar agentes com colegas ou mover um agente testado de um workspace de testes para produção.

  • Exportar: Abra um agente → clique no menu Exportar agente. Um arquivo .json é baixado para o seu computador.
  • Importar: Na lista de agentes → Novo agenteImportar do arquivo. Selecione o JSON exportado e todas as configurações, ferramentas e instruções são restauradas.
Dica: Exporte um agente antes de fazer grandes alterações — é uma maneira rápida de criar um ponto de restauração sem precisar de controle de versão.

Documentos

A Biblioteca de documentos (barra lateral → Documentos) é a base de conhecimento do seu workspace. Faça upload de arquivos e conecte fontes externas para que seus agentes possam consultá-los ao responder perguntas — fornecendo respostas baseadas no conteúdo real do seu negócio.

Página de Biblioteca de documentos com abas de Biblioteca e Fontes externas

Biblioteca de documentos — faça upload de arquivos ou conecte fontes externas. Os formatos suportados aparecem na parte inferior do estado vazio.

Fazer upload de arquivos

Clique em Fazer upload de um documento e selecione um ou mais arquivos. Formatos suportados:

  • PDF, DOCX, DOC — manuais de produto, brochuras de serviços, contratos
  • TXT, MD — FAQs em texto simples, notas de versão, artigos de conhecimento
  • CSV, JSON — dados estruturados como catálogos de produtos ou tabelas de preços

O tamanho máximo do arquivo é de 5 MB por arquivo. Uma vez carregado, o documento é indexado e fica disponível como bloco de Base de conhecimento no Construtor de agentes.

Fontes externas (sincronização com GitHub)

Conecte um repositório do GitHub e o Ageniqx sincronizará automaticamente seus documentos na sua biblioteca. Use isso para manter o conhecimento do seu agente atualizado com os documentos do produto ou wiki interna sem uploads manuais.

Modal de Adicionar fonte externa para conectar um repositório do GitHub

Adicionar fonte externa — conecte um repositório do GitHub público ou privado. Defina uma branch e um filtro de caminho para sincronizar apenas a pasta de documentos relevante.

  • Provedor: GitHub (SharePoint e Box em breve)
  • Branch: padrão main
  • Filtro de caminho: ex.: docs/ para sincronizar apenas documentos nessa pasta
  • Token de acesso pessoal: necessário para repositórios privados

Usar documentos em agentes

No Construtor de agentes (visualização Canvas), adicione um bloco de entrada Base de conhecimento e selecione os documentos ou fontes externas que deseja que o agente consulte. O agente realizará uma busca semântica nesses documentos antes de compor sua resposta.

Dica: Mantenha seus documentos focados e bem estruturados. Um agente com um PDF de 200 páginas fornecerá respostas de menor qualidade do que um com um documento FAQ limpo e bem organizado cobrindo as mesmas informações.

Conversas e registros de execução

Cada interação com seu agente é capturada como uma Conversa. A visualização de Conversas fornece um registro em tempo real de todas as mensagens em todos os canais.

Visualização de conversas do Ageniqx mostrando o histórico de mensagens e detalhes de execução

A visualização de Conversas — inspecione cada mensagem, resposta do agente e chamada de ferramenta em detalhes.

O que é capturado

  • Cada mensagem do usuário e resposta do agente, com carimbos de tempo.
  • Chamadas de ferramentas feitas pelo agente durante a conversa (ex.: «Pesquisou na web por X», «Enviou e-mail para Y»).
  • O modelo de IA usado e o consumo de tokens por mensagem.
  • Latência — quanto tempo o modelo levou para responder.
  • Quaisquer erros ou alternativas que ocorreram.

Registros de execução

Para Apps Agênticos (fluxos de trabalho de múltiplas etapas), cada execução produz um Registro de execução. Você pode inspecionar a entrada, saída, duração e status de cada nó. Isso é inestimável para depurar um fluxo que não está se comportando conforme o esperado.

Dica profissional: Filtre conversas por canal, agente, intervalo de datas ou pesquise pelo conteúdo da mensagem do usuário. Use isso para identificar as perguntas mais comuns e melhorar as instruções do seu agente de acordo.

Análises

O painel de Análises fornece uma visão geral da atividade do seu agente e workspace ao longo do tempo. Use-o para entender padrões de uso, monitorar custos e identificar oportunidades de melhoria.

Painel de análises do Ageniqx mostrando contagens de execução, latência e uso de tokens

Análises — acompanhe execuções, custos, tempos de resposta e atividade por agente.

Métricas principais

MétricaDescrição
ExecuçõesNúmero total de execuções de agente ou fluxo de trabalho no período.
Uso de tokensTokens de entrada e saída consumidos — útil para estimativa de custos.
Latência médiaTempo médio da mensagem do usuário até a resposta do agente.
Conversas ativasConversas com pelo menos uma mensagem no período.
Taxa de erroPercentual de execuções que resultaram em erro.
Principais agentesClassificados por contagem de execuções — mostra quais agentes são mais ativos.

Pergunte ao Ageniqx

O Pergunte ao Ageniqx é seu copiloto de IA integrado — sempre disponível no canto inferior direito do app. Ele entende o contexto completo do seu workspace e pode ajudar a construir, configurar e solucionar problemas sem sair da página em que você está.

Painel do copiloto Ageniqx aberto no lado direito mostrando a mensagem de boas-vindas e o input de chat

Pergunte ao Ageniqx — seu copiloto de IA com contexto do workspace disponível em qualquer página.

O que você pode perguntar

O assistente é sensível ao contexto e com escopo de workspace. Alguns exemplos:

Exemplos de prompts

"Crie um agente de suporte ao cliente para um salão de beleza"
"Adicione um canal do WhatsApp ao meu agente Respondedor de E-mail"
"Por que meu agente Qualificador de Leads falhou na última execução?"
"Atualize meus horários de funcionamento para fechar às 18h aos sábados"
"Como faço para conectar uma ferramenta do Google Agenda?"
"Mostre-me quais agentes tiveram erros nas últimas 24 horas"

Capacidades

CapacidadeO que pode fazer
Criar agentesCria um novo agente com nome, instruções e ferramentas sugeridas com base na sua descrição.
Atualizar Perfil da empresaPreenche ou melhora os campos de contexto da sua empresa a partir de uma descrição em linguagem natural.
Solucionar problemasAnalisa registros de execução recentes e explica o que deu errado e como corrigir.
Responder perguntasExplica qualquer recurso do Ageniqx, guia pelas etapas de configuração ou esclarece conceitos.
Sugerir melhoriasRevisa o prompt do sistema do seu agente e sugere instruções mais claras e eficazes.
Plano Starter e pagos: O plano Starter inclui um número limitado de solicitações ao Pergunte ao Ageniqx por mês. Faça upgrade para um plano pago para limites maiores e tempos de resposta prioritários.

Servidores MCP Avançado

O Model Context Protocol (MCP) é um padrão aberto que permite que agentes de IA chamem ferramentas externas em tempo de execução — bancos de dados, APIs, e-mail, calendários e mais. O Ageniqx inclui um catálogo MCP integrado e permite adicionar servidores personalizados, facilitando a extensão dos seus agentes muito além do conjunto de ferramentas integradas.

Catálogo de servidores MCP mostrando Brave Search, Gmail, Fetch, Memory, Linear, Sentry e mais

Catálogo de servidores MCP — explore e instale servidores por categoria. Os cards mostram se uma chave é necessária ou se o servidor está pronto sem autenticação.

Descobrir e instalar servidores

Acesse Servidores MCP na barra lateral. A aba Descobrir lista todos os servidores disponíveis com filtros de categoria:

CategoriaServidores de exemplo
GeralBrave Search, Fetch (leitor de URLs), Memory / Knowledge Graph
E-commerceMailtrap Email, PDF Export
Tech / SaaSLinear, Sentry
MarketingReddit, ferramentas de análise social
Suporte ao clienteGmail, integrações de chat ao vivo

Clique em + Adicionar ao workspace em qualquer card para instalá-lo. Servidores marcados como Sem autenticação estão prontos imediatamente. Servidores marcados como Requer chave solicitarão uma chave de API após a instalação.

Usar servidores MCP em agentes

Após instalar um servidor, abra um agente na visualização Canvas e adicione um bloco de entrada MCP. Selecione o servidor instalado no menu suspenso — o agente poderá chamar suas ferramentas durante as conversas.

Servidores personalizados

Você também pode conectar qualquer servidor compatível com MCP fornecendo sua URL e configuração em Meus servidores → Adicionar servidor personalizado. Isso é útil para ferramentas internas ou serviços auto-hospedados que expõem um endpoint MCP.

Nota: O MCP é um padrão em evolução. O catálogo cresce regularmente — volte para verificar ou assine o changelog para se manter atualizado sobre novos servidores.

API e Webhooks

Todas as capacidades do Ageniqx são acessíveis via API REST. Use a API para disparar conversas de agentes programaticamente, enviar mensagens do seu próprio aplicativo ou construir integrações personalizadas.

Página de gerenciamento de chaves de API do Ageniqx

Chaves de API — gere e gerencie chaves com permissões limitadas.

Autenticação

Todas as chamadas de API requerem um token Bearer. Gere chaves de API em Configurações → Chaves de API. Cada chave pode ser limitada a permissões específicas (leitura, escrita, execução) e restrita a origens permitidas.

Enviar uma mensagem para um agente

POST https://api.ageniqx.com/v1/conversations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "agentId": "agt_xxxxxxxxxxxx",
  "message": "Olá, gostaria de agendar uma massagem para sábado",
  "channelType": "api",
  "userId": "user_123"
}

Webhooks

Configure webhooks de entrada para disparar Apps Agênticos de sistemas externos. Cada App Agêntico pode expor uma URL de webhook — qualquer HTTP POST para essa URL inicia uma nova execução com o corpo da requisição como dados de entrada.

Segurança: Os endpoints de webhook são autenticados com uma assinatura HMAC. Valide o cabeçalho X-Ageniqx-Signature no seu servidor receptor para garantir que a requisição é genuína.

Planos e faturamento

O Ageniqx oferece planos flexíveis para equipes de todos os tamanhos. Todos os planos incluem os recursos principais da plataforma — a diferença está nos limites de execução, vagas da equipe e suporte premium.

PlanoMelhor paraExecuções / mêsVagas da equipe
StarterConstrutores solo, experimentos pequenos1.5001
ProNegócios em crescimento, automações de alto volume50.00015
EnterpriseNecessidades personalizadas, SLA, suporte dedicadoIlimitadasIlimitadas

Todos os planos são cobrados mensalmente. Você pode fazer upgrade, downgrade ou cancelar a qualquer momento em Configurações → Faturamento. Para preços Enterprise, entre em contato com sales@ageniqx.app.

Nota: Os custos do modelo de IA (tokens de API) são cobrados separadamente pelas suas próprias contas de provedor (OpenAI, Anthropic, Google). O Ageniqx não aplica margem nos custos do modelo — você paga os provedores diretamente.