Visão Geral

Blocos são os componentes de construção que você conecta para criar workflows de IA. Pense neles como módulos especializados que lidam com tarefas específicas—desde conversar com modelos de IA até fazer chamadas de API ou processar dados.

Tipos de Blocos Principais

ZippyVendas fornece tipos de blocos essenciais que lidam com as funções principais de workflows de IA:

Blocos de Processamento

• Agent - Converse com modelos de IA (OpenAI, Anthropic, Google, modelos locais)
• Function - Execute código JavaScript/TypeScript personalizado
• API - Conecte-se a serviços externos via requisições HTTP

Blocos de Lógica

• Condition - Ramifique caminhos de workflow baseado em expressões booleanas
• Router - Use IA para rotear inteligentemente requisições para diferentes caminhos
• Evaluator - Avalie e pontue a qualidade do conteúdo usando IA

Blocos de Fluxo de Controle

• Variables - Defina e gerencie variáveis com escopo de workflow
• Wait - Pause a execução do workflow por um atraso de tempo especificado
• Human in the Loop - Pause para aprovação e feedback humano antes de continuar

Blocos de Saída

• Response - Formate e retorne resultados finais do seu workflow

Como os Blocos Funcionam

Cada bloco tem três componentes principais:

Entradas: Dados que entram no bloco de outros blocos ou entrada do usuário Configuração: Configurações que controlam como o bloco se comporta Saídas: Dados que o bloco produz para outros blocos usarem

Conectando Blocos

Você cria workflows conectando blocos. A saída de um bloco se torna a entrada de outro:

• Arraste para conectar: Arraste de uma porta de saída para uma porta de entrada
• Múltiplas conexões: Uma saída pode conectar a múltiplas entradas
• Caminhos ramificados: Alguns blocos podem rotear para diferentes caminhos baseado em condições

Padrões Comuns

Processamento Sequencial

Conecte blocos em uma cadeia onde cada bloco processa a saída do anterior:

Entrada do Usuário → Agent → Function → Response

Ramificação Condicional

Use blocos Condition ou Router para criar diferentes caminhos:

Entrada do Usuário → Router → Agent A (para perguntas)
                   → Agent B (para comandos)

Controle de Qualidade

Use blocos Evaluator para avaliar e filtrar saídas:

Agent → Evaluator → Condition → Response (se bom)
                              → Agent (repetir se ruim)

Configuração de Blocos

Cada tipo de bloco tem opções de configuração específicas:

Todos os Blocos:

• Conexões de entrada/saída
• Comportamento de tratamento de erros
• Configurações de timeout de execução

Blocos de IA (Agent, Router, Evaluator):

• Seleção de modelo (OpenAI, Anthropic, Google, local)
• Chaves de API e autenticação
• Temperatura e outros parâmetros do modelo
• Prompts do sistema e instruções

Blocos de Lógica (Condition, Function):

• Expressões ou código personalizado
• Referências de variáveis
• Configurações de ambiente de execução

Blocos de Integração (API, Response):

• Configuração de endpoint
• Cabeçalhos e autenticação
• Formatação de requisição/resposta