Agentes de UI

O agente de interface do usuário é um agente nativo que entende as instruções em linguagem natural para realizar ações complexas do navegador. Ele pode navegar em sites de forma autônoma, clicar, digitar, ler dados e produzir saídas estruturadas otimizadas para etapas de automação posteriores. Exemplos de casos de uso incluem resumir produtos em uma página da web ou buscar dados navegando em sites.

Propriedades

Título

Nome do step/UI agente

Instruções

Nesse campo, você escreve o prompt para o agente em linguagem natural. Práticas recomendadas ao escrever o prompt:

• Seja claro e explícito sobre o que você quer.

• Estruture o prompt. Comece mencionando primeiro a 'Tarefa' ou 'Função' e depois as 'Instruções' para realizar a tarefa com etapas numeradas

• Adicione restrições (por exemplo, revise apenas a seção de produtos) e especifique quando stop/end (por exemplo, pare quando encontrar as informações relevantes)

• Forneça exemplos positivos e negativos (não faça isso)

• Especifique claramente os requisitos de tamanho (por exemplo, menos de 100 palavras) ou formato de saída (por exemplo, data no MM/DD/YY formato)

Coloque o texto entre aspas triplas (“"”) para escrever solicitações com várias linhas. Por exemplo:

"""Task: Locate the company's latest annual report.
* Visit the provided URL.
* Look for the annual report. The report may be titled 'Annual Report', 'Financial Report', 'Year in Review', or similar variations..."""

Saída estruturada (opcional)

Resposta do agente: Nome da variável para atribuir a saída desta operação

Como configurar campos de saída estruturados

Adicionando campos

• Clique em Adicionar campo para criar um novo campo de saída

• Insira o nome de saída - isso se torna o nome da propriedade JSON

• Selecione o Tipo no menu suspenso

• Marque Obrigatório se o campo deve estar sempre presente

• Adicione uma descrição para orientar o agente de IA

Tipos de campo

• Cadeia de caracteres - valores de texto (nomes, descrições, resumos)

• Número - Valores numéricos (contagens, pontuações, porcentagens)

• Booleano - True/false valores (sinalizadores de status, yes/no perguntas)

• Objeto - Estrutura aninhada (agrupamentos de dados complexos)

• Matriz - Lista de itens (tags, categorias, vários valores)

• Arquivo - Referências de arquivo (anexos de documentos, imagens)

• Tabela de dados - Dados tabulares (conjuntos de dados estruturados, relatórios)

Trabalhando com tipos complexos

Objetos e matrizes podem conter campos aninhados:

• Clique na seta de expansão (▶) ao lado dos campos Objeto ou Matriz

• Use Adicionar campo dentro da estrutura aninhada

• Mantenha o aninhamento em 2 a 3 níveis no máximo para um desempenho ideal

Exemplo de configuração

Aqui está uma configuração simples para resumir o feedback do cliente:

{
  "orderId": "12345",
  "numberOfOrders": 3,
  "hasShipped": true,
  "orderDetails": {
    "quantity": 2,
    "productName": "ABC",
  },
  "tags": ["electronics", "urgent"]
}

Essa estrutura seria configurada como:

• OrderId (String, obrigatório)

• número OfOrders (Número, obrigatório)

• HasShipped (booleano, obrigatório)

• Detalhes do pedido (objeto, obrigatório)

  • quantidade (Número, obrigatório)

  • Nome do produto (string, obrigatório)

• tags (matriz de sequências de caracteres, opcional)

Práticas recomendadas

• Use nomes de campo descritivos - ajude a IA a entender quais dados extrair

• Adicione descrições claras - forneça contexto para campos complexos

• Marque os campos críticos conforme necessário - Garanta que os dados essenciais estejam sempre presentes

• Limite a profundidade de aninhamento - mantenha as estruturas simples para um melhor desempenho

• Teste sua configuração - Verifique se a saída corresponde às suas expectativas executando a etapa do agente e verificando a resposta.

Observações importantes

• Conhecimento de JSON: Não está familiarizado com JSON? Aprenda o básico em json.org

• Sem validação: atualmente, o sistema não valida a estrutura de saída - garanta que sua automação manipule dados ausentes ou malformados