- Introdução
- Introdução
- Modelagem de processos
- Noções Básicas sobre Modelagem de Processos
- Abertura da tela de modelagem
- Modelagem de seu processo
- Alinhamento e conexão de elementos BPMN
- Autopilot™ para Maestro (pré-visualização)
- Implementação de processos
- Integração de sistemas e dados
- Depuração
- Simulação
- Publicação e atualização de processos agênticos
- Cenários de implementação comuns
- Extração e validação de documentos
- Operações do processo
- Monitoramento de processo
- Otimização de processos
- Informações de referência
Guia do usuário do Maestro
No UiPath Maestro™, os arquivos são gerenciados por meio do Data Fabric (anteriormente chamado de Data Service). Sempre que um arquivo é baixado de uma origem (como um anexo de e-mail ou um provedor de armazenamento em nuvem), o arquivo é carregado em uma entidade no Data Fabric que oferece suporte ao armazenamento de arquivos.
O arquivo é referenciado usando uma referência do Data Fabric, um trio contendo:
- NomedaEntidade
- IdDoRegistro
- NomeDoCampo
Essa referência permite que o arquivo seja usado em qualquer lugar em seu processo com agente.
Pré-requisitos
Antes de usar arquivos no Maestro, certifique-se de que:
- Data Fabric está habilitado em sua organização ou tenant.
- Uma entidade com um campo que dá suporte a arquivos está configurada.
Nenhum campo adicional é necessário além daqueles preenchidos automaticamente pelo Data Fabric quando um registro é criado.
Exemplo de caso de uso
Este exemplo mostra como baixar um arquivo do Box e enviá-lo como um anexo de e-mail.
- Baixe o arquivo
- Configure Enviar tarefa para executar uma atividade de Download de arquivo a partir do conector Box.
- Selecione o arquivo que você deseja baixar.
- Defina a Saída do recurso de arquivo usando o editor de Data Fabric. Escolha a Entidade e o Campo que suportam arquivos.
Quando executada, a atividade retornará uma referência do Data Fabric (EntityName,RecordId,FieldName) apontando para o novo registro de Arquivo no Data Fabric. - Enviar o arquivo por e-mail
- Configure outra Enviar tarefa usando a atividade Enviar e-mail do conector do Outlook.
- Anexe o arquivo referindo-se ao IdDoRegistro da etapa anterior no editor do Data Fabric.
Após o teste, você localizará o IdDoRegistro disponível nas variáveis de fluxo de trabalho.
Também é possível verificar se o arquivo existe no aplicativo Data Fabric pesquisando o IdDoRegistro.
- No Maestro, os arquivos são compatíveis exclusivamente por meio do Data Fabric.
- Se um arquivo já existir no Data Fabric, você pode reutilizá-lo adicionando sua referência no Data Fabric.
Como os agentes funcionam no Maestro
Os agentes são representados nos fluxos de trabalho BPMN do Maestro como tarefas Serviço. Quando seu processo chama uma tarefa Serviço, o Maestro invoca o agente correspondente com os parâmetros de entrada necessários para a instância específica do processo.
Os agentes retornam os dados de saída ao Maestro, que determina os próximos passos no fluxo de trabalho. Você pode configurar agentes para relatar as ferramentas usadas, decisões tomadas e dados de rastreamento para compatibilidade com a depuração e transparência.
Os agentes podem ser:
- Criado diretamente dentro da UiPath Platform (pouco código ou programado)
- Conectado por meio de APIs externas ou Integration Service
- Disparados por meio de eventos ou sinais com base na lógica do fluxo de trabalho
Assista a um exemplo do mundo real: UiPath Maestro: o cérebro por trás da automação de empréstimos transparente e sem interrupções.
Conectando agentes por meio do Integration Service
- Conectores pré-criados para serviços como Salesforce, Microsoft 365 e Google Workspace
- Construtor de conector personalizado para expor qualquer API REST ao UiPath Platform
- Gerenciamento unificado de credenciais e conexões
Use o Integration Service para habilitar o Maestro a enviar/receber dados de agentes ou sistemas não hospedados nativamente no UiPath. Saiba mais sobre o Integration Service.
Usando agentes externos
O Maestro é neutro em relação ao fornecedor. Você pode orquestrar o trabalho em seus AI Agents externos preferidos, sem recriar seus processos, usando os conectores do UiPath Integration Service.
Você pode orquestrar:
- Serviços de IA proprietários
- Mecanismos de decisão externos
- Microsserviços ou bots hospedados em outras plataformas
O Maestro invoca esses agentes chamando endpoints REST e espera uma carga de resposta com dados estruturados.
Conexão de agentes externos por meio do Integration Service
No período de projeto, adicione uma Tarefa de serviço, escolha Iniciar e aguardar o agente externo e configure a atividade do agente a partir do conector selecionado. No runtime, o Maestro envia a solicitação e o contexto para o agente e aguarda a resposta. Você mapeia essa resposta para variáveis a fim de direcionar gateways, atribuições e ações subsequentes.
Inícios rápidos: integrações de fluxos de trabalho de APIs
Prefira os conectores do Integration Service quando eles existirem. Use fluxos de trabalho de APIs quando você precisar de conectividade no nível de API (APIs iniciais, esquemas em evolução ou respostas por transmissão). Defina solicitações e saídas de forma declarativa, analise JSON sem código personalizado e passe os resultados para seu processo do Maestro.
- Conector: sistema compatível, esquema estável, autenticação gerenciada, melhor escolha a longo prazo.
- Fluxo de trabalho de API: API nova ou não compatível, alteração de formas de resposta ou saída apenas de transmissão.
- Snowflake Cortex - Fluxo de trabalho de API: lide com a saída de transmissão do Cortex Agent, monte-a em uma resposta utilizável e retorne JSON estruturado para automação posterior.
- Databricks Genie - Fluxo de trabalho da API: inicie uma conversação, pesquise o status da mensagem até CONCLUÍDO, extraia o SQL gerado (attachment_id), execute-o e retorne a resposta.
Configuração de propriedades do agente
No Maestro, os agentes são tratados como participantes de um processo de negócios. Dentro de um fluxo de trabalho BPMN, os agentes são representados usando tarefas Serviço, que podem invocar agentes hospedados pela UiPath ou agentes externos. Cada tarefa do agente pode ser configurada com parâmetros de entrada e saída específicos, que permitem que o Maestro passe dados sensíveis ao contexto para o agente e receba resultados estruturados em troca.
Consulte Tarefas na modelagem BPMN para obter uma visão geral das tarefas Serviço no Maestro.
Modos de execução do agente
O comportamento do agente é definido no painel Propriedades de uma tarefa Serviço. Você pode configurar a tarefa para chamar um agente da UiPath ou um agente externo, dependendo de suas necessidades de negócios.
Iniciar e aguardar o agente
Use essa opção para invocar um agente implantado em seu locatário UiPath. Isso inclui:
- Agentes de pouco código criados usando ferramentas como o Agent Builder.
- Agentes codificados desenvolvidos em Python ou outras linguagens e implantados no Orchestrator.
Iniciar e aguardar o agente externo
Use esta opção para se conectar a sistemas de terceiros ou externos. Você deve especificar:
- Conector: o destino da integração (por exemplo, CrewAI, Salesforce ou outro serviço)
- Conexão: uma instância configurada do conector, representando um agente específico ou um conjunto de credenciais específico do contexto.
Observação: você pode usar o mesmo agente com diferentes permissões ou comportamentos, definindo várias conexões.
Entradas e saídas
As entradas e saídas para agentes são configuradas da mesma forma que outros tipos de tarefas do Maestro.
- Entradas: variáveis ou expressões passadas ao agente no runtime.
- Saídas: variáveis preenchidas pela resposta JSON do agente.
{
"key1": "value1",
"key2": "value2"
}{
"key1": "value1",
"key2": "value2"
}
O agente deve retornar uma resposta JSON usando os mesmos nomes de parâmetros esperados pelo Maestro. Esses valores são mapeados para variáveis de processo utilizando a seção Saída > Resposta no painel Propriedades da tarefa.
Exemplos de entrada e saída
Exemplos de entradas (do Maestro para o agente):
| Parâmetro | Description |
|---|---|
role | Função ou contexto para a tarefa (por exemplo, validação versus sumarização). |
prompt | Instruções fornecidas ao agente, muitas vezes incluindo dados específicos do processo |
tools | Lista de ferramentas que o agente pode usar para concluir a tarefa |
user_id | Identificador exclusivo compartilhado entre o processo e o contexto do agente |
Exemplo de prompt:"Conclua a validação do empréstimo para {loan_application_number}. Responda no formato JSON usando o parâmetro 'loan_application_status'."
Exemplos de saída (do agente para o Maestro)
| Parâmetro | Description |
|---|---|
conversation_id | Referência à sessão de diálogo ou interação |
loan_application_status | Resultado de status retornado pelo agente |
tokens_used | Metadados sobre o uso de recursos |
Regras de negócios permitem que os desenvolvedores de RPA armazenem e gerenciem arquivos do Modelo de Decisão e Notation (DMN) como parte de um fluxo de trabalho ou diagrama de processo.
Regras de negócios no Orchestrator
As regras de negócios no Orchestrator permitem armazenar e gerenciar regras baseadas no Modelo de Decisão e Notação (DMN). É possível avaliar essas regras dentro de qualquer processo com agente, usando uma atividade dedicada. Além disso, você pode modificar as regras sem precisar reimplantar os processos que as utilizam. Isso facilita a atualização e a manutenção dinâmica da sua lógica de negócios.
No Orchestrator, usamos o seguinte conjunto de recursos para armazenamento e gerenciamento:
- Armazene arquivos de DMN com acesso baseado em funções para usuários e robôs.
- Controle de versão
- Vinculação de regras de negócios a pastas
- Marcações de etiquetas
Para executar Regras de Negócios, o Maestro inclui uma nova tarefa de Regras de Negócios que suporta o DMN v1.3.
Acesso a versões de Regras de Negócios
Para acompanhar suas Regras de Negócios, use o campo Versão. Após salvar a regra de negócios com o arquivo DMN carregado, você não pode mais alterar sua versão.
Você pode visualizar a versão de uma regra de negócios na página Regras de negócios. Para verificar a versão, selecione uma Regra de Negócios e, em seguida, edite a Regra de Negócios ou acesse Mais Ações e selecione Exibir versões.
- Depois de carregar o arquivo DMN durante a criação da Regra de negócios, selecione o ícone de download localizado ao lado do arquivo.
- Na página Regras de negócios, na Regra de negócios desejada, selecione Mais ações e depois Fazer download da versão. Alternativamente, em Mais ações, selecione Exibir versões. Um painel lateral abre onde você pode selecionar o ícone de download ao lado da versão que você deseja baixar.
Links de regras de negócios
- Na página Regras de negócios, selecione Adicionar regra de negócios e, em seguida, Vincular de outras pastas.
- Em seguida, a página Importar regra de negócios exibe uma lista de todas as Regras de negócios de outras pastas.
- Selecione uma ou mais Regras de negócios para adicionar à pasta atual e, em seguida, Continuar e, então, Vincular.
- Na página Regras de negócios, selecione uma regra de negócios, acesse Mais ações e selecione Gerenciar links.
- Na próxima janela, selecione uma ou mais pastas nas quais adicionar uma Regra de negócios ou desmarque pastas para remover uma Regra de negócios.
- Selecione Atualizar.
Execução de uma Regra de negócios.
Antes de executar uma Regra de negócios, certifique-se de que:
- Modelou um arquivo DMN com a ajuda de um editor compatível com DMN.
- Criou uma nova Regra de negócios no Orchestrator ao carregar o arquivo DMN.
- Para executar uma Regra de Negócios, abra um processo do Maestro
- Adicione ao seu processo uma tarefa de Regra de negócios.
- Selecione o arquivo DMN armazenado no Orchestrator como a Regra de negócios.
- Mapeie argumentos de entrada e saída de acordo com como o arquivo DMN é modelado.
Edição de uma Regra de negócios
Para editar uma regra de negócios, você precisa de permissões para Editar nas Regras de negócios.
- Na página Regras de negócios, selecione uma Regra de negócios, acesse Mais ações e selecione Editar.
- Em seguida, você pode editar os seguintes campos: Nome, Descrição, Rótulos, Propriedades e Arquivo.
Observação: após salvar a Regra de negócios com o arquivo DMN carregado, você não pode mais alterar sua versão.Observação: certifique-se de que os nomes de argumentos consistam apenas em letras, números e o caractere sublinhado.Os nomes devem começar com uma letra ou o caractere sublinhado.
- Selecione Atualizar.
Remoção de uma Regra de negócios
Para remover uma Regra de negócios, você precisa de permissões Excluir em Regras de negócios.
- Na página Regras de negócios, selecione uma Regra de negócios.
- Em seguida, acesse Mais ações.
- Selecione Remover.
Visão geral
Os Apps de processo fornecem aos usuários de negócios painéis baseados em função, formulários e hubs de triagem para gerenciar as operações cotidianas. Eles habilitam a visibilidade em tempo real da integridade do processo, ajudando os usuários a identificar atrasos, ineficiências e escalonamentos, tudo em um espaço de trabalho unificado entre agentes, robôs e pessoas.
Com o Process Apps, as equipes podem:
- Resolva atrasos e violações de SLA com contexto em tempo real e decisões guiadas.
- Faça escolhas mais inteligentes de recursos para melhorar a eficiência operacional.
- Gere soluções mais rápidas de problemas e melhores resultados de negócios em toda a organização.
Os aplicativos de processo combinam a orquestração de processos do Maestro e o desenvolvimento de aplicativos de pouco código da UiPath®, dando às equipes de operações insights acionáveis sem alternar entre sistemas.
Pré-requisitos
- UiPath Automation Cloud™
- UiPath Maestro™
Introdução
| Recurso | Description |
|---|---|
| GitHub do SDK | Documentação do SDK do UiPath TypeScript |
| Exemplo de aplicativo React | Exemplo de aplicativo de processo |
| Pacote NPM | SDK de TypeScript da UiPath |
Exemplo de casos de uso
- Painéis de classificação: rastreie incidentes de processo e aja em relação aos escalonamentos diretamente de um console de operações.
- Gerenciamento de casos e SLA: monitore SLAs, identifique violações e acione processos de recuperação.
- Operações com intervenção humana: forneça formulários contextuais para aprovações, correções ou tratamento de exceções.
Integração com o Maestro
Os Aplicativos de processo conectam-se ao processo do Maestro e aos dados de incidente para fornecer informações em tempo real sobre as execuções em andamento. Como um usuário comercial, você pode monitorar instâncias, acompanhar KPIs e realizar ações em tarefas em uma única interface, sem ferramentas de desenvolvedor.
Exemplo: um aplicativo de processos do Finance Operations pode exibir aprovações de faturas atrasadas do Maestro e permitir que os usuários aprovem ou reatribuam tarefas diretamente, sem sair do aplicativo.
- Gerenciamento de arquivos com o Data Fabric
- Pré-requisitos
- Exemplo de caso de uso
- Usando agentes no Maestro
- Como os agentes funcionam no Maestro
- Conectando agentes por meio do Integration Service
- Usando agentes externos
- Conexão de agentes externos por meio do Integration Service
- Inícios rápidos: integrações de fluxos de trabalho de APIs
- Configuração de propriedades do agente
- Regras de negócios (pré-visualização)
- Regras de negócios no Orchestrator
- Apps Process (pré-visualização)
- Visão geral
- Pré-requisitos
- Introdução
- Exemplo de casos de uso
- Integração com o Maestro
