Primeiros passos

Início rápido: primeiro agente em menos de uma hora

Crie seu workspace, configure um agente, vincule conhecimento e incorpore o widget ou chame a API HTTP — com marcos alinhados a como o FlexyAgents aplica planos e escopos.

início rápido flexyagentsincorporar chatbotprimeiro agente

Esta lista assume que você já tem conta no FlexyAgents e acesso ao painel. Em trial, alguns conectores ou canais podem estar limitados — substitua passos por uploads ou Q&A manual quando uma função não estiver disponível.

Objetivo: um agente que responda a partir de pelo menos uma fonte real, visível em uma página de teste ou via API, para que sua equipe avalie tom e fundamentação antes de ampliar o deploy.

1. Confirme organização e papéis

Convide a equipe com os papéis adequados no painel: quem edita agentes, quem gerencia faturamento e quem deve revisar o conhecimento antes de publicar. Documente qual ambiente (produção vs staging) você usa se mantiver ambos.

Gere ou rotacione chaves API apenas quando for incorporar; guarde os secrets no seu padrão de vault, não em código client-side para integrações somente servidor.

2. Crie um agente a partir de template ou em branco

Escolha um template próximo ao seu caso (suporte, FAQ, interno) e ajuste as instruções do sistema: tom, regras de escalonamento e o que o modelo deve fazer quando a recuperação não retornar nada.

Escolha modelos hospedados ou BYOK por agente. BYOK exige chaves de provedor válidas nas configurações da organização; chaves incorretas ou expiradas aparecem como erros no chat e nos logs.

3. Vincule conhecimento e verifique a recuperação

Faça upload de PDFs ou conecte uma fonte (Notion, Zendesk, Drive, etc.) quando seu plano permitir. Para um teste rápido, um PDF pequeno e algumas linhas Q&A bastam para testar citações.

Se você enviar capturas, diagramas ou gravações, confirme se visão/transcrição Gemini está disponível (hospedada ou com sua chave Gemini em Configurações → Chaves API de LLM). A UI de conhecimento mostra o uso mensal hospedado dessas funções quando aplicável.

Opcional: execute um crawl pequeno de um site de ajuda público primeiro só com texto; ative imagens ou mídia apenas após configurar o Gemini.

Use a pré-visualização ou o chat de teste no painel para perguntas que você sabe que estão no corpus. Se as respostas divagarem, aperte instruções ou melhore os documentos fonte para um chunking melhor.

  • Uma cota em uploads costuma indicar limites hospedados de visão/transcrição — adicione uma chave Gemini ou peça a um admin para aumentar os limites do plano.
  • O OCR pode extrair texto visível de imagens mesmo quando cotas de visão bloqueiam descrições com IA.

4. Implante: widget, help hospedado ou API

Para sites, copie o snippet de embed na seção de deploy do agente e coloque-o primeiro em um domínio de staging. Para produtos, chame POST chat com chave API no servidor e transmita tokens se sua UI precisar de render incremental.

Antes do lançamento, defina o que significa “passar para humano” para sua equipe — criação de ticket, aviso no Slack ou e-mail — e configure automações de acordo.

Construa com seu stack

Pronto para implantar assistentes fundamentados?

Inicie um teste ou fale conosco sobre implantação, governança e requisitos empresariais.