Pular para o conteúdo
SquadOS SquadOS Docs

Primeira Conversa

A primeira conversa é um teste controlado do agente configurado. Faça esse teste antes de divulgar um link público, instalar o widget ou conectar WhatsApp, Telegram ou outra integração.

Abrir uma sessão nova

Section titled “Abrir uma sessão nova”

Abra o Hub em /hub. Se a sua organização usa salas colaborativas e o Hub abrir uma sala primeiro, selecione Agentes na navegação. Você também pode abrir Agentes, no Admin, e escolher Conversar no agente desejado.

Uma sessão vazia mostra Em que posso ajudar?, o campo Digite sua mensagem… e atalhos em Ou fale com um agente. Escolha um agente por um desses atalhos ou pelo seletor no compositor.

O seletor de modelo aparece somente para quem tem permissão de alterar o modelo. Para o primeiro teste, mantenha o modelo configurado no agente. Se você escolher outro, a sessão passa a usar e guardar essa escolha nas mensagens seguintes.

Preparar uma mensagem segura

Section titled “Preparar uma mensagem segura”

Comece com uma pergunta curta e representativa, por exemplo uma dúvida comum de cliente. Ferramentas conectadas são reais: uma ferramenta pode enviar dados ou alterar um serviço externo. Em testes, prefira dados descartáveis e operações de leitura; não peça uma ação irreversível só para confirmar que a ferramenta existe.

Você pode anexar até cinco arquivos. O compositor aceita imagens JPG, PNG, GIF e WebP; PDF; TXT, Markdown e CSV; Word; e Excel. O arquivo final deve ter até 4 MB. Imagens de até 10 MB e PDFs de até 25 MB podem ser aceitos como entrada para compactação. Áudio, geração de imagem e outros controles aparecem somente quando o agente e as permissões da organização permitem.

Digite a mensagem e pressione Enter para enviar. Use Shift+Enter para quebrar a linha sem enviar.

Entender o primeiro envio

Section titled “Entender o primeiro envio”

A tela mostra sua mensagem imediatamente e começa a transmitir a resposta. A conversa só é criada no primeiro envio válido; então a URL muda para a sessão criada. O título começa como Nova conversa e pode ser renomeado automaticamente a partir da primeira mensagem.

Durante a resposta, o caminho do agente pode exibir raciocínio, ferramentas e consumo. Alguns rótulos técnicos ainda aparecem em inglês na interface PT-BR. Isso não altera o resultado, mas pode misturar idiomas nos detalhes.

Critério de aprovação

Section titled “Critério de aprovação”

Considere o primeiro teste aprovado somente quando houver uma resposta do agente selecionado que seja visível, não vazia, permaneça na conversa após atualizar a página e não contenha uma etapa de erro. Além disso, confira:

  • o tom e as instruções do prompt foram respeitados;
  • fatos da base de conhecimento foram usados sem invenção;
  • perguntas ambíguas geraram pedido de esclarecimento;
  • ferramentas corretas foram chamadas com argumentos esperados;
  • pedidos fora do escopo foram recusados ou redirecionados com clareza;
  • a resposta foi proporcional à pergunta.

Uma ferramenta marcada como executada não prova, sozinha, que o efeito externo foi correto. Quando o teste envolver uma ação segura, confira o resultado no sistema de destino.

Se a resposta falhar

Section titled “Se a resposta falhar”
  • Agente indisponível ou sem permissão: confirme que o agente está visível para sua organização e que sua função tem acesso ao Hub.
  • Sessão expirada: entre novamente e repita o teste em uma conversa nova.
  • Créditos insuficientes: verifique o saldo da organização antes de reenviar.
  • Conexão perdida ou resposta travada: aguarde a mensagem de erro e tente uma nova sessão. Se a transmissão terminar vazia ou incompleta sem aviso, atualize a página e confira o que foi persistido. Não marque o teste como aprovado nem repita uma ação com efeito externo antes dessa conferência.

Ajustar e testar de novo

Section titled “Ajustar e testar de novo”

Se o resultado não passar nos critérios, volte ao editor em /admin/agents/:id/edit e revise prompt, modelo, bases de conhecimento ou ferramentas. Depois, abra uma conversa nova: a sessão antiga mantém o próprio histórico e pode esconder o efeito da alteração.

Próximo passo opcional

Section titled “Próximo passo opcional”

Depois que o agente passar no Hub, você pode conectá-lo a um canal. Essa conexão é opcional e não faz parte da criação ou da validação inicial do agente: