Conecta-seEntrar na plataforma

Roteador

Encaminhar o fluxo para uma entre várias rotas conforme regras configuradas.

Lógica e processamentoRecurso internoConexão: OAuth

O que faz

Direciona a execução do fluxo para caminhos diferentes de forma inteligente, com base na análise da entrada. Use linguagem natural para dizer ao roteador para quais blocos encaminhar de acordo com a entrada.

Quando usar: Use quando o seu fluxo precisar encaminhar o fluxo para uma entre várias rotas conforme regras configuradas.

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 Roteador 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

  • Instrução

    Obrigatório

    Descreve, em linguagem clara, o resultado que a inteligência artificial deve produzir.

    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 escolhe o caminho 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 do roteador (ex.: us-central1); confira 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 do roteador (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:
    You are an intelligent routing agent responsible for directing workflow requests to the most approp…
    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 <roteador.prompt>: 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
<roteador.prompt>stringInstrução de roteamento usada.
<roteador.model>stringModelo usado.
<roteador.tokens>jsonUso de tokens.
<roteador.cost>jsonInformações de custo.
<roteador.selectedPath>jsonCaminho de roteamento escolhido.
<roteador.selectedRoute>stringID da rota escolhida.

Exemplo de uso

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

InícioRoteadorpróxima etapa
Instrução
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
Região da AWS
us-east-1

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 <roteador.prompt>. 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