Trabalhando de forma eficaz

A mentalidade, solicitações e práticas de revisão para trabalhar com um agente de codificação em projetos da UiPath e o que separa um rascunho de um resultado entregue.

Um agente de codificação é um colaborador rápido, não um desenvolvedor autônomo. Você define a direção e avalia os resultados; o agente faz o trabalho legado. Trabalhar bem com um é uma habilidade em si, e os comportamentos certos separam um rascunho que você descarta de um resultado que pode enviar.

Como um agente de codificação funciona e sua função

Um agente de codificação pega um objetivo e o realiza passo a passo, verificando o resultado de cada ação e ajustando à medida que avança, muito parecido com um aplicativo de navegação que redireciona após uma etapa perdida. Encontrar um problema no meio e se recuperar dele é o sistema funcionando conforme esperado, não um detalhamento.

Sua função permanece central por todo o tempo. Você define o objetivo, observa o trabalho, detecta problemas e aprova qualquer coisa que mude de estado. Um agente mais capaz aumenta as riscos para essa supervisão em vez de removê-la: o agente ajuda e você decide.

Configurando para o sucesso

Bons resultados vêm de três coisas trabalhando juntas, não apenas de palavras inteligentes:

• Uma solicitação clara.
• Uma configuração de áudio.
• O contexto certo.

O agente funciona a partir de uma memória de trabalho finita, portanto, o que é relevante e atual importa mais do que o volume.

• O agente faz melhor com os arquivos, metas e padrões específicos de que uma tarefa precisa, em vez de tudo o que você tem.
• A habilidade do UiPath correta precisa estar disponível, pois as habilidades nem sempre são selecionadas automaticamente. Nomear a habilidade para a tarefa, uipath-rpa para o trabalho de Automação de Processos Robóticos (RPA), e confirmar que ela está carregada mantém o agente nos padrões internos. Consulte Visão geral de Habilidades.
• Uma nova sessão para cada nova tarefa impede que o contexto obsoleto colete.
• As convenções que você repete a cada sessão pertencem a um arquivo que o agente carrega automaticamente. Consulte Dê ao seu agente o contexto do projeto.

Cinco comportamentos que funcionam

• Você é o arquiteto. A intenção e a estrutura claras, incluindo o que você deseja, as entradas e as restrições, são suas para trazer.
• A saída é um rascunho. O trabalho gerado vale a revisão antes de você confiar nele e não é para envio sem revisão.
• A validação supera a confiança. As próprias verificações da UiPath, como o Analisador de Fluxo de Trabalho (Analisar Projeto) e uma execução local, são mais confiáveis do que a mensagem "concluído" do agente.
• É um revisor também. Um agente é bom em identificar problemas de segurança, lacunas e código desconhecido, não apenas para escrevê-lo.
• Fechar os componentes de loop. Uma breve observação sobre o que funcionou, após uma sessão substancial, vale a pena à medida que o conhecimento da equipe aumenta.

Prompts de gravação que funcionam

A qualidade da sua solicitação é o maior fator no andamento de uma sessão. Uma solicitação forte inclui:

• Uma entrega clara: o arquivo ou projeto exato a ser produzido e onde ele está.
• Entradas e saídas nomeadas, com seus tipos.
• O comportamento esperado de ponta a ponta.
• Restrições explícitas: as atividades ou pacotes a serem usados e os que devem ser evitados.
• Qualquer contexto de que o agente precise, como dependências existentes.

Uma solicitação vaga custa mais iteração para corrigir do que uma específica. Por exemplo, "criar UploadInvoice.xaml que leia in_FilePath (String), carregue-o para o SharePoint e retorne out_Url (String)" funciona melhor do que "criar algo que carregue arquivos".

Iniciar de um PDD ou SDD

A entrada mais forte para uma automação não trivial é uma especificação estruturada. Um Documento de Design de Processo (PDD) ou Documento de Design de Solução (SDD) já carrega a maior parte do que uma boa solicitação precisa:

• as etapas
• as entradas
• os sistemas envolvidos
• os caminhos de exceção

Entregue isso ao agente, em vez de descrever o processo da memória, produz um primeiro resultado mais próximo com menos idas e vindas.

Para trabalhos maiores, o agente pode transformar um PDD em um SDD e um plano de compilação, e depois trabalhar nele peça por parte, em vez de criar tudo a partir de um documento bruto de uma só vez. Um cuidado: um PDD ou SDD pode conter dados de clientes reais, portanto, removê-los antes que o documento chegue ao agente é importante, pois o agente precisa da estrutura, não dos valores reais.

Planeje primeiro e itere no plano

Seu agente de codificação pode oferecer um modo de plano: antes de alterar qualquer coisa, o agente redigi um plano do que ele pretende fazer, para sua revisão. Um plano leva menos tempo para revisar do que o código; portanto, a iteração nele, corrigindo a abordagem, o layout do arquivo ou a ordem do trabalho, vale a pena antes que uma única linha seja escrita. Aprovar o plano apenas depois que a leitura é correta mantém a compilação no caminho certo e impede que uma arquitetura errada apareça com atraso.

Um plano revisado e acordado é a diferença entre uma sessão guiada e uma que deriva.

O loop gerar, verificar e refinar

A maioria dos trabalhos não trivial é executada em dois ou três ciclos: o agente gera, você verifica e, em seguida, você refina ou regenera. A verificação após cada etapa significativa, em vez de apenas no final, isola o primeiro problema e é mais rápida em geral, mesmo quando parece mais lenta. Para projetos da UiPath, a verificação é concreto: o agente executa o Analisador de Fluxo de Trabalho e a compilação, resolve todos os problemas e confirma uma execução local antes que qualquer coisa seja contada como feita.

Iterar quando	Recomeçar quando
O problema está localizado e você pode nomear a correção	O agente repete variações da mesma saída quebrada
A estrutura está certa	A estrutura em si está errada
Você está dentro de uma correção ou duas	Você está na terceira ou quarta tentativa de correção

Começar do zero não é falha; ele costuma ser o caminho mais rápido. O que você aprende sobre reformulação é carregado para um próximo prompt melhor.

Mantendo o controle

Um agente de codificação pode realizar ações difíceis de desfazer. Algumas regras mantêm o trabalho seguro:

• Vale a pena aprovar explicitamente ações que alteram um sistema compartilhado, como publicar ou implantar no Orchestrator.
• Os segredos ficam fora das solicitações; armazenados como ativos da UiPath ou em um armazenamento de credenciais, eles são referenciados pelo nome.
• Os dados reais do cliente não pertencem a uma solicitação, pois o agente precisa da estrutura, não dos valores.
• Vale a pena revisar cada alteração de pacote, com versões fixadas em project.json.

O agente atua sob a identidade da UiPath com a qual a sessão uip está conectada, carregando as permissões dessa identidade e aparecendo sob ela na trilha de auditoria. Para saber como escolher essa identidade e o que ela significa para sua organização, consulte Governança e confiança. Para o que procurar no trabalho gerado, consulte Revisar e validar a saída.