UiPath Documentation
agents
latest
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do Usuário de Agentes

Última atualização 2 de abr de 2026

Limitações e Perguntas frequentes

Esta página documenta as limitações atuais de agentes de conversa e fornece respostas a perguntas frequentes.

Limitações atuais

Estamos expandindo ativamente o produto com novos recursos. A tabela abaixo descreve as limitações atuais, que estão planejadas para serem resolvidas em futuras versões.

LimitaçãoDescription
Automação de área de trabalho localO agente não pode executar automações na área de trabalho local do usuário por meio do Assistant.
Conexões pessoaisApenas conexões compartilhadas do Integration Service estão disponíveis. As conexões pessoais não são compatíveis.
Confirmação da ferramentaO agente não pede a confirmação do usuário antes de executar ferramentas.
Mascaramento de PIIA detecção e o mascaramento de PII não estão disponíveis.
Proteções contra injeção de solicitaçãoAs proteções no nível do agente para injeção de solicitação não estão disponíveis.
Tamanho do arquivoOs uploads de arquivos são limitados a 5 MB.
Interação por vozInteração somente por texto. Push-to-talk e voz bidirecional não estão disponíveis.
Integração de IVRA integração de resposta de voz interativa não está disponível.

Disponibilidade de funcionalidade do canal

Nem todas as funcionalidades estão disponíveis em todos os canais de implantação.Consulte Implantação para obter a comparação de funcionalidades completa.

Diferenças principais:

RecursoOnde funcionaOnde não funciona
Iniciando promptsGerenciamento de instâncias, iFrameAutopilot for Everyone, Teams, Slack
Visualização do HTMLGerenciamento de instâncias, iFrameAutopilot for Everyone, Teams, Slack
Carregamentos de arquivoGerenciamento de instâncias, Autopilot for Everyone, iFrameTeams, Slack
CitaçõesGerenciamento de instâncias, Autopilot for Everyone, Teams, SlackIframe
Debug dumpGerenciamento de instâncias, Autopilot for EveryoneTeams, Slack, iFrame

Limitações adicionais do canal:

  • Teams e Slack: apenas mensagens diretas são compatíveis. As discussões do canal e @menções não estão disponíveis.
  • Visualização de citações: disponível apenas para documentos em PDF.

Perguntas frequentes

Visão geral dos agentes de conversa

Como os agentes de conversa diferem de agentes autônomos?

Agents de conversa são projetados para diálogos de várias etapas, para frente e para trás com usuários. Agentes autônomos executam tarefas a partir de uma única solicitação. Use agentes de conversa quando seu cenário exigir esclarecimentos contínuos, orientação personalizada ou interação em tempo real.

Consulte Agents de conversa para obter uma comparação detalhada.

Como os agentes de conversação se relacionam com o Autopilot for Everyone?

Eles trabalham lado a lado:

  • Autopilot for Everyone: o assistente de uso geral da UiPath para tarefas de produtividade.
  • Agents de conversa: agentes especializados que você cria para casos de uso específicos.

Você pode acessar seus agentes de conversa de dentro do Autopilot for Everyone, tornando-o um hub central para todas as suas necessidades de conversa.

Licenciamento e consumo

Como as ações gratuitas são contadas?

As ações gratuitas são contadas por usuário e não agrupadas entre usuários.Cada usuário tem sua própria parcela gratuita individual com base em seu tipo de licença:

  • Express: 50 ações gratuitas por ano
  • Básico: 50 ações gratuitas por mês
  • Plus/Pro: ilimitado (sujeito a uso justo)

Se o usuário A envia 20 mensagens e o usuário B envia 80 mensagens, o usuário A ainda tem 30 mensagens gratuitas restantes, enquanto o usuário B excedeu seu nível gratuito.

As chamadas de ferramenta têm custo extra?

Algumas ferramentas têm consumo adicional além do custo básico da ação:

  • Sem custo adicional: contextualização (pesquisa semântica), conectores do Integration Service, ferramentas MCP

Consulte Licenciamento para obter detalhes completos.

O que conta como uma ação?

Uma ação é igual a uma mensagem do usuário enviada para o agente de conversa. Não importa quantas respostas do agente são geradas a partir dessa mensagem. As mensagens com oito caracteres ou menos que não executam uma ferramenta não são contadas.

Modelos e configuração

Posso usar meu próprio LLM?

Sim. Os agentes de conversa são compatíveis com Configurações de LLM para que você possa usar suas próprias assinaturas de LLM. Essa funcionalidade está em visualização. Durante o período de visualização, não há cobrança por mensagem, mas o consumo adicional para certos usos de ferramentas ainda se aplica.

Quais tipos de arquivo os usuários podem carregar?

Você deve adicionar uma ferramenta de análise de arquivos (Analisar arquivos, Extração e Processamento Inteligente (IXP) ou fluxo de trabalho personalizado) para habilitar uploads de arquivos. Tipos compatíveis:

  • Imagens: GIF, JPE, JPEG, PNG, WEBP
  • Documentos: PDF (menos de 5 MB)

Implantação e acesso

Por que meu agente de conversação não está começando no Gerenciamento de iInstância?

Verifique o seguinte:

  1. Certifique-se de que uma conta de Unattended Robot seja atribuída à pasta da solução.
  2. Verifique se você está no tenant correto onde a solução do agente reside.
  3. Verifique se um robô sem servidor é atribuído se você estiver usando ferramentas de RPA multiplataforma.

Por que estou recebendo um erro de conexão ao executar ferramentas?

O agente necessita de acesso às mesmas conexões usadas no momento do design:

  1. Crie conexões do Integration Service em uma pasta compartilhada do Orchestrator.
  2. Use as conexões compartilhadas durante o design e a depuração.
  3. Publique a solução como uma subpasta dentro da mesma pasta compartilhada.

Isso garante que a solução herde automaticamente as conexões da pasta pai.

Como posso limitar quais usuários podem acessar um agente de conversa específico?

O acesso do usuário é controlado por meio de permissões de pasta do Orchestrator. Os usuários precisam de permissões apropriadas na pasta que contém a solução do agente. Configurar o acesso à pasta no Portal de administrador.

Incorporação e integração

Como posso incorporar Agents de conversação ao meu Aplicativo?

Incorpore usando um iFrame. Consulte Incorporação de Apps para construção e parâmetros de URL.

Posso incorporar um agente para usuários sem contas da UiPath?

Sim. Use acesso anônimo para incorporar agentes para usuários externos. Isso requer a configuração de um aplicativo externo e um ponto de extremidade do token. Usuários anônimos consomem do pool de unidades do tenant sem nível gratuito.

Problemas específicos do canal

Posso acessar agentes de conversa por meio da API?

Estamos trabalhando na integração ao UiPath TypeScript SDK público e forneceremos acesso quando estiver disponível.

Por que as solicitações iniciais não estão sendo exibidas em Teams, Slack ou Autopilot for Everyone?

As solicitações iniciais são compatíveis apenas em Gerenciamento de instância e incorporação de iFrame. Outros canais não propagam essas solicitações devido a limitações da plataforma.

O agente pode responder em canais do Slack ou canais do Teams?

Não. Os agentes de conversa são compatíveis apenas com mensagens diretas por meio do plug-in do UiPath Autopilot. Discussões do canal e @menções não são compatíveis.

Por que não posso ver a visualização de HTML no Teams ou Slack?

A visualização de HTML está disponível apenas no Gerenciamento de instâncias e ncorporação de iFrame. Em outros canais, o conteúdo HTML é exibido como texto bruto ou markdown.

Por que não posso criar conversas no Teams?

Se as conversas não começarem:

  1. Verifique se o agente está publicado e implantado no Orchestrator.
  2. Verifique se você conectou o aplicativo Teams à sua conta da UiPath.
  3. Use o comando Fazer logout e reconecte-se para atualizar sua sessão.
  4. Verifique se o agente está disponível usando o comando Alternar agente.

Embasamento de contexto

Por que o agente não pode localizar meu índice de contextualização?

Se você receber erros "índice não encontrado":

  1. Verifique se o índice existe e está em um estado "Pronto".
  2. Verifique se o agente tem acesso à pasta que contém o índice.
  3. Certifique-se de que o índice não tenha sido movido ou excluído desde a configuração.
  4. Publique novamente o agente após fazer alterações no índice.

Por que as citações estão incorretas ou ausentes?

A qualidade da citação depende de:

  • Qualidade do índice: certifique-se de que os documentos de origem sejam bem estruturados
  • Tamanho da parte: partes muito grandes ou pequenas afetam a precisão da citação
  • Relevância da consulta: consultas ambíguas podem recuperar conteúdo menos relevante

Observação: a visualização de citação está disponível apenas para documentos em PDF.

Desempenho

Quais fatores afetam o tempo de resposta?

Vários fatores influenciam a latência:

  • Seleção de modelos: diferentes modelos têm diferentes características de latência
  • Tamanho da janela de contexto: históricos de conversas maiores aumentam o tempo de processamento
  • Execução da ferramenta: fluxos de trabalho de RPA e chamadas de API adicionam tempo de execução
  • Contextualização: as pesquisas em RAG adicionam latência com base no tamanho do índice

Para otimizar:

  • Use fluxos de trabalho de API em vez de RPA para operações apenas com API.
  • Mantenha o contexto da conversa focado.
  • Escolha modelos apropriados para seus requisitos de latência.

Conformidade e governança

Como posso auditar chamadas de LLM e o comportamento do agente?

O AI Trust Layer fornece uma trilha de auditoria completa. Acesse logs de auditoria por meio do portal do administrador para:

  • Histórico completo de interações com o modelo.
  • Rastreamento de uso de tokens.
  • Verificação de conformidade com a política.

Consulte Observabilidade para obter detalhes.

Armazenamento de dados

Onde o histórico do chat é armazenado?

O histórico do chat é armazenado no banco de dados do Azure e tem o tenant como escopo. Os usuários podem acessar apenas o histórico do chat para agentes que eles tenham permissão para usar.

Onde os arquivos carregados são armazenados?

Os arquivos carregados são armazenados no Azure Blob Storage por meio do bucket de armazenamento do sistema do Orchestrator. O armazenamento é direcionado para o tenant e a região.

Por quanto tempo os arquivos carregados são retidos?

Os arquivos seguem a política de retenção do Orchestrator, com o padrão de 30 dias após o trabalho ser considerado inativo. Esse período de retenção é configurável nas configurações do Orchestrator.

Personalização

Posso personalizar a mensagem de boas-vindas?

Ao incorporar por meio do iFrame, use os parâmetros de URL welcomeTitle, welcomeDescription e suggestions. Consulte Incorporação de Apps para obter detalhes.

No Gerenciamento de Instâncias, a experiência de boas-vindas utiliza as configurações do agente.

Ajuda

Se você encontrar problemas não abordados aqui:

  • Revise os Traces do agente para depurar informações.
  • Use a funcionalidade de despejo do Debug (Ctrl+Alt+D em Gerenciamento de Instâncias) para capturar informações de diagnóstico.
  • Faça o contato do suporte da UiPath com despejo de Debug e informações relevantes sobre trace.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades