Editor de prompt

O Editor de solicitação é a área de texto avançado no Agent Builder onde você escreve a solicitação do sistema e a solicitação do usuário. Os argumentos, ferramentas, contextos, escalonamentos e saídas são representados como referências em linha codificadas por cores — chamadas pílulas — em vez de espaços reservados digitados.

O Editor de solicitação está disponível para Agents autônomos e conversacionais e aplica-se à solicitação do sistema e à solicitação do usuário.

O gatilho @

O Editor de solicitação usa uma única tecla de gatilho para todos os tipos de referência.

Digitar @ em qualquer lugar da solicitação abre o seletor de referência. O seletor agrupa referências disponíveis em cinco seções em uma ordem fixa:

1. Entradas — argumentos que o agente recebe no runtime
2. Ferramentas — ferramentas que se conectam ao agente
3. Contexto — fontes de contextualização
4. Escalonamentos — caminhos de escalonamento
5. Saídas — saídas de etapas anteriores, quando aplicável

Continuar a digitar após @ restringe a lista com correspondência difusa — não é necessário um prefixo exato. Por exemplo, @srch corresponde a tools.web_search.

Navegação pelo teclado no seletor

Chave	Ação
↑ / ↓	Mover a seleção para cima ou para baixo
Tab / Shift+Tab	Igual às teclas de seta
Enter	Inserir a referência destacada
Esc	Fechar o seletor sem inserir
Selecionar com o mouse	Inserir a referência selecionada

Quando @ não abre o seletor

Para evitar a ativação não intencional durante a digitação normal, o caractere @ abre o seletor apenas quando aparece:

• no início de uma linha, ou
• imediatamente após um caractere de espaço em branco.

Escrever [e-mail] no meio de uma frase não abre o seletor — o sistema preserva o @ como texto simples. Digitar um espaço antes de @ força o seletor a abrir.

Compatibilidade com {{ }} espaços reservados

As solicitações existentes que contêm {{argument_name}} continuam a funcionar sem qualquer etapa de migração. Quando o editor carrega uma solicitação, os espaços reservados {{ }} se convertem automaticamente em botões arredondados na tela.Ao salvar a solicitação, o sistema grava as pílulas de entrada no armazenamento como {{argument_name}} e as pílulas de ferramenta, contexto e saída como @{tools.search} — preservando a compatibilidade com quaisquer sistemas de back-end que leiam solicitações como texto.

Digitar {{ ... }} diretamente durante a edição não é um gatilho —o sistema o preserva como texto simples e o converte em uma pílula apenas quando você salva e reabre a solicitação, desde que o nome interno corresponda a um argumento existente. Use @ para inserir referências.

Referências como pílulas

O sistema renderiza cada referência em uma solicitação como uma pílula em linha que contém:

• um ícone de categoria
• um rótulo — o último segmento do caminho de referência (por exemplo, em web_search vez de tools.web_search)
• uma cor que reflete a categoria de referência: entradas em azul, ferramentas e contextos e escalonamentos em verde, saídas em laranja

As pílulas comportam-se como unidades individuais:

• As teclas de seta movem o cursor sobre uma pílula em um único pressionamento de tecla.
• Backspace ou Excluir removem toda a referência.
• Cada pílula tem um botão × ao focalizar para remoção com um mouse.
• Você pode copiar e colar pílulas em diferentes campos de solicitação no mesmo agente ou nas solicitações de outro agente.Ao colar as pílulas em um destino de texto simples fora do editor, elas voltam ao formato de texto {{...}} ou @{...}.

Referências inválidas

Quando uma referência aponta para um recurso que não existe mais — por exemplo, uma ferramenta que foi removida ou um argumento que foi renomeado manualmente — a pílula fica vermelha. Esse é apenas um sinal visual; o sistema ainda salva a solicitação como está.

Você pode resolver uma referência inválida excluindo a pílula vermelha e selecionando uma substituição usando @ ou renomeando o recurso subjacente para que a referência se torne válida novamente.

Propagação de renomeação automática

Sempre que você renomeia uma ferramenta, argumento, contexto, escalonamento ou saída dentro da definição do agente, o editor detecta a alteração e atualiza automaticamente cada pílula que a referenciou em todos os campos de solicitação.O sistema também reescreve caminhos aninhados de forma consistente.

Não é possível detectar as renomeações feitas fora da definição do agente, por exemplo, editando o JSON bruto diretamente.

Editar e visualizar

A barra de ferramentas na parte superior do editor inclui uma alternância Editar/Visualizar.

• Editar — o modo de edição em tempo real para inserir texto, aplicar formatação e inserir referências.
• Visualização — uma renderização SomenteLeitura da solicitação com aplicação de todas as pílulas e marcação. Use a visualização para verificar a aparência final de solicitações longas ou fortemente formatadas antes de salvar.

