Opere com o UiPath para agentes de codificação

Um agente de codificação com habilidades UiPath instaladas pode orientar a maioria das tarefas operacionais na UiPath — pastas, trabalhos, filas, ativos, logs de auditoria, conexões e muito mais — por meio de perguntas em linguagem natural. Ele é uip em sua sessão conectada, no escopo do contexto que você fornecer. Esta página abrange o que pedir, o que esperar e onde estão os limites.

Para a configuração (instalação do agente, login, instalação de habilidades), consulte Uso do UiPath CLI com agentes de codificação.

Pré-requisitos

1. Habilidades da UiPath instaladas para seu agente. Consulte Usando o UiPath CLI com agentes de codificação para obter o comando de instalação por agente.
2. Uma sessão conectada (uip login).
3. Acesso à pasta para qualquer que seja o escopo Operar no qual você deseja agir — o agente herda suas permissões.

O que o agente pode fazer

Cada linha agrupa um subdomínio Operar. O agente escolhe os comandos uip or, uip resource, uip solution ou uip is certos das habilidades instaladas — você declara o resultado, não o comando.

Area	O que o agente pode fazer	Exemplo de pergunta
Pastas e acesso	Listar, criar, aninhar, mover, excluir pastas; atribuir usuários e funções	"Adicionar [e-mail] a Finanças como usuário de automação"
Usuários, funções, permissões	Inspecionar concessões de funções, criar/editar/excluir funções, listar permissões, ver quem tem acesso ao que	" Quais pastas [e-mail] tem acesso e com quais funções?"
Licenças	Inspecionar alocações entre usuários e robôs	"Adicionar mais 2 licenças de runtime Unattended ao prod-worker-01"
Máquinas e runtimes	Listar máquinas, inspecionar os runtimes disponíveis em uma pasta	" Quais runtimes estão disponíveis atualmente em produção?"
Sessões	Lista as sessões do UiPath Robot ativas, veja em qual máquina cada uma, desconecte as sessões travadas	"Mostrar todas as sessões não assistidas em execução na produção e por quanto tempo elas estão ativas"
Processos e pacotes	Carregar pacotes, listar versões, criar ou atualizar versões de processos; gerenciar feeds de pacote	"Publicar a versão 2.3.0 do InvoiceBot para Finanças"
Soluções	Publicar, carregar, implantar, ativar; listar versões implantadas em tenants e pastas	"Implantar v1.4 da solução de processamento de faturas para Contabilidade no tenant de preparação"
Trabalhos	Iniciar, parar, monitorar, buscar logs de execução e anexos, agrupar por estado	"Liste todos os trabalhos com falha de ontem na produção e mostre suas mensagens de erro"
Ativos	Listar, obter, criar, atualizar e excluir ativos em pastas	"Copiar todos os ativos da pasta A para a pasta B"
Armazenamentos de Credenciais	Listar, criar, atualizar e excluir integrações de cofre; girar credenciais referenciadas	" Quais ativos em produção ainda fazem referência ao armazenamento antigo do CyberArk?"
Filas e itens de fila	Inspecionar profundidade da fila, enviar itens, status de atualização em massa	" Quais filas têm mais de 100 NovosItens agora?"
Buckets e arquivos de armazenamento	Criar buckets, carregar, baixar, listar, excluir arquivos	"Baixar cada arquivo dos relatórios do bucket/modificados nos últimos 7 dias"
Bibliotecas	Publicar, listar versões, gerenciar versões	"Mostrar todas as versões da biblioteca Email.Utilities no feed do tenant"
Gatilhos	Criar gatilhos de tempo, fila e evento; gerenciar calendários; execuções de lista; inspecionar histórico	"Mostrar as últimas 10 execuções de gatilhos para a solução de integração de RH"
Webhooks	Criar, listar, testar	"Listar todos os webhooks ativos e os eventos que eles escutam"
Conexões do Integration Service	Listar, testar, atualizar e solucionar problemas de tokens OAuth; verificar a integridade da conexão	"Testar todas as conexões do Salesforce em produção e relatar quais estão falhando"
Logs de Auditoria	Filtrar por usuário, componente, ação e intervalo de datas	" Quem excluiu a pasta Finanças no mês passado?"

Leitura versus gravação

O agente trata operações Operate em dois níveis:

• Operações de leitura — list, get, logs, audit-logs e semelhantes. O agente os executa por conta própria.
• Operações de escrita — qualquer coisa que cria, atualiza ou exclui. O agente deve confirmar com você antes da execução.

Informe sua expectativa antecipadamente quando uma pergunta for complexa. Por exemplo: "Limpar pacotes de processos não utilizados, mas mostre-me a lista primeiro."

Autorização e escopo

O agente atua como a sessão uip conectada — ele herda suas permissões exatamente. Se você puder fazer algo na interface do usuário da UiPath com sua conta, o agente pode fazer isso; se você não puder, nem o agente pode.

O agente também respeita o contexto da pasta. As operações direcionam para uma pasta específica, a menos que você diga "entre todas as pastas" ou algo semelhante. Se você alterar as pastas no meio da conversa, confirme o escopo.

Para trabalho de identidade de serviço (CI/CD, auditorias agendadas), faça com que o agente seja executado em uma sessão de App externo — consulte Fluxo 2 em Autenticação.

Padrões comuns de várias etapas

Esses são os padrões em que os agentes de codificação economizam mais tempo — solicitações em várias etapas que, de outra forma, significariam encadear várias invocações de CLI manualmente.

Realizar triagem de trabalhos com falha

"Faça triagem de todos os trabalhos com falha em Produção das últimas 24 horas. Agrupe por mensagem de erro e mostre as cinco principais causas raiz."

O agente lista trabalhos filtrados por estado e período, busca logs para cada um, agrupa por assinatura de erro e apresenta um resumo classificado. Depois, você decide qual tentar novamente.

Promover entre tenants

"Promova a solução de processamento de faturas do tenant de desenvolvimento para o tenant de teste. Implante-o na pasta Contabilidade."

O agente extrai a solução do tenant de desenvolvimento, muda a sessão para o tenant de teste e a implanta na pasta Contabilidade. Ele confirma cada alternância de tenant antes de agir.

Atribuir um usuário à pasta

" [e-mail] como Automation User à pasta Contabilidade e também atribuir a Máquina VM."

O agente atribui o usuário à pasta com a função Automation User e, em seguida, atribui a máquina VM à mesma pasta para que o usuário possa executar trabalhos unattended nela.

Concessões de função de auditoria

"auditar todas as funções atribuídas a usuários externos (qualquer pessoa com um @ fora do nosso domínio) e relatar quais pastas eles podem editar."

O agente lista usuários, filtra por domínio, expande as concessões de funções de cada usuário por pasta e revela um relatório estruturado.

Veja também

• Uso do UiPath CLI com agentes de codificação — configuração do agente e instalação de habilidades.
• Habilidades — o modelo de habilidade que direciona esse comportamento.
• Autenticação — fluxos de sessão, incluindo Apps externos.
• uip ou referência — pastas, usuários, funções, licenças, trabalhos, máquinas, sessões, logs de auditoria, armazenamentos de credenciais.
• referência do recurso uip — ativos, filas, buckets, bibliotecas, gatilhos, webhooks.
• referência da solução uip — empacotar, publicar, implantar, ativar.
• uip é referência — conexões, conectores, atividades do Integration Service.