As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Agentes de UI
<a name="ui-agents"></a>

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
<a name="ui-agent-properties"></a>

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
<a name="ui-agent-structured-output"></a>

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