Mudar para Visualizar preserva o rascunho atual. Ao alternar de volta para Editar, você retorna ao estado de edição exato de antes da alternância.

Barra de ferramentas de formatação

No modo Editar, a barra de ferramentas expõe as seguintes ações de formatação:

Botão	Efeito	Atalho do teclado
H	Alternar cabeçalho na linha atual	—
B	Apresentar o texto selecionado em negrito	—
I	Colocar o texto selecionado em itálico	—
</>	Código em linha	—
Lista numerada	Alternar uma lista numerada	—
Lista com marcadores	Alternar uma lista com marcadores	—
Desfazer	Retroceder pelas edições etapa por etapa	Ctrl / ⌘ + Z
Refazer	Avançar pelas edições etapa por etapa	Ctrl / ⌘ + Shift + Z

A barra de ferramentas preserva literalmente o Markdown aplicado na solicitação salva e o renderiza com estilo de Markdown completo — incluindo cabeçalhos, listas, blocos de código cercados, citações em bloco e tabelas — no Modo de Visualização.A barra de ferramentas fica desabilitada enquanto o Modo de Visualização está ativo.

Destaques da cobertura

Quando os dados de cobertura de solicitação ficam disponíveis após a execução de um conjunto de avaliações, uma alternância de Cobertura aparece na barra de ferramentas.

Selecionar Cobertura muda o editor para Visualizar com destaques em linha mostrando quais instruções na solicitação foram utilizadas durante as execuções de avaliação. Selecionar uma seção destacada abre um popover com a listagem das execuções de avaliação específicas que a cobrem.O botão ↻ ao lado da alternância recalcula a cobertura quando a solicitação ou o conjunto de avaliações muda.

Alternar para Editar desativa o destaque de cobertura.

Revisão de sugestões de IA

Quando o Autopilot ou outro Assistente de IA propõe uma reescrita da sua solicitação, o editor entra no modo de comparação:

• O conteúdo removido aparece com um tachado vermelho.
• O conteúdo adicionado aparece com um realce verde.
• O editor é somente leitura enquanto você visualiza a comparação.

Dois botões aparecem no canto inferior direito do editor: Aceitar substitui a solicitação pela versão sugerida, e Rejeitar descarta a sugestão e restaura o original. Mantemos a solicitação original exatamente como está até que você selecione um desses botões.

Edição em tela cheia

O ícone Expandir na extremidade direita da barra de ferramentas abre o editor em um modal em tela cheia. Isso é útil para solicitações longas em que o espaço disponível na tela é limitado. O sistema mantém as edições feitas no modal quando você o fecha.

Acessibilidade

• Você poder acessar todos os botões da barra de ferramentas pelo teclado com Tab e inclui uma dica de ferramenta e aria-label.
• O seletor de referência é totalmente orientado por teclado — inserir qualquer referência não requer um mouse.
• A alternância Editar/Visualizar e a alternância Cobertura expõem seu estado por meio da semântica aria-pressed.
• O editor anuncia o nome do campo ativo para os leitores de tela — por exemplo, "Solicitação do sistema" — por meio de sua configuração ariaLabel.

Perguntas frequentes

As solicitações existentes serão interrompidas?

Não. O editor lê e escreve no mesmo formato que antes — {{argument}} para entradas e @{path} para ferramentas, contextos e saídas. As solicitações existentes abrem como pílulas automaticamente; você não precisa de nenhuma etapa de migração.

Can I still type {{ to insert an argument?

Não. {{ }} não é mais um gatilho de criação no editor. Use @ em vez disso. Qualquer {{ ... }} que você digite durante a edição é preservado como texto simples e convertido em uma pílula apenas quando a solicitação é salva e reaberta, desde que o nome interno corresponda a um argumento existente.

Does the @ trigger conflict with email addresses or social handles?

Não. O seletor abre apenas quando @ aparece no início de uma linha ou diretamente após um caractere de espaço em branco, portanto, [e-mail] no meio de uma frase é tratado como texto simples.

O que acontece se eu renomear um argumento ou ferramenta?

O editor detecta renomeações feitas dentro da definição do agente e atualiza todas as referências em todas as solicitações automaticamente. Uma referência fica vermelha apenas quando o recurso subjacente foi excluído ou seu caminho foi alterado de uma forma que o editor não conseguiu inferir.

Posso desabilitar o novo editor?

Um sinalizador de funcionalidade controla o Editor de solicitação durante o lançamento.Para retornar ao editor anterior durante a Janela de lançamento, entre em contato com seu representante da UiPath.

Veja também

• Solicitações — solicitações do sistema, solicitações do usuário e orientações sobre como escrever solicitações
• Definição de argumentos — crie argumentos de entrada e saída e faça referência a eles nas solicitações