Pré-visualização de Execução do Agente

O que a Pré-visualização Mostra

A pré-visualização lê a definição do agente, aplica os mesmos filtros de canal e de objeto de contexto que o tempo de execução aplica, e monta quatro painéis:

Uma barra de cabeçalho acima dos painéis mostra a identidade do agente, o canal resolvido (o que está sendo pré-visualizado), o objeto de contexto (se houver) e o orçamento de tokens configurado.

Conflitos de Configuração e Pontuação de Integridade

Além dos quatro painéis, a pré-visualização executa uma varredura determinística de detecção de conflitos sobre a configuração do agente. O resultado são duas coisas:

• Uma pontuação de integridade de 0 a 100, que resume o quanto a configuração está limpa.
• Uma lista de conflitos individuais classificados como Alto (provavelmente vai quebrar o agente) ou Aviso (vale a pena revisar).

A detecção de conflitos é gratuita — ela não chama o modelo. A intenção é detectar os erros óbvios — prompts ausentes, ferramentas não atribuídas que parecem órfãs, incompatibilidades de canal, instruções contraditórias — antes que apareçam em conversas reais.

Seletor de Canal e Objeto de Contexto

A pré-visualização aceita dois parâmetros que mudam o que é carregado:

Canal

Por padrão, usa o canal configurado do agente, mas você pode trocá-lo para qualquer outro canal em que o agente possa ser executado. A pré-visualização refiltra ferramentas, prompts e sugestões para corresponder. Use isso para confirmar que:

• As ferramentas que você destinou ao canal de API estão realmente com esse escopo
• Os prompts que você escreveu para um widget externo não estão vazando acidentalmente para conversas internas
• Os chips de sugestão que você criou para o canal de Comunidade aparecem lá e não no Widget Externo

Objeto de Contexto

Por padrão, não há contexto de registro. Defina o nome de API de um objeto para pré-visualizar o que o agente carrega ao ser executado em uma página de registro desse objeto. A pré-visualização aplica a mesma pontuação de relevância de objeto de contexto que o tempo de execução usa, então as ferramentas com escopo em objetos específicos entram e saem da lista visível conforme você muda o valor.

Para agentes implantados em vários objetos, trocar o objeto de contexto revela como o agente se vê “a partir de” cada um — útil quando uma página de registro exibe menos ferramentas do que outra.

Acompanhamento do Orçamento de Tokens

O painel de Prompts mantém um total acumulado de tokens estimados conforme você rola a página. Cada prompt é sinalizado em verde ou vermelho em relação ao orçamento de tokens configurado do agente; prompts que empurram o total acumulado acima do orçamento ficam visivelmente fora dos limites.

Isso é uma estimativa — o tokenizador do tempo de execução é a fonte da verdade — mas costuma ser precisa o suficiente para detectar o caso em que um prompt adicionado recentemente estourou o orçamento. Combine com o Depurador de Conversas depois de uma execução real para confirmar.

Somente Leitura e Sem Custo

• Nenhuma alteração de dados enquanto você navega. Abrir a pré-visualização só lê dados (sem DML, o termo do Salesforce para inserções, atualizações ou exclusões de registros). A única exceção deliberada é o Edit Loadout: a partir da pré-visualização, um administrador pode excluir ferramentas, prompts ou chips de sugestão específicos da carga deste agente, e salvar grava essas exclusões no registro de Definição de Agente em uma única atualização atômica — você precisa de permissão de edição no agente para usá-lo.
• Nenhuma chamada ao modelo. A pré-visualização não consome créditos. O detector de conflitos é Apex puramente determinístico.
• Executa como o usuário atual. A pré-visualização consulta dados (via SOQL, a linguagem de consulta do Salesforce) usando as regras de compartilhamento e a segurança em nível de campo (FLS) do usuário que a executa. Se um prompt ou uma ferramenta não for visível para o usuário que está pré-visualizando, ele não vai aparecer — refletindo o que esse usuário realmente receberia em tempo de execução.

Onde Encontrar

Abra a pré-visualização a partir de qualquer registro de Definição de Agente — o componente de pré-visualização de execução fica embutido no layout de administração do agente. Você também pode abri-la diretamente na guia Administração da REDA AI.

Como Ela se Diferencia do Depurador de Conversas

A Pré-visualização de Execução mostra o que o agente vai carregar na próxima conversa; o Depurador de Conversas mostra o que o agente carregou em uma conversa passada específica, incluindo as chamadas de ferramenta reais do modelo e as respostas.

• Use a Pré-visualização de Execução enquanto constrói ou refina um agente — antes que qualquer conversa aconteça.
• Use o Depurador de Conversas quando algo deu errado em uma conversa real e você quer entender o motivo.

Conjunto de Recursos por Agente (Editar Conjunto de Recursos)

Alguns agentes precisam de um subconjunto com curadoria das ferramentas, ações, prompts e sugestões que o pacote e suas personalizações disponibilizam. Um caso comum: um agente de portal no canal Comunidade que usa ferramentas personalizadas “elevadas” (executando em modo without sharing) para acessar dados que o usuário do portal não pode acessar diretamente. Nesse caso, as ferramentas padrão em modo de usuário (por exemplo, create_record, update_record, soql_query) se sobrepõem às equivalentes elevadas, e você quer que o LLM veja apenas uma delas. Necessidades semelhantes surgem com prompts (por exemplo, excluir um prompt de persona extenso para um agente com orçamento de tokens apertado) e com chips de sugestão (ocultar uma sugestão que não se aplica a esse agente).

A ação Editar Conjunto de Recursos na Pré-visualização de Execução se aplica às quatro categorias — Ferramentas, Ações, Prompts, Sugestões — e permite que administradores excluam itens específicos de um determinado agente sem tocar nos Metadados Personalizados incluídos no pacote, nos registros de prompt personalizado, nem afetar qualquer outro agente na organização. Itens fornecidos pelo ISV (universais) e itens definidos pelo cliente são igualmente excluíveis.

Usando Editar Conjunto de Recursos

Quando excluir um item

• Você substituiu uma ferramenta padrão por uma equivalente personalizada — por exemplo, uma create_record_elevated executando em without sharing para usuários do portal. Exclua a create_record padrão nesse agente para que o LLM não a escolha.
• O agente nunca deve realizar uma classe de ação — por exemplo, um agente de pesquisa somente leitura que nunca deve conseguir executar delete_record ou update_record.
• Um prompt universal não se encaixa em um agente específico — por exemplo, um prompt extenso de “proteções de segurança” que é universal, mas redundante para um agente exclusivamente interno que já tem regras mais rígidas na sua persona. Exclua-o para recuperar o orçamento de tokens.
• Um chip de sugestão não se aplica — por exemplo, uma sugestão genérica “Mostrar meus casos abertos” que é irrelevante para um agente focado em vendas. Exclua-a para que os usuários do portal não vejam um chip que o agente não consegue responder.
• Você quer minimizar o tamanho do contexto do agente — menos itens = contexto do LLM menor = menor consumo de créditos por turno. Para agentes com propósito restrito, remover itens não usados é um ganho rápido.
• Um item está produzindo comportamento indesejado — exclua-o temporariamente enquanto você investiga e depois reinclua-o.

Boas Práticas

Abra-a depois de cada edição do agente. A pré-visualização é a forma mais barata de confirmar que uma mudança teve o efeito esperado — especialmente quando você está configurando o escopo de canal ou de objeto de contexto pela primeira vez.

Percorra todos os canais que o agente suporta. Um agente que lista API e Interno como canais deve ser pré-visualizado em ambos. Ferramentas e prompts frequentemente parecem corretos em um canal e errados em outro.

Use durante demonstrações. Mostrar a pré-visualização a uma parte interessada é uma forma rápida de comunicar o que um agente faz sem configurar uma conversa ao vivo.

Faça a triagem dos conflitos antes de testar. A lista de conflitos de configuração detecta problemas que, de outra forma, consumiriam uma conversa real. Resolva os itens de nível Alto e revise os Avisos antes de passar uma única mensagem pelo agente.

Trate as estimativas de tokens como uma referência. Uma estimativa não é uma garantia — para decisões de custo em produção, execute uma conversa real e leia os créditos realmente consumidos.

Configurar instruções reutilizáveis

Prompts exclusivos permitem atribuir instruções reutilizáveis a agentes selecionados. Revise Prompt exclusivo e Resumo no Prompt personalizado e Definição de agente, Prompt personalizado, Ativo e Modo de carregamento na atribuição. Sob demanda exige a ferramenta de prompts de contexto na configuração do agente. Escopos com tipos de registro entre colchetes usam regras compartilhadas, inclusive nas prévias. A ordenação de prompts e ferramentas é determinística e a prévia aceita um ID real de registro. Instruções de idioma seguem a mensagem em API/canais externos; marcadores de usuário só se aplicam nos contextos previstos. Preserve prompts próprios ao mesclar padrões atuais.

Perguntas frequentes

Próximos passos

Leia Criar um Agente com IA para melhorias assistidas por IA na configuração de um agente, ou revisite Configuração do Agente para os campos subjacentes do agente que a pré-visualização reflete.