Implementando Agentes

Como funciona a implantação de agentes

A implantação segue um fluxo de trabalho claro que separa o desenvolvimento da produção:

1. Criação em rascunho: você cria e aprimora seu agente no ambiente de rascunho, onde pode experimentar livremente sem afetar os usuários ativos.

2. Teste suas alterações: use a página de visualização para verificar se o seu agente está funcionando conforme o esperado. A pré-visualização reflete sempre a sua versão preliminar mais recente.

3. Implante ao vivo: quando estiver pronto, a implantação captura a configuração completa do seu agente, incluindo instruções, arquivos de conhecimento, ferramentas e colaboradores, e publica esse instantâneo no ambiente ao vivo, onde os usuários podem acessá-lo.

4. Atualizar e reimplantar: após a implantação, você pode continuar editando seu agente. Quando estiver pronto para enviar as atualizações, reimplemente para substituir a versão ativa pelas suas alterações mais recentes.

Para obter mais informações sobre ambientes de rascunho e ao vivo, consulte Ambientes.

Cada implantação utiliza a versão preliminar mais recente, incluindo quaisquer alterações recentes feitas pelos colaboradores. Sempre revise e teste seu agente antes de implantá-lo. Se os colegas de equipe estiverem contribuindo, coordene-os para ajudar a garantir precisão e consistência.

Antes de iniciar

Antes de implantar, certifique-se de:

• Forneça um nome e uma descrição claros e válidos para que os usuários saibam o que seu agente faz.

• Conclua todos os comportamentos, ferramentas e conexões necessários para evitar bloqueadores de implantação.

• Verifique se o seu rascunho funciona como esperado para que seus usuários tenham a melhor experiência possível.

Esses detalhes podem garantir uma implantação limpa e bem-sucedida.

Implemente o agente

Quando estiver pronto para publicar a versão mais recente do seu agente, você poderá implantá-la a partir da página de configuração.

Para implantar o agente:

1. Abra a página de configuração do seu agente.

2. Selecione Implantar para abrir o Resumo pré-implantação.

3. Verifique os componentes do seu agente, o status da conexão e as configurações de implantação.

Revisar o resumo pré-implantação

Use o resumo para confirmar que tudo está pronto para a produção.

Uma marca de seleção verde indica que o esquema de segurança de uma ferramenta corresponde à sua conexão.

Configurar conexões

Se o seu agente usa APIs, bancos de dados ou serviços de terceiros para executar determinadas tarefas, a implantação é sua chance de garantir que essas conexões estejam prontas. Confirmar as configurações de autenticação e conexão ajuda seu agente a trabalhar sem problemas quando os usuários dependem dele.

Validar e configurar conexões

Durante a implantação, você pode ver as conexões que seu agente usa ativamente. Se algum requisito estiver faltando ou estiver incompleto, a implantação será pausada para evitar que você publique uma experiência com falhas. O bot ão Deploy desativado ajuda você a detectar e corrigir problemas antecipadamente.

Para continuar, você precisa configurar ou reconectar a conexão ausente seguindo as etapas a seguir.

Para criar uma nova conexão:

1. Clique em Adicionar conexão +.

2. Insira um ID de conexão e um nome de exibição.

3. Clique em Salvar e continuar.

4. (Opcional) Habilite o login único (SSO).

5. Selecione um tipo de autenticação :

   • Chave de API

   • Autenticação básica

   • Token de Acesso

   • Par chave-valor (apenas credenciais da equipe)

6. Insira os detalhes necessários para o tipo de autenticação escolhido.

7. Escolha um tipo de credencial:

   • Credenciais dos membros: Cada usuário utiliza suas próprias credenciais.

   • Credenciais da equipe: Todos os usuários compartilham as credenciais da equipe.

1. Clique em Add connection (Adicionar conexão ). A conexão aparece na tabela. Para editá-lo, clique no ícone do lápis.

2. Clique em Deploy para concluir a configuração. Após a implantação, o agente exibe um ícone de ativo que indica que ele está em funcionamento na produção. Passe o mouse sobre o ícone para visualizar a data e hora da implantação.

Atualizando um agente implantado

Seu agente não permanece estático após a implantação. Você pode melhorá-lo continuamente alterando seu rascunho e reimplantando:

1. Altere seu agente de rascunho, por exemplo, atualize instruções, adicione ferramentas e modifique conhecimentos.

2. Teste suas alterações usando a página de visualização para garantir que elas funcionem conforme o esperado.

3. Quando estiver pronto, clique em Implantar novamente para enviar suas atualizações para o ambiente ativo.

4. A nova implantação substitui a versão anterior, disponibilizando imediatamente as suas últimas alterações aos usuários.

Com esse fluxo de trabalho, você pode realizar iterações no seu agente enquanto mantém uma versão de produção estável. Os usuários sempre interagem com a última versão implantada, enquanto você trabalha com segurança no modo rascunho.

Desinstale o agente

Se o seu agente estiver ativo e você precisar interrompê-lo, é possível desativá-lo a qualquer momento. A desativação permite que você tenha controle total sobre quando os usuários podem interagir com seu agente. Quando você desinstala:

• Todas as instâncias de produção são interrompidas imediatamente.

• O agente fica indisponível nos canais ao vivo.

• Os usuários não podem mais acessá-lo.

Após a desimplantação, seu agente retorna ao estado de rascunho e não aparecerá mais nos resultados de pesquisa ativos.

Para desinstalar:

• Abra a página de configuração do agente.

• Clique no ícone Opções (⋮), selecione Desimplantar e confirme.

O quê fazer em seguida

Após a implantação, seu agente fica disponível em todos os canais configurados. Para saber como usar agentes na experiência de chat, consulte Usando o Orchestrate Chat.