- Introdução
- Agentes da UiPath no Studio Web
- Sobre os agentes da UiPath
- Licenciamento
- Agentes codificados no Studio Web
- Execução de agentes
- Prompts
- Trabalhando com arquivos
- Contexto
- Escalonamentos e memória do agente
- Avaliações
- Traços de agente
- Pontuação do agente
- Gerenciamento de agentes UiPath
- Agentes codificados da UiPath

Guia do Usuário de Agentes
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ção | Description |
|---|---|
| Automação de área de trabalho local | O agente não pode executar automações na área de trabalho local do usuário por meio do Assistant. |
| Conexões pessoais | Apenas conexões compartilhadas do Integration Service estão disponíveis. As conexões pessoais não são compatíveis. |
| Confirmação da ferramenta | O agente não pede a confirmação do usuário antes de executar ferramentas. |
| Mascaramento de PII | A detecção e o mascaramento de PII não estão disponíveis. |
| Proteções contra injeção de solicitação | As proteções no nível do agente para injeção de solicitação não estão disponíveis. |
| Tamanho do arquivo | Os uploads de arquivos são limitados a 5 MB. |
| Interação por voz | Interação somente por texto. Push-to-talk e voz bidirecional não estão disponíveis. |
| Integração de IVR | A 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:
| Recurso | Onde funciona | Onde não funciona |
|---|---|---|
| Iniciando prompts | Gerenciamento de instâncias, iFrame | Autopilot for Everyone, Teams, Slack |
| Visualização do HTML | Gerenciamento de instâncias, iFrame | Autopilot for Everyone, Teams, Slack |
| Carregamentos de arquivo | Gerenciamento de instâncias, Autopilot for Everyone, iFrame | Teams, Slack |
| Citações | Gerenciamento de instâncias, Autopilot for Everyone, Teams, Slack | Iframe |
| Debug dump | Gerenciamento de instâncias, Autopilot for Everyone | Teams, 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:
- Certifique-se de que uma conta de Unattended Robot seja atribuída à pasta da solução.
- Verifique se você está no tenant correto onde a solução do agente reside.
- 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:
- Crie conexões do Integration Service em uma pasta compartilhada do Orchestrator.
- Use as conexões compartilhadas durante o design e a depuração.
- 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:
- Verifique se o agente está publicado e implantado no Orchestrator.
- Verifique se você conectou o aplicativo Teams à sua conta da UiPath.
- Use o comando Fazer logout e reconecte-se para atualizar sua sessão.
- 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":
- Verifique se o índice existe e está em um estado "Pronto".
- Verifique se o agente tem acesso à pasta que contém o índice.
- Certifique-se de que o índice não tenha sido movido ou excluído desde a configuração.
- 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.
- Limitações atuais
- Disponibilidade de funcionalidade do canal
- Perguntas frequentes
- Visão geral dos agentes de conversa
- Licenciamento e consumo
- Modelos e configuração
- Implantação e acesso
- Incorporação e integração
- Problemas específicos do canal
- Embasamento de contexto
- Desempenho
- Conformidade e governança
- Armazenamento de dados
- Personalização
- Ajuda