Implantação de agentes de conversa

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
Serverless robot machine template	Executes the conversational agent and specific tool calls (cross-platform RPA automations)	Sempre
Conta de Unattended Robot	Provides an execution identity when agent is used anonymously	If the agent is accessed through a channel using anonymous access
Máquina Virtual	Executa automações de RPA baseadas no Windows	Se estiver usando automações do Windows
Conexões compartilhadas	Provides access to Integration Service connectors when no user-configured personal connection is available	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.
• A serverless robot machine template is assigned to the solution folder.
• If using an anonymous-access channel, an unattended robot account is assigned to the solution folder.

Execution identity

• When the conversational agent is accessed through a deployment channel that authenticates with the user's UiPath account, the conversational agent runs under the user's identity. When the agent invokes tools that are Orchestrator processes, they run under the user's identity as well.
• When using a deployment channel with anonymous access, the conversational agent instead runs under the identity of an unattended robot account within the folder.

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.Para garantir que as conexões funcionem no runtime, recomendamos a seguinte configuração:

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.

Observação:

As conexões pessoais não são compatíveis. Apenas conexões compartilhadas estão disponíveis para agentes de conversa.

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	TypeScript SDK*
Iniciar novo chat	✅	✅	✅	✅	✅	✅
Histórico do chat	✅	✅	✅	✅	✅	✅
Excluir sessão de chat	✅	✅	❌	❌	✅	✅
User-profile settings	✅	✅	❌	❌	✅	✅
Iniciando prompts	✅	❌	❌	❌	✅	✅
Carregamentos de arquivo	✅	✅	✅	✅	✅	✅
Conversation inputs	✅	❌	❌	❌	✅	✅
Tool-call confirmations	✅	❌	❌	❌	✅	✅
Citações	✅	✅	✅	✅	✅	✅
Visualização do HTML	✅	❌	❌	❌	✅	✅
Copiar resposta	✅	✅	❌	❌	✅	✅
Feedback (polegares)	✅	✅	✅	✅	✅	✅

* All SDK features can be configured by the developer in their custom implementation.

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