Conecta-seEntrar na plataforma

Visão

Analisar imagens usando um modelo com capacidade visual.

Lógica e processamentoInteligência artificialConexão: Provedor de IA configurado no workspace

O que faz

Integre a análise de imagens ao fluxo. Analisa imagens com modelos de visão.

Quando usar: Use quando o seu fluxo precisar analisar imagens usando um modelo com capacidade visual.

Exemplo de situação: Interpretar uma solicitação e produzir uma resposta adequada ao contexto.

Antes de começar

Conexão necessária: Provedor de IA configurado no workspace.

Cadastre a chave do provedor de IA do workspace em Configurações e escolha um modelo disponível.

Passo a passo

  1. Adicione Visão ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Cadastre a chave do provedor de IA do workspace em Configurações e escolha um modelo disponível.
  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

  • Arquivo de imagem

    Envie um arquivo de imagem.

    Exemplo:
    (selecione um arquivo de teste)
  • Referência ao arquivo de imagem

    Em campos adicionais

    Referencie uma imagem de blocos anteriores.

  • URL da imagem (alternativa)

    Ou informe a URL pública de uma imagem.

    Exemplo:
    https://api.exemplo.com/v1/recurso
  • Modelo

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

    Opções:
    GPT 5.2 · GPT 5.1 · GPT 5 · GPT 5 Mini · GPT 5 Nano · Claude Opus 4.5 · Claude Sonnet 4.5 · Claude Haiku 4.5 · Gemini 3.1 Pro Preview · Gemini 3 Pro Preview · Gemini 3 Flash Preview · Gemini 2.5 Pro · Gemini 2.5 Flash · Gemini 2.5 Flash Lite
    Padrão:
    GPT 5.2
  • 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.
  • Chave de API

    ObrigatórioDado protegido

    Informe a sua chave de API.

    Padrão:
    Segredo protegido

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 <visao.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
<visao.content>stringResultado da análise.
<visao.model>stringModelo usado.
<visao.tokens>numberUso de tokens.

Exemplo de uso

Objetivo: Interpretar uma solicitação e produzir uma resposta adequada ao contexto.

InícioVisãopróxima etapa
Instrução
Olá! Sua solicitação foi processada com sucesso.
Arquivo de imagem
(selecione um arquivo de teste)
URL da imagem (alternativa)
https://api.exemplo.com/v1/recurso
Modelo
GPT 5.2

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 <visao.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Blocos relacionados