Testando seu Agente

Aprenda como testar seu Agent Component diretamente em sua configuração, sem executar o pipeline completo.

O Agent Component inclui uma capacidade de teste integrada que permite validar sua configuração sem executar o pipeline inteiro. Usando a área de teste disponível ao lado da configuração principal, você pode verificar rapidamente se o componente está configurado corretamente.

Como testar o Agent Component

Executando um teste simples

Para realizar uma execução básica no Agent Component:

1. Configure o componente conforme necessário.

2. Clique em Executar.

Após a conclusão da execução, a seção Detalhes do Output exibe as seguintes informações:

Logs

Todos os logs de execução são agrupados aqui, fornecendo visibilidade do comportamento do componente. Os logs incluem:

• Configuração: Configurações do provedor e do modelo usadas na execução.

• Entrada: Detalhes do contexto de entrada, incluindo ferramentas configuradas e status de recuperação de conteúdo.

• Sistema: A Mensagem do Sistema que orientou o comportamento do modelo.

• Usuário: A Mensagem do Usuário exatamente como recebida, em texto, Markdown ou JSON.

• Tool Call: Detalhes sobre quaisquer chamadas de ferramenta, incluindo argumentos e resultados.

• Input/Output Guardrail: Informações sobre as guardas aplicadas e seu impacto na execução.

Esses logs facilitam a validação dos resultados e a solução de problemas de comportamento inesperado.

Saída

O resultado da execução em formato JSON. Você pode pesquisar campos específicos usando expressões JSONPath.

Run multiple tests using variables

Você também pode rodar múltiplos testes simultaneamente, simulando diferentes cenários com variáveis mockadas. Isso é ideal para comparar como diferentes prompts reagem a diversas entradas de dados, sem esperar pelos dados de conectores anteriores.

Para mockar variáveis, seus prompts de Sistema ou Usuário devem incluir expressões Double Braces, como:

{{ message.body.text }}

Neste exemplo, {{ message.body.text }} pode ser mockado com a seguinte estrutura:

{
  "body": {
    "text": "Este produto é incrível! A melhor compra que já fiz."
  }
}

Para configurar as variáveis mockadas, siga estas etapas:

1. No Playground do Agent Component, clique em Experimentos.

2. Clique em Selecione um dataset e escolha Criar um novo dataset.

3. Insira um nome para o dataset. Você pode criar múltiplos datasets para testar diferentes cenários.

4. Clique em Novo Experimento. Você pode criar múltiplos experimentos para testar diferentes valores de variáveis de uma só vez.

5. Selecione as expressões desejadas e forneça seus valores no campo Value.

6. Selecione os experimentos que deseja executar e clique em Executar.

O Agent Component detecta automaticamente todas as expressões em Double Braces utilizadas nos prompts.

Como visualizar e salvar os resultados dos testes

Todas as execuções (Testes simples e Experimentos) são capturadas automaticamente na seção Traces. Salvar as execuções permite que você mantenha um histórico completo para referência futura e auditorias de performance. Veja as regras de retenção de dados e armazenamento abaixo:

• Salvamento automático: Por padrão, as execuções são armazenadas temporariamente por 5 dias. Se você fechar e reabrir o componente, elas permanecerão disponíveis dentro deste período.

• Armazenamento persistente: Para evitar que uma execução seja deletada após 5 dias, você deve abrir a seção Traces, selecionar as execuções desejadas e clicar em Salvar.

Em Traces, cada execução é listada com os seguintes detalhes:

• ID de execução

• Status da execução

• User Message utilizada

• Latência (em segundos)

• Data e hora

Para salvar um trace e manter o histórico de execução, o pipeline deve ser salvo previamente.