Conecta-seEntrar na plataforma

Avaliador

Avaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.

Lógica e processamentoRecurso internoConexão: OAuth

O que faz

Avalia a qualidade de um conteúdo com métricas de avaliação e critérios de pontuação personalizáveis. Crie avaliações objetivas, com notas numéricas, para medir o desempenho em várias dimensões.

Quando usar: Use quando o seu fluxo precisar avaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.

Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Avaliador ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Métricas

    Obrigatório

    Critérios que o modelo vai usar para dar nota ao conteúdo: para cada métrica, informe o nome, a descrição do que avaliar e a faixa de notas (ex.: clareza, de 1 a 5).

  • Conteúdo

    Obrigatório

    Informe o conteúdo a avaliar.

    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Modelo

    Obrigatório

    Escolhe o modelo de inteligência artificial que processará a solicitação.

    Padrão:
    claude-sonnet-4-6

  • Conta do Google Cloud

    Obrigatório conforme a operação

    Selecione a conta do Google Cloud.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Exemplo:
    (escolha a conta conectada)

  • Conta do Google Cloud

    Obrigatório conforme a operaçãoEm campos adicionais

    Informe o ID da credencial.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”

  • Chave de API

    Obrigatório conforme a operaçãoDado protegido

    Informe sua chave de API.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Endpoint do Azure

    Dado protegido

    Informa o endereço seguro do serviço ou recurso que será acessado.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Versão da API do Azure

    Informe a versão da API.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”

  • Projeto do Vertex AI

    Obrigatório conforme a operaçãoDado protegido

    ID do projeto do Google Cloud em que o Vertex AI está ativado, usado quando o modelo que avalia o conteúdo roda pelo Vertex AI (ex.: minha-empresa-ia).

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Região do Vertex AI

    Obrigatório conforme a operação

    Região do Google Cloud em que o Vertex AI vai executar o modelo avaliador (ex.: us-central1); confira no console do Google Cloud se o modelo está disponível nessa região.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Exemplo:
    us-central1

  • ID da chave de acesso da AWS

    Obrigatório conforme a operaçãoDado protegido

    Informe o ID da chave de acesso da AWS.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Chave de acesso secreta da AWS

    Obrigatório conforme a operaçãoDado protegido

    Informe a chave de acesso secreta da AWS.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Região da AWS

    Região da AWS em que o Amazon Bedrock vai executar o modelo avaliador (ex.: us-east-1 ou sa-east-1, São Paulo); o modelo precisa estar liberado no Bedrock nessa região.

    Quando aparece:
    Quando o campo “Modelo” for “__no_model_selected__”
    Exemplo:
    us-east-1

  • Modelos alternativos

    Em campos adicionais

    Modelos tentados uma vez cada, em ordem, quando a chamada do modelo selecionado falha; com "Repetir em caso de falha", depois que as tentativas se esgotam.

  • Criatividade

    Controla a variação da resposta; valores menores tendem a ser mais previsíveis.

  • Instruções do agente

    Informa o conteúdo de texto que será enviado ou processado.

    Padrão:
    {"systemPrompt":"You are an objective evaluation agent. Analyze the content against the provided me…
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <avaliador.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<avaliador.content>stringResultados da avaliação.
<avaliador.model>stringModelo usado.
<avaliador.tokens>jsonUso de tokens.
<avaliador.cost>jsonInformações de custo.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

InícioAvaliadorpróxima etapa
Conteúdo
Olá! Sua solicitação foi processada com sucesso.
Modelo
claude-sonnet-4-6
Conta do Google Cloud
(escolha a conta conectada)
Região do Vertex AI
us-central1

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <avaliador.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.

Blocos relacionados