Primeiro Agente Completo

Este guia leva você de um objetivo inicial a um agente testado e, se necessário, conectado a uma caixa de entrada. Ele considera uma conta com permissão para criar agentes; os itens visíveis no menu podem mudar conforme seu papel e os recursos habilitados para a organização.

1. Defina o objetivo

Comece por algo focado:

• responder dúvidas frequentes;
• orientar clientes sobre um processo;
• ajudar a equipe interna com procedimentos;
• coletar informações antes de passar para um humano.

Fluxos pequenos são muito mais fáceis de testar — depois você expande.

2. Crie o agente

Abra Meus Agentes e clique em Novo Agente. No diálogo Novo Agente:

1. preencha Nome do agente;
2. escolha uma Categoria inicial quando o campo for obrigatório para o seu acesso;
3. clique em Criar Agente.

O SquadOS abre o editor do novo agente. Em telas desktop, o AgentMaker abre automaticamente para ajudar a montar o primeiro prompt.

3. Escreva e salve o prompt

O editor começa em Prompt. Escolha uma forma de trabalho:

• converse com o AgentMaker, revise as propostas apresentadas e aplique somente as que fizerem sentido;
• clique em Editar Prompt para escrever ou ajustar as instruções manualmente.

Inclua o papel do agente, o público atendido, o que ele deve fazer, seus limites e quando deve transferir ou pedir mais informações. Salve antes de testar. Se houver mudanças pendentes, o painel de teste usa a versão já salva e oferece Salvar e testar.

4. Escolha o modelo

Abra Modelo. A seção pode mostrar os atalhos Mais barato, Melhor custo-benefício e Melhor performance, além dos grupos Sugeridos e Outros modelos (não sugeridos para esse agente).

Essas recomendações são calculadas a partir do catálogo liberado para a organização e das capacidades exigidas pela configuração atual, como uso de ferramentas, leitura de imagens e tamanho do contexto. Por isso, o modelo indicado pode mudar e não deve ser escolhido por um nome fixo deste guia.

Compare capacidade e custo em créditos, selecione o modelo adequado ao seu caso e salve. Para um primeiro fluxo simples, Melhor custo-benefício é um ponto de partida; valide o resultado com as perguntas do passo 6.

5. Adicione conhecimento e ferramentas, se precisar

O editor separa essas duas configurações:

• Em Conhecimento, marque as Bases de conhecimento que o agente pode consultar sob demanda. Você também pode selecionar Blocos de contexto, enviados por completo em todas as respostas, e configurar o AutoLearn quando houver uma base selecionada.
• Em Ferramentas, clique em Adicionar Ferramenta para conectar Ferramentas Nativas, Ferramentas da Organização, Outras Ferramentas ou servidores MCP disponíveis. Usuários com permissão também podem criar uma Ferramenta HTTP / API ou conectar um Servidor MCP.

Não procure Consultar Base de Conhecimento no seletor de ferramentas: a ativação dessa capacidade é gerenciada pela seção Conhecimento quando você marca uma base.

6. Teste no próprio editor

No cabeçalho, clique em Testar Agente. O teste abre em um painel integrado ao editor e mantém conversas anteriores para você retomar. O botão fica desabilitado quando o agente está inativo.

Teste pelo menos:

• uma pergunta comum que o agente deve responder;
• uma pergunta difícil ou ambígua;
• uma solicitação fora do escopo;
• uma ação que use conhecimento ou ferramenta, se essas capacidades estiverem configuradas.

Corrija o prompt ou a configuração, salve e repita até o comportamento ficar consistente.

7. Conecte uma caixa de entrada, se precisar

O teste no editor já conclui a criação do agente. Para receber mensagens de um canal externo, abra Caixas de Entrada e clique em Conectar caixa de entrada.

Escolha um canal disponível, conclua sua configuração e, em Quem atende esta caixa?, selecione o agente como destino. O assistente abre depois Horários de atendimento; você pode salvar uma agenda ou usar Configurar depois.

Os canais podem incluir WhatsApp, WhatsApp Oficial, provedores compatíveis, Instagram Direct, Instagram Comentários, Telegram, Página pública, Widget e API. A disponibilidade depende dos recursos liberados para a organização.

Para uma validação controlada, comece com uma Página pública compartilhada somente com a equipe. Antes de expor qualquer canal ao público, execute o Checklist de Publicação. O fluxo completo está em Caixas de Entrada.

Próximos passos

• Explore as Ferramentas Nativas para entender o que o agente já pode fazer sem integração externa.
• Configure Usuários e Papéis se outras pessoas da empresa também vão administrar ou usar o SquadOS.