Implantação de agentes de conversa

Publique e implante um agente de conversa no Orchestrator para disponibilizá-lo aos usuários após a conclusão do design e dos testes.

Após projetar e testar seu agente de conversa, você precisa publicá-lo e implantá-lo para torná-lo disponível para os usuários. A publicação e a implantação são duas etapas separadas:

• Publicação: empacota seu agente como uma solução e o envia para o Orchestrator.
• Implantação: disponibiliza a solução publicada para execução com os recursos de runtime necessários.

Requisitos da pasta do Orchestrator

Antes de publicar, certifique-se de que os recursos necessários estejam configurados na sua pasta de destino do Orchestrator.

Recurso	Finalidade	Required
Modelo de máquina do Serverless Robot	Executa o agente de conversa e chamadas de ferramenta específicas (automações de RPA multiplataforma)	Sempre
Conta de Unattended Robot	Fornece uma identidade de execução quando o agente é usado de forma anônima	Se o agente for acessado por meio de um canal com acesso anônimo
Máquina Virtual	Executa automações de RPA baseadas no Windows	Se estiver usando automações do Windows
Conexões compartilhadas	Fornece acesso a conectores do Integration Service quando nenhuma conexão pessoal configurada pelo usuário está disponível	Se as ferramentas usarem conectores

Importante:

Se seu agente não iniciar no Gerenciamento de instância, verifique se:

• Você está no tenant correto onde a solução do agente reside.
• Um modelo de máquina de Serverless Robot é atribuído à pasta da solução.
• Se estiver usando um canal de acesso anônimo, uma conta de robô não assistido será atribuída à pasta da solução.

Identidade de execução

• Quando o agente de conversa é acessado por meio de um canal de implantação que se autentica com a conta UiPath do usuário, o agente de conversa é executado sob a identidade do usuário. Quando o agente invoca ferramentas que são processos do Orchestrator, elas também são executadas sob a identidade do usuário.
• Ao usar um canal de implantação com acesso anônimo, o agente de conversa é executado sob a identidade de uma conta de robô não assistido dentro da pasta.

Publicando

A publicação empacota seu agente de conversa como uma solução e o carrega no Orchestrator.

Etapas da publicação

1. No Studio Web, abra seu agente de conversa.
2. Selecione Publicar na barra de ferramentas superior.
3. Selecione o feed de destino do Orchestrator (recomendamos o feed de tenant do Orchestrator).
4. (Opcional) Insira uma nota do log de alterações descrevendo sua alteração.
5. Selecione Publicar.

Para obter opções de publicação detalhadas, consulte Como publicar um projeto.

Implantação

Após a publicação, você precisa implantar a solução para torná-la disponível para execução. A implantação associa a solução publicada aos recursos de runtime em sua pasta do Orchestrator.

Etapas de implantação

1. Navegue até o seu Orchestrator.
2. Localize a solução publicada.
3. Implante (ou atualize) a solução, garantindo que ela tenha acesso às contas e conexões de robô necessárias.

Uma vez implantado, o agente aparece no Gerenciamento de instâncias e torna-se disponível por meio de canais configurados.

Para obter opções detalhadas de implantação, consulte Publicar um projeto.

Gerenciamento da conexão

O agente necessita de acesso às mesmas conexões usadas no momento do design. Os agentes de conversa são compatíveis com dois tipos de conexões: conexões compartilhadas configuradas por administradores e conexões pessoais configuradas por usuários individuais.

Conexões compartilhadas

As conexões compartilhadas são configuradas por administradores em uma pasta do Orchestrator e estão disponíveis para todos os usuários do agente. Para configurar conexões compartilhadas:

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

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

Conexões pessoais

Observação:

Personal connections is in Public Preview.

As conexões pessoais permitem que usuários individuais selecionem quais conexões do Integration Service o agente usa em seu nome. Isso é útil quando os usuários precisam que o agente aja com suas próprias credenciais — por exemplo, para enviar e-mails da própria conta ou acessar seu calendário pessoal.

Habilitação de conexões pessoais

Para que as conexões pessoais funcionem, duas configurações devem ser definidas em cada processo de ferramenta no Orchestrator. Para obter informações gerais sobre configurações de execução, consulte Vinculação de configurações de execução.

1. No Orchestrator, navegue até a pasta onde a solução do agente é implantada e abra a aba Processos .
2. Selecione Editar no processo de ferramenta que usa um conector (por exemplo, um fluxo de trabalho de API que envia e-mails).
3. Na configuração do processo, defina a Conta como Herdar identidade do trabalho pai. Isso permite que a ferramenta seja executada com a identidade do usuário, o que é necessário para que a ferramenta acesse as conexões pessoais do usuário.
4. Defina a conexão do conector como Configurável pelos usuários. Isso permite que os usuários selecionem suas próprias conexões para o conector no runtime.

Importante:

Ambas as configurações são necessárias. Sem essa configuração, as conexões pessoais não são visíveis para os usuários e a ferramenta pode retornar um erro no runtime.

Experiência do usuário

Quando as conexões pessoais são habilitadas para um agente:

• Os usuários podem abrir o painel Configurações do agente e selecionar a guia Conexões disponíveis para visualizar e gerenciar suas conexões.
• Para cada conector necessário (por exemplo, Slack, Outlook ou Salesforce), os usuários podem selecionar uma de suas conexões disponíveis ou criar uma nova.
• Por padrão, o agente seleciona automaticamente uma conexão correspondente do espaço de trabalho pessoal do usuário para o conector que o agente e outras ferramentas na pasta usam.

O agente tenta configurar automaticamente conexões do espaço de trabalho pessoal do usuário. Se o usuário tiver uma conexão correspondente para um conector em seu espaço de trabalho pessoal, o agente a usará automaticamente — tornando a configuração perfeita e normalmente uma experiência única. Se a conexão configurada automaticamente falhar ou nenhuma conexão correspondente for encontrada, o usuário será solicitado a selecionar ou criar uma nova.

Se um usuário não tiver configurado uma conexão pessoal para um conector, o agente retornará à conexão padrão do agente. As conexões pessoais selecionadas têm precedência sobre conexões compartilhadas e são sempre usadas quando presentes. Ao usar aplicativos externos, apenas conexões do espaço de trabalho pessoal do usuário estão disponíveis — conexões de pasta compartilhada não são exibidas.

Observação:

Os usuários podem selecionar e gerenciar conexões pessoais apenas em canais que são compatíveis com configurações de perfil de usuário (consulte Disponibilidade de funcionalidade por canal). Após configuradas, as conexões pessoais são usadas pelo agente em todos os canais.

Para saber como projetar um agente para conexões pessoais, consulte Considerações sobre conexão no guia de projeto.

Canais de implantação

Depois de publicar, os usuários podem acessar seu agente de conversa por meio de vários canais.Cada canal oferece diferentes recursos e é adequado para diferentes casos de uso.

Visão geral do canal

Canal	Melhor para	Autenticação do usuário
Gerenciamento de instâncias	Testes de administrador, usuários internos	Conta do UiPath
Autopilot para todos	Hub de produtividade interno	Conta do UiPath
Microsoft Teams	Colaboração em equipe	Conta da Microsoft e conta da UiPath
Slack	Colaboração em equipe	Conta do Slack e conta da UiPath
Incorporação do iFrame	Apps de terceiros e UiPath Apps	Conta da UiPath ou anônima
UiPath TypeScript SDK	Aplicativos criados sob medida	Determinado por seu aplicativo

Disponibilidade de funcionalidade por canal

Nem todas as funcionalidades de chat estão disponíveis em todos os canais. O Gerenciamento de instâncias fornece o conjunto de funcionalidades completo; outros canais podem ter limitações.

Recurso	Gerenciamento de instâncias	Autopilot para todos	Microsoft Teams	Slack	Iframe	SDK do TypeScript*
Iniciar novo chat	✅	✅	✅	✅	✅	✅
Histórico do chat	✅	✅	✅	✅	✅	✅
Excluir sessão de chat	✅	✅	✅	❌	✅	✅
Configurações do perfil do usuário	✅	✅	✅	❌	✅	✅
Conexões pessoais	✅	✅	✅	❌	✅	✅
Iniciando prompts	✅	❌	✅	❌	✅	✅
Carregamentos de arquivo	✅	✅	✅	✅	✅	✅
Entradas de conversas	✅	❌	✅	❌	✅	✅
Confirmações de chamadas de ferramentas	✅	❌	✅	❌	✅	✅
Citações	✅	✅	✅	✅	✅	✅
Visualização do HTML	✅	❌	✅	❌	✅	✅
Copiar resposta	✅	✅	✅	❌	✅	✅
Feedback (polegares)	✅	✅	✅	✅	✅	✅

* Todas as funcionalidades do SDK podem ser configuradas pelo desenvolvedor em sua implementação personalizada.

Escolha de canal

Considere estes fatores ao selecionar canais de implantação:

Usuários internos com acesso à UiPath

• Use o Gerenciamento de instâncias para testes de administrador e usuários avançados.
• Use o Autopilot for Everyone como um hub central para todos os agentes.

Colaboração em equipe

• Use o Teams ou o Slack para levar o agente aonde as equipes já trabalham.

Aplicativos personalizados

• Use a incorporação de iFrame para Apps de terceiros ou UiPath Apps.

Usuários externos ou anônimos

• Use a incorporação de iFrame com um servidor de autenticação anônimo.

Aplicativos personalizados

• Use o UiPath TypeScript SDK para integrar agentes conversacionais a seus próprios aplicativos ou portais da web.

Comportamento da sessão de chat

Os agentes de conversa mantêm sessões persistentes:

• Cada conversa é executada como um processo dedicado do Orchestrator (ativo por até 8 horas de inatividade).
• As sessões permanecem ativas para habilitar respostas imediatas.
• As sessões inativas consomem recursos mínimos.

Uso de ferramentas da UiPath em plataformas externas

Você pode expor recursos da UiPath (automações, fluxos de trabalho, processamento de documentos) a plataformas de chat externas como ChatGPT e Microsoft Copilot Studio usando ferramentas MCP (Protocolo de contexto de modelo). Essa abordagem usa chamadas de ferramenta diretas em vez de agentes de conversa.

Para obter detalhes sobre a integração do MCP, consulte Servidores MCP.

Próximas Etapas

Selecione um canal para saber mais sobre configuração:

• Gerenciamento de instâncias
• Autopilot para todos
• Microsoft Teams
• Slack
• Incorporação de IFrame e Apps
• UiPath TypeScript SDK