A utilização de agentes com API pode ser um pouco mais complexa, especialmente para iniciantes. Um dos primeiros obstáculos que muitos enfrentam é lidar com a ausência de respostas instantâneas após a execução de um agente ou então uma espera maior. Vamos explicar melhor hoje!
Conceituando a Resposta do Agente
Ao acionar um agente na Tess AI e automatizar sua execução, é fundamental entender que, em algumas situações, você pode não receber uma resposta imediata (como agentes mais complexos, por exemplo).
Quando você envia uma mensagem ao agente, é possível que a saída, ou output, venha vazia, mesmo que o agente tenha gerado uma resposta. Isso ocorre porque, frequentemente, não foi fornecido um comando que instrua o agente a retornar uma resposta diretamente na plataforma ao solicitá-la.
Ajustando a Requisição para Respostas Imediatas
Uma maneira simples de garantir que você receba uma resposta do agente é configurar a variável WaitExecution como True. Essa configuração informa ao agente que a resposta deve ser enviada assim que ela estiver pronta. Por exemplo, se você enviar uma mensagem como "Oi, tudo bem?", e tiver o WaitExecution configurado como False, você não receberá a resposta instantaneamente, como uma interação fluída, mas se configurar como True, terá a resposta do agente retornada imediatamente.
No entanto, é preciso avaliar o contexto de uso, pois essa abordagem nem sempre é a mais eficiente.
Se a tarefa que o agente precisa realizar é complexa ou se ele precisa processar várias etapas, a espera por uma resposta pode resultar em timeouts ou erros, especialmente em casos que exigem mais tempo para computação.
Quando utilizar a Requisição Não Imediata
Para situações onde a resposta não precisa ser imediata, como a geração de relatórios ou tarefas que ocorrem em eventos programados (por exemplo, um relatório agendado para às 6 da manhã), é mais eficiente não usar o WaitExecution com a configuração que vimos. Nesses casos, você pode simplesmente enviar o pedido de execução e posteriormente buscar a resposta. (você pode acessar nossa documentação para isso)
Como Buscar Respostas Não Imediatas
Para obter a resposta em um cenário não imediato, você precisa realizar algumas etapas adicionais. Após executar o pedido, espere um determinado período—isso pode ser feito utilizando um nó de espera, comum em ferramentas de automação como o N8N, Make ou Zapier. Após o tempo de espera, é necessário fazer uma nova requisição, utilizando um método GET, para buscar a resposta do agente.
É crucial, neste ponto, que você inclua o identificador da resposta no seu novo pedido. Este ID é a chave que permitirá que você recupere os resultados específicos gerados pelo agente após a execução inicial.
Conclusão
Existem duas abordagens principais para obter respostas de um agente na Tess AI: uma que proporciona respostas imediatas e outra que permite um certo atraso na resposta. A escolha entre essas duas depende da natureza da tarefa e do tempo que você pode aguardar por uma resposta. Compreender essas dinâmicas é essencial para otimizar suas interações com a Tess AI e garantir que suas solicitações sejam atendidas de maneira eficiente!
Se você quiser se aprofundar mais sobre como chamar um agente pela API ou configurar esses parâmetros, não deixe de conferir materiais adicionais, que podem ser valiosos para aprimorar suas habilidades de uso da Tess AI!
