Repetir trabalho com Rotinas

Crie, gerencie e execute rotinas no Delegate para salvar fluxos de trabalho de tarefas reutilizáveis e executá-los com um único clique.

Rotinas são fluxos de trabalho reutilizáveis que você pode executar com um único clique. Eles capturam padrões de trabalho que você executa repetidamente, permitindo que você automatize tarefas comuns sem recriá-las a cada vez.

O que é uma rotina?

Uma rotina é uma sessão do Delegate salva que foi empacotada para reutilização. Ao contrário de uma conversa única, uma Rotina:

• Tem uma descrição clara do gatilho que explica quando usá-lo
• Aceita entradas (parâmetros) que variam a cada execução
• Produz uma saída consistente (documento, relatório, atualização etc.)
• Aparece na sua barra lateral para acesso com um clique
• Pode ser compartilhado com colegas de equipe

Pense nas Rotinas como sua biblioteca de automação pessoal — fluxos de trabalho que você projeta uma vez e executa sempre que necessário.

Quando criar uma rotina

Crie uma Rotina quando você se encontrar:

• Asking Delegate for the same type of task weekly (e.g., "Prepare my Monday morning brief")
• Seguir um processo consistente com dados variáveis (por exemplo, "Gerar um relatório de status a partir deste projeto do Jira")
• Compartilhar um fluxo de trabalho com colegas de equipe que precisam realizar a mesma tarefa
• Querer agendar a automação para ser executada em horários específicos

Criando uma rotina

Há três maneiras de criar uma rotina:

Método 1: salve uma sessão bem-sucedida

Para salvar uma sessão bem-sucedida como uma Rotina, siga as seguintes etapas:

1. Conclua uma sessão Delegate que produza o resultado que você deseja reutilizar.
2. Selecione Salvar como rotina (aparece nas opções de conversa).
3. Delegate analisa a sessão e sugere:
   • Um nome para a rotina
   • Parâmetros de entrada (o que varia a cada vez)
   • O formato de saída
4. Revise e edite a configuração sugerida:
   • Nome: algo descritivo (por exemplo, "Relatório de vendas semanal")
   • Gatilho: quando usar (por exemplo, "Quando você precisa de um resumo dos dados de vendas semanais")
   • Entradas: quais informações são necessárias (por exemplo, "Data de término da semana", "Caminho da planilha de vendas")
   • Saída: o que a Rotina produz (por exemplo, "A apresentação do PowerPoint com gráficos")
5. Selecione Salvar.

A Robô agora aparece na sua barra lateral em Rotinas.

Método 2: criar do zero

Para criar uma Rotina do zero, siga as seguintes etapas:

1. Abra Configurações → Rotinas (ou use o menu da barra lateral).
2. Selecione Criar rotina.
3. Preencha a configuração:
   • Nome: o nome de exibição em sua barra lateral
   • Descrição: o que essa rotina faz
   • Gatilho: descrição em linguagem natural de quando usá-lo
   • Entradas: defina parâmetros com nomes, tipos e descrições
   • Etapas: descreva o que Delegate deve fazer (ou cole uma transcrição de sessão bem-sucedida)
4. Selecione Salvar.

Método 3: editar um arquivo SKkill.md

Esse método é para usuários confortável com o Markdown e a configuração do sistema de arquivos.

1. Localize seu diretório LocalSkills:
   • MacOS: ~/Library/Application Support/UiPath/Delegate/LocalSkills/
   • Windows: %APPDATA%/UiPath/Delegate/LocalSkills/
2. Crie uma nova pasta para sua Rotina (por exemplo, my-routine/).
3. Crie SKILL.md dentro da pasta com a definição de Rotina.
4. Reiniciar Delegate ou atualizar habilidades em Configurações.

Estrutura de SKkill.md

---
name: my-routine
friendly_name: Weekly Sales Report
version: 1.0.0
description: "Generates a weekly sales summary from spreadsheet data"
icon: FaChartBar
color: "3B82F6"
trigger: "When you need a summary of weekly sales performance"
inputs:
  - name: week_ending
    type: date
    description: "The last day of the week to report on"
  - name: data_file
    type: file
    description: "Path to the sales data spreadsheet"
output:
  type: file
  description: "PowerPoint presentation with sales charts"
---

## Steps

1. Read the sales data from {data_file}
2. Filter for the week ending {week_ending}
3. Calculate total sales, top products, and regional breakdown
4. Create a PowerPoint with:
   - Title slide: "Weekly Sales Report - {week_ending}"
   - Summary slide with key metrics
   - Chart slide showing product performance
   - Regional breakdown table
5. Save as "Sales_Report_{week_ending}.pptx" on the Desktop

Execução de uma rotina

Da barra lateral

Para executar uma Rotina a partir da barra lateral, siga os seguintes passos:

1. Procure a seção Rotinas na barra lateral esquerda.
2. Selecione a Rotina que você deseja executar.
3. Delegate solicita todas as entradas necessárias.
4. Revise o plano (se estiver no modo Guiado).
5. A rotina executa e produz a saída.

Ao mencioná-lo

Em qualquer conversa, faça referência à rotina pelo nome:

Run the Weekly Sales Report for last week using the file in ~/Documents/Sales/

Delegate reconhece o nome da rotina e o executa com seus parâmetros especificados.

Via atalho de teclado

Para executar uma rotina usando um atalho de teclado, siga as seguintes etapas:

1. Pressione seu atalho configurado (por exemplo, Cmd+Shift+1).
2. A rotina é executada imediatamente (ou solicita entradas).

Atribua atalhos em Configurações → Atalhos de teclado.

Gerenciamento de rotinas

Marcando como favorito

Fixe as rotinas usadas com frequência na parte superior da sua barra lateral:

1. Encontre a Rotina na barra lateral.
2. Selecione o ícone de estrela (ou abra o menu de contexto → Adicionar a Favoritos).
3. A Rotina é movida para a seção Favoritos .

Editando

Atualize uma rotina à medida que suas necessidades mudam:

1. Abra o menu de contexto para a Rotina na barra lateral → Editar.
2. Ou acesse Configurações → Rotinas → encontre a Rotina → Editar.
3. Modifique nome, descrição, entradas ou etapas.
4. Salvar alterações.

Observação: Editar uma rotina não afeta execuções passadas — apenas execuções futuras.

Duplicando

Crie uma variação de uma rotina existente:

1. Abra o menu de contexto para a Rotina → Duplicar.
2. Uma cópia aparece com &co;(Cópia); no nome.
3. Edite a cópia para personalizar.

Excluindo

Remova uma rotina que não é mais necessária:

1. Abra o menu de contexto para a Rotina → Excluir.
2. Ou acesse Configurações → Rotinas → Excluir.
3. Confirme a exclusão.

Agendamento de rotinas

Executar rotinas automaticamente em um agendamento:

Configurando um agendamento

Para configurar um agendamento para uma Rotina, siga as seguintes etapas:

1. Vá para Configurações → Rotinas → encontre sua rotina.
2. Selecione Agendamento.
3. Configure:
   • Frequência: Uma vez, Diário,Semanal,Mensal
   • Hora: quando executar (seu horário local)
   • Entradas: valores fixos ou "solicitação no runtime"
4. Salve o agendamento.

Opções de agendamento

A tabela a seguir descreve as opções de agendamento disponíveis.

Opção	Description
Executar em segundo plano	Execute sem roubar foco (recomendado para execuções agendadas)
Notificar após conclusão	Mostrar uma notificação quando terminar
Na falha	Tente novamente, notifique ou pare se a Rotina falhar
Manuseio de entrada	Use os últimos valores, solicite no vencimento ou ignore se as entradas estiverem ausentes

Gerenciamento de rotinas agendadas

Exibir e gerenciar todas as Rotinas agendadas:

1. Configurações → Rotinas → guia Agendado .
2. Veja as próximas execuções, o status da última execução e o histórico.
3. Habilitar/desabilitar agendamentos individuais.
4. Edite ou exclua agendamentos.

Observação: as rotinas agendadas são executadas usando suas conexões e permissões armazenadas. Se a autenticação expirar, a Rotina pode falhar até você se reconectar.

Compartilhamento de rotinas

Compartilhe rotinas com colegas de equipe ou com a comunidade Delegate em geral:

Exportar uma rotina

Para exportar uma rotina para compartilhamento ou backup, siga as seguintes etapas:

1. Abra o menu de contexto para a Rotina → Exportar.
2. Ou acesse Configurações → Rotinas → Exportar.
3. Escolha o formato:
   • Arquivo ZIP: pasta de rotina completa (SKkill.md + quaisquer recursos)
   • Apenas SKkill.md: apenas o arquivo de definição
4. Salve no local desejado.

Compartilha com uma equipe

Para compartilhar uma rotina com sua equipe, siga as seguintes etapas:

1. Exporte a rotina como um ZIP.
2. Compartilhe por meio de seus canais normais (email, Slack, unidade compartilhada).
3. Os destinatários são importados por meio de Configurações → Rotinas → Importar.

Publicar em um feed do Marketplace

Para publicar uma rotina em um feed do Marketplace, siga as seguintes etapas:

1. Certifique-se de que sua rotina siga o formato SKkill.md.
2. Entre em contato com o administrador do UiPath sobre o feed do Skill Marketplace da sua organização.
3. Envie a Rotina para o URL do feed.
4. Os membros da equipe podem localizá-lo e instalá-lo por meio do Delegate Armazenamento.

Observação: a publicação em marketplaces públicos requer revisão e aprovação da UiPath.

Melhores práticas de rotina

Projete para clareza

• Nomeie descritivamente: "Relatório de vendas semanal" e não "Relatório 1"
• Escrever gatilhos claros: explique quando alguém deve usar essa Rotina
• Entradas do documento: explique para que é cada parâmetro e o formato esperado
• Especificar saídas: descreva o que o usuário receberá

Identificar variabilidade

• Use parâmetros de entrada para qualquer coisa que mude (datas, caminhos de arquivos, nomes)
• Forneça padrões sensíveis quando possível
• Validar entradas nas etapas de rotina (por exemplo, "Verificar se o arquivo existe")
• Lide com entradas ausentes de forma graciosa com comportamento de fallback

Testar cuidadosamente

• Execute primeiro no modo guiado para capturar etapas inesperadas
• Teste com casos extremos (arquivos vazios, datas futuras, caracteres especiais)
• Verifique se as saídas correspondem às expectativas antes de compartilhar
• Teste em máquinas diferentes se estiver compartilhando com uma equipe

Controle da versão

• Duplicar antes de grandes alterações para preservar as versões de trabalho
• Documente alterações na descrição da rotina ou um Changelog
• Use o controle de versão semântico no SKkill.md (1.0.0, 1.1.0, 2.0.0)

Considerações de segurança

• Não insira credenciais codificadas em etapas de Rotulagem — use conexões
• Cuidado com caminhos de arquivo— use caminhos relativos ou parâmetros de entrada
• Revise as permissões antes de compartilhar: certifique-se de que os destinatários tenham acesso aos sistemas necessários
• Limpar entradas que entram em comandos do shell ou URLs

Avançado: armazenamento de rotina

As rotinas são armazenadas como arquivos em sua máquina:

LocalSkills/
├── my-routine/
│   ├── SKILL.md          # Routine definition
│   ├── references/       # Optional: supporting files
│   └── examples/         # Optional: example inputs/outputs
└── another-routine/
    └── SKILL.md

Você pode:

• Faça backup das suas rotinas copiando a pasta LocalSkills
• Sincronize entre máquinas colocando LocalSkills no armazenamento em nuvem (Dropbox, OneDrive)
• Controle de versão inicializando a pasta como um repositório Git

Observação: se você sincronizar LocalSkills, tenha cuidado com caminhos absolutos em Rotinas — eles podem não funcionar em máquinas diferentes.

Próximas Etapas

Saiba como:

• Compartilhe o trabalho com o Delegate Store — Encontre rotinas e habilidades pré-construídas
• Revise a referência de Configurações — Configurar armazenamento e agendamento de rotinas
• Crie sua primeira Rota a partir de uma sessão do Delegate bem-sucedida e recente