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

The agent needs access to the same connections used at design time. Conversational agents support two types of connections: shared connections configured by admins, and personal connections configured by individual users.

Conexões compartilhadas

Shared connections are configured by admins in an Orchestrator folder and are available to all users of the agent. To set up shared connections:

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

Personal connections allow individual users to select which Integration Service connections the agent uses on their behalf. This is useful when users need the agent to act with their own credentials — for example, sending emails from their own account or accessing their personal calendar.

Enabling personal connections

For personal connections to work, two settings must be configured on each tool process in Orchestrator. For general information about execution settings, see Linking execution settings.

1. In Orchestrator, navigate to the folder where the agent solution is deployed and open the Processes tab.
2. Select Edit on the tool process that uses a connector (for example, an API workflow that sends emails).
3. In the process configuration, set the Account to Inherit parent job identity. This allows the tool to run under the user's identity, which is required for the tool to access the user's personal connections.
4. Set the connector's connection to Configurable by users. This allows users to select their own connections for the connector at runtime.

Importante:

Both settings are required. Without either setting, personal connections are not visible to users and the tool may return an error at runtime.

Experiência do usuário

When personal connections are enabled for an agent:

• Users can open the agent's Settings panel and select the Available Connections tab to view and manage their connections.
• For each required connector (for example, Slack, Outlook, or Salesforce), users can select one of their available connections or create a new one.
• By default, the agent auto-selects a matching connection from the user's personal workspace for the connector that the agent and other tools in the folder use.

The agent attempts to auto-configure connections from the user's personal workspace. If the user has a matching connection for a connector in their personal workspace, the agent uses it automatically — making setup seamless and typically a one-time experience. If the auto-configured connection fails or no matching connection is found, the user is prompted to select or create a new one.

If a user has not configured a personal connection for a connector, the agent falls back to the agent's default connection. Selected personal connections take precedence over shared connections and are always used when present. When using external applications, only connections from the user's personal workspace are available — shared folder connections are not displayed.

Observação:

Users can select and manage personal connections only in channels that support user-profile settings (see Feature availability by channel). Once configured, personal connections are used by the agent across all channels.

To learn how to design an agent for personal connections, see Connection considerations in the design guide.

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