cartographer
latest
false
Guia do usuário do Cartographer
- Visão geral
- Instalação e configuração
- Introdução
- A interface do Cartographer
- Suas primeiras tarefas do Cartographer
- Trabalhando com automações existentes
- Documentação COMO ESTÁ (Processo atual)
- Fornecimento de documentos ao Cartográfico
- Como delegar uma tarefa
- Design TO-BE e geração de PDD
- Refinando seu PDD e a lista de verificação de qualidade
- Geração de um SDD
- Enviando SDDs para o Automation Hub
- Confiança e conformidade
- Governança
- Recursos
- Referência
- Solução de problemas
- Solução de problemas
- Compartilhar feedback com a UiPath
- Backup e restauração
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
Solução de problemas
Solutions for common Cartographer issues, including screen context errors, permission problems on macOS and Windows, business process issues, and connectivity or tool integration failures.
Esta página é sua única referência para resolver problemas no Cartographer.
Configuração e instalação
| O que você vê | Causa | Solução |
|---|---|---|
| Não consigo ver meus aplicativos | O contexto da tela está definido como Nenhum | Defina-o como algo diferente de Nenhum, no ícone de tela ao lado da caixa de chat. |
| Não consigo ver meus aplicativos | On macOS, the screen recording or accessibility permission wasn't granted | Grant it from Settings → Permissions. Reinicie o Cartographer. |
| O Cartographer diz que não pode acessar um site | No internet connection | Verifique sua conexão. |
| O Cartographer diz que não pode acessar um site | Uma rede corporativa está bloqueando os serviços de IA | Pergunte ao seu departamento de TI se você suspeita disso. |
| O Cartographer diz que não pode acessar um site | O problema é específico de um site | Tente um site diferente para isolá-la. |
| A extensão do navegador não foi detectada | A extensão não está instalada ou habilitada | Confirme se ele está instalado e habilitado. No Chrome, chrome://extensions. |
| A extensão do navegador não foi detectada | O navegador ainda não o selecionou | Reinicie seu navegador após instalá-lo. |
| Não consigo entrar | As credenciais da sua conta estão erradas | Verifique as credenciais da sua conta da UiPath. |
| Não consigo entrar | Sua organização usa SSO | Certifique-se de que você esteja na rede corporativa ou na VPN. |
| Não consigo entrar | O tenant errado foi selecionado | Confirme se o tenant correto está selecionado. |
Tarefas e prompts
| O que você vê | Causa | Solução |
|---|---|---|
| Cartographer não entendeu o que eu queria | A solicitação era ampla demais ou ambígua | Divida-o em etapas menores. Seja mais explícito sobre o objetivo e o formato. Dê um exemplo da saída que você deseja. |
| Ele começou a fazer algo que não esperava | Ele está atuando com base em uma leitura incorreta da sua solicitação | Pressione Esc para parar. Pergunte "O que você está tentando fazer?" para ver seu raciocínio. Redirecionar com uma instrução mais clara. |
| A tarefa está demorando muito. | Você está no modo de segundo plano, que é mais lento, mas não bloqueia | Peça uma atualização de status. Divida uma tarefa complexa em partes menores. |
| Ele continua pedindo confirmação | Você está no modo guiado, que deve ser confirmado antes de cada etapa | Alterne para o modo Autônomo para fluxos de trabalho confiáveis e repetitivos. Ou revise suas configurações de Segurança para alterar o que dispara a confirmação. |
Segurança e permissões
| O que você vê | Causa | Solução |
|---|---|---|
| Cartographer diz que não tem permissão | A categoria da ferramenta relevante está desabilitada | Verifique as permissões de ferramentas para essa categoria. |
| Cartographer diz que não tem permissão | O aplicativo ou site está em Aplicativos/sites bloqueados ou o caminho corresponde a uma categoria de Arquivos protegidos | Consulte Automação de Interface Gráfica. Consulte Arquivos protegidos. |
| Cartographer diz que não tem permissão | Você não tem certeza de qual controle está negando | Alterne para o modo Categorizado temporariamente para ver a rejeição específica. |
| Aprovei uma ação, mas ela ainda falhou | A solicitação UAC do Windows não foi realmente aceita | Confirme se foi aceito. |
| Aprovei uma ação, mas ela ainda falhou | On macOS, the screen recording or accessibility permission wasn't granted | Check Settings → Permissions to confirm it's enabled. |
| Aprovei uma ação, mas ela ainda falhou | O aplicativo ou site está em Aplicativos/sites bloqueados ou o caminho corresponde aos Arquivos protegidos | Verifique ambos em Configurações de segurança. |
| Aprovei uma ação, mas ela ainda falhou | O problema real não está relacionado às permissões (rede, autenticação) | Leia a mensagem de erro completa antes de supor que é um problema de permissão. |
| Quero permitir um site bloqueado | Está listada individualmente em Sites bloqueados | Remova-o em Automação de interface gráfica. |
| Quero permitir um site bloqueado | Foi adicionada como parte de uma categoria (Banco, Pagamentos, Criptografia, Gerenciador de Senhas, Governo, Saúde) | Remova-o dessa categoria em Automação de interface gráfica. |
| Quero permitir um site bloqueado | A configuração está bloqueada e é exibida como gerenciada pela sua organização | Pergunte ao seu administrador — ela é aplicada por meio do Automation Ops e não pode ser alterada localmente. |
| Uma habilidade continua pedindo permissões que já concedi | Na verdade, ele está solicitando uma permissão diferente da anterior | Verifique o que está sendo solicitado desta vez. |
| Uma habilidade continua pedindo permissões que já concedi | A permissão tem o escopo de sessão | Aprove-o novamente para a nova sessão. |
Conexões
| O que você vê | Causa | Solução |
|---|---|---|
| Falha na conexão ou um erro de autenticação | A conexão expirou ou foi revogada | Reconecte-se em Complementos e integrações → Conexões. |
| Falha na conexão ou um erro de autenticação | A reconexão não corrige o problema. | Desconecte e recrie a conexão. Verifique as configurações do aplicativo de terceiros do próprio serviço. |
| "Nenhuma conexão encontrada para <service>o <service"gt;" | O serviço ainda não foi conectado | Crie a conexão em Complementos e integrações → Conexões. Ou siga uma abordagem que não precise dele. |
| A conexão existe, mas não tem as permissões necessárias | Foi criada com escopos mais restritos do que as necessidades da ação | Desconecte e reconecte, concedendo os escopos adicionais quando solicitado. |
| A conexão existe, mas não tem as permissões necessárias | Uma política da organização restringe escopos | Verifique com seu administrator. |
| O servidor MCP não conecta | O servidor está inoperante ou inacessível | Confirme se está em execução (local) ou acessível (remota). |
| O servidor MCP não conecta | O URL ou o comando tem um erro de digitação | Verifique o URL. Teste o ponto de extremidade diretamente. |
| O servidor MCP não conecta | Um firewall está bloqueando-o | Verifique as configurações de firewall. Revise os logs de processo locais para um erro de inicialização. |
| O servidor MCP se conecta, mas não tem ferramentas disponíveis | Não foi registrado nenhum ferramenta ou elas falharam ao inicializar | Verifique a documentação e as variáveis de ambiente do próprio servidor. Reinicie-o. |
| Falha na chamada da ferramenta MCP | O servidor recebeu a solicitação, mas não pôde executá-la | Verifique o erro específico no cartão da ferramenta. Confirme se os parâmetros necessários foram fornecidos. Confirme que o recurso subjacente (arquivo, banco de dados, API) é acessível. |
Rotinas
| O que você vê | Causa | Solução |
|---|---|---|
| Rotina não encontrada | Ele foi removido ou você está procurando no lugar errado | Consulte a seção Rotinas da barra lateral. |
| Rotina não encontrada | Foi importada de um arquivo que não está mais disponível | Importar novamente a partir do arquivo original. |
| Entrada obrigatória não encontrada | Um parâmetro não foi fornecido durante a execução | Preencha cada entrada solicitada. |
| Entrada obrigatória não encontrada | Uma execução agendada não tem valor para uma entrada necessária | Defina um valor fixo para ele. Ou edite a rotina para dar a ela um padrão sensível. |
| Falha parcial da rotina | Não foi possível concluir uma ação na rotina | Verifique o erro no cartão da ferramenta. Confirme se todos os arquivos de entrada ainda existem e estão acessíveis. |
| Falha parcial da rotina | Uma conexão necessária não está mais ativa | Reconecte-o. Tente novamente. |
| Falha parcial da rotina | É difícil saber onde está falhando | Execute no modo Guiado para ver exatamente onde ele para. |
| A rotina agendada não foi executada | O Cartographer não estava sendo executado no horário agendado | Verifique se a máquina não estava suspensa — os agendamentos não são executados durante o modo de repouso. |
| A rotina agendada não foi executada | Uma conexão da qual ele depende expirou | Verifique seu status de execução e histórico em Rotinas agendadas na barra lateral. Reconecte se necessário. |
Habilidades e complementos
Para problemas específicos de publicação, instalação e revisão, consulte Habilidades de publicação, instalação e revisão abaixo.
| O que você vê | Causa | Solução |
|---|---|---|
| Uma habilidade não é instalada | Sem conexão com a Internet ou sem espaço em disco suficiente | Verifique sua conexão. Libere espaço em disco. Tente novamente. |
| Uma habilidade não é instalada | Cartographer está desatualizado | Atualize o Cartographer. |
| Uma habilidade não é instalada | Ainda falha | Entre em contato com o editor. |
| Uma habilidade instalada não aparece | Está desabilitado | Verifique seu estado em Complementos e integrações → Habilidades. |
| Uma habilidade instalada não aparece | Cartographer ainda não o removeu | Reinicie o Cartographer. |
| Uma habilidade instalada não aparece | Os arquivos não chegaram onde esperado | Verifique os locais dos arquivos de configurações para a pasta de habilidades locais. |
| Uma habilidade falha quando tento usá-la | Não há uma conexão da qual dependa | Crie-o a partir de Complementos e integrações → Conexões. |
| Uma habilidade falha quando tento usá-la | Não há uma permissão de ferramenta da qual ele dependa | Habilite a categoria de ferramenta em Permissões de ferramenta. |
| Uma habilidade falha quando tento usá-la | Você está usando uma versão desatualizada da habilidade | Atualize para a versão mais recente. |
| Um repositório ou feed compartilhado não será carregado | A origem é inacessível ou configurada incorretamente | Verifique se está correto e acessível — consulte Origens de repositório. |
| Um repositório ou feed compartilhado não será carregado | Um firewall está bloqueando a conexão | Verifique as configurações de firewall. |
| Um repositório ou feed compartilhado não será carregado | A origem em si está inativa | Entre em contato com quem o administrada. |
Publicar, instalar e revisar habilidades
Agrupados por onde você está no fluxo — consulte Compartilhar habilidades com sua equipe para obter os procedimentos completos. Muitas vezes, a causa não é o que a mensagem na tela sugere.
Tentando publicar
| O que você vê | Causa | Solução |
|---|---|---|
| Nenhum botão Publicar , apenas Enviar para revisão | Você não tem Libraries.Create e nada na tela diz isso | Você está no caminho de envio para revisão. Obtenha a permissão ou peça que alguém com ela aprove seu envio. |
| Os botões permanecem desabilitados, o rodapé solicita os campos obrigatórios | Função ou Tipo ainda está vazio — ambos começam em branco | Defina as duas listas suspensas. O rodapé muda para a linha de escolha de publicação assim que são válidos. |
| "A publicação de habilidades não está habilitada para este tenant…" | A configuração de Implantação do seu tenant é Apenas feed de host — não há feed de tenant para publicar | Um administrador define Feeds para feeds de host e tenant e salva. |
| Erro 1691 | A mesma configuração em um Orchestrator mais antigo em que é uma caixa de seleção | Ative os uploads de bibliotecas. Em vez disso, não procure funções. |
| "Você não tem permissão para publicar. Entre em contato com o administrador. | O Orchestrator recusou o próprio upload; a função é realmente insuficiente, qualquer que seja o botão oferecido | Corrija a função. A exibição do botão é apenas uma dica, não uma garantia. |
| A versão 1.0.0 já existe. Use um número de versão superior.> | As versões só avançam | Aumente o número da versão. |
Navegação e instalação
| O que você vê | Causa | Solução |
|---|---|---|
| Catálogo vazio, sem erro | Geralmente um problema de conexão — o catálogo é o feed do tenant | Verifique se há um banner offline primeiro. Confirme que você segura Libraries.View. |
| "Mostrando apenas habilidades instaladas" | Não foi possível ler o feed, então o Cartographer foi o que está no disco | Tente novamente. Verifique sua rede e sua permissão. |
| Uma habilidade instalada não tem efeito neste chat | As alterações de habilidade e rotina se aplicam apenas a novas conversas | Inicie uma nova tarefa. |
| Uma habilidade que você criou manualmente nunca aparece | Cartographer verifica sua pasta de habilidades na inicialização, e as habilidades de sincronização atualizam apenas as habilidades da nuvem | Reinicie o Cartographer. Se ainda não aparecer, verifique se está na pasta correta. |
Revisão e organização cruzada
| O que você vê | Causa | Solução |
|---|---|---|
| "Não foi possível conectar." Verifique sua rede e tente novamente. ao enviar para revisão | Pode significar que a solicitação atingiu o back-end e falhou lá (por exemplo, o armazenamento do pacote em estágio não pôde autenticar). Esta mensagem aborda qualquer falha no caminho de envio, não apenas a conectividade | Descarte o back-end antes de supor que é sua rede. |
| Nenhuma faixa de fila de revisão | Essa faixa é renderizada apenas para as pessoas que têm a permissão de publicação | Esperado se você for um remetente, não um revisor. |
| Envio travado no estado Pendente | Nada com a permissão ainda não olha para a fila — não há lembretes ou SLA | Perseguida, uma pessoa diretamente. Certifique-se de que alguém seja o proprietário da fila. |
| Não há opção "Publicar também em …" Caixa de seleção em qualquer lugar | Nenhum feed compartilhado está configurado para seu ambiente | Nada para corrigir — isso é esperado sem um feed compartilhado. |
| "Peça a um administrador do Orchestrator para adicionar este pacote ao seu feed do Orchestrator"." | Sua organização não permite a instalação diretamente de feeds compartilhados | Em vez disso, use Solicitar para adicionar ao Orchestrator . |
Configurações
| O que você vê | Causa | Solução |
|---|---|---|
| Uma alteração de configuração não entra em vigor | Algumas configurações só se aplicam após uma reinicialização | Reinicie o Cartographer. |
| Uma alteração de configuração não entra em vigor | É uma configuração da guia Segurança | Altere-o por meio da interface gráfica de Configurações, não editando o arquivo de configurações diretamente. |
| O arquivo de configurações está corrompido | settings.json tem JSON inválido, geralmente de uma edição manual | Feche o Cartographer. Exclua ou renomeie settings.json.Reiniciar — ele é recriado com padrões, e você precisará reconfigurar suas preferências. Consulte Configurações locais de arquivos. |
Processos de negócios e documentos
| O que você vê | Causa | Solução |
|---|---|---|
| Muitas solicitações Aprovar/Rejeitar | O modo de aprovação está definido como Cateção, que confirma antes de quase todas as ações de design | Alterne para Adaptativo ou Inteligente (menos prompts) ou Acesso total (sem prompts), na caixa de chat ou em Configurações → Fundamentos. |
| Um projeto ou sessão "desapareceu" | Os projetos são vinculados ao tenant onde foram criados. Ao mudar a organização ou o tenant, você oculta os projetos criados em outro lugar | Confirme que você fez login na mesma organização e tenant usados quando você os criou. |
| A saída parece rasa ou pula etapas | O modelo atual não é o recomendado ou as habilidades do processo não corresponderam | Marque Configurações > Modelo — use o ChatGPT 5.6 Terra, médio esforço. Confirme as habilidades do processo associadas ao prompt "Certifique-se de usar as habilidades do processo para aprimorar seu conhecimento do processo". Se uma etapa específica tiver sido ignorada, solicite que o Cartographer a refaça diretamente. |
| “Disse que estava boa, mas não havia nada atualizado” | "Path Assistant" não é tratada como confirmação | Use a frase exata "Confirmo o mapa do processo". Verifique o estado real capturado no grupo FACTS (AS-IS) do painel Lista de Verificação. |
| O download não reflete minhas edições mais recentes | O .docx baixado foi editado diretamente | Use o fluxo de trabalho da seção Refinar ou a edição no produto — consulte Como o refinamento funciona. Editar manualmente o arquivo baixado não sincroniza novamente. |
| A geração parece travar | Tempo normal — a extração é executada em torno de 5 minutos e a geração de PDD normalmente de 2 a 5 minutos, variando de acordo com o modelo e o nível de esforço | Dê a janela completa antes de travar. |
Obtendo suporte
Se você precisar entrar em contato com o suporte da UiPath, essas quatro coisas os ajudam a ajudar você mais rapidamente — você pode recuperar cada um deles:
| Obter | Faça isso |
|---|---|
| Versão do Produto | Configurações > Geral > Sobre > Versão |
| ID da sessão | Peça ao agente: "Forneça o ID da sessão que é visível no lado do servidor". Ele retorna um GUID — um GUID diferente do ID do projeto. |
| Transcrição da sessão | Na conversa, abra o menu suspenso na parte superior central e selecione Exportar como markdown para salvar a transcrição completa como .md arquivo. |
| Caminhos de arquivo para arquivos de trabalho | Peça ao agente: "mostre-me o caminho para o wiki de conhecimento e para o PDD salvo".". O Cartographer retorna os caminhos locais para o wiki na sessão, o PDD gerado e as versões Markdown dos diagramas. |
| Pacote de logs, para problemas mais profundos | Configurações > Geral > Sobre > Exportar > Download produz um .zip dos logs técnicos. |
| Não é possível encontrar uma configuração | Está em uma guia diferente do esperado |
| Não é possível encontrar uma configuração | É específico da versão |
| As configurações seguras não serão salvas | Seu perfil de usuário do Windows não está carregado corretamente — o arquivo de configurações seguras depende da API de Proteção de Dados (DPAPI) |
| As configurações seguras não serão salvas | macOS didn't let UiPath Assistant use its Keychain key (login keychain locked, or access denied) |
| As configurações seguras não serão salvas | The Keychain-protected file couldn't be decrypted |