Objetivo

A tela Agentes permite consultar e administrar os agentes disponíveis no ambiente do CR.IA Business.

Depois que um agente é adicionado pela Loja de Agentes ou criado como agente personalizado, ele passa a fazer parte do ambiente e pode ser gerenciado por meio dessa tela.

Entre as principais ações disponíveis estão:

• visualizar os agentes cadastrados;
• criar novos agentes personalizados;
• editar agentes personalizados;
• excluir agentes;
• associar sistemas ao agente;
• definir quais usuários podem utilizar cada agente;
• configurar filtros de dados por usuário;
• ativar ou desativar agentes;
• atualizar a lista de agentes;
• reiniciar o serviço quando necessário para aplicar novas configurações.

Acessar a tela de Agentes

Para acessar o gerenciamento de agentes:

1. No menu lateral do CR.IA Business, selecione Agentes.
2. A plataforma exibirá a lista de agentes cadastrados no ambiente.

Utilize o campo Pesquisar agentes para localizar rapidamente um agente específico.

Selecionar um agente

Para realizar uma ação sobre determinado agente, selecione-o na lista.

1. Localize o agente desejado.
2. Marque a caixa de seleção correspondente ao agente.

Após a seleção, as ações disponíveis serão apresentadas na barra superior da tela.

Ações disponíveis

A tela de Agentes disponibiliza diferentes ações para administração dos agentes.

Entre as principais opções estão:

Novo

Permite criar um novo agente personalizado.

Editar

Permite alterar as configurações de um agente personalizado existente.

Excluir

Permite remover um agente do ambiente.

Sistemas

Permite definir em quais sistemas o agente poderá trabalhar.

Usuários

Permite definir quais usuários poderão utilizar o agente e configurar filtros de dados específicos para cada usuário.

Atualizar

Atualiza a lista de agentes apresentada na tela.

Ativar / Desativar

Permite controlar a disponibilidade do agente para utilização no Chat.

Reiniciar

Permite reiniciar o serviço do CR.IA Business para aplicar configurações que necessitem dessa ação.

Editar um agente

A opção Editar permite alterar as configurações de um agente personalizado já existente.

Para editar um agente:

1. Selecione o agente desejado.
2. Clique em Editar.
3. Realize as alterações necessárias.
4. Salve as configurações.

As configurações disponíveis dependem do tipo e da estrutura do agente.

Importante: agentes disponibilizados como Agentes Prontos possuem configurações previamente definidas. As possibilidades de edição podem ser diferentes das disponíveis para agentes personalizados.

Associar Sistemas ao Agente

O CR.IA Business permite definir em quais Sistemas um agente poderá trabalhar.

O Sistema representa o ambiente ou a base de dados na qual o agente estará disponível. Essa configuração permite utilizar o mesmo agente em diferentes ambientes ou empresas, mesmo quando os dados estão armazenados em bases separadas.

Por exemplo, uma empresa pode possuir:

• Produção;
• Homologação.

O mesmo agente pode ser associado aos dois sistemas.

Da mesma forma, uma organização que possui diferentes empresas ou bases de dados pode disponibilizar o mesmo agente para:

• Empresa A;
• Empresa B.

Nesse cenário, cada Sistema pode estar conectado à sua própria base de dados, enquanto o agente permanece com uma configuração única.

Associar um Sistema

Para associar sistemas a um agente:

1. Selecione o agente desejado.
2. Clique em Sistemas.
3. Será apresentada a relação de sistemas disponíveis no ambiente.
4. Selecione os sistemas nos quais o agente deverá estar disponível.
5. Confirme a associação.

Utilizar o mesmo Agente em diferentes Sistemas

A possibilidade de associar um mesmo agente a diferentes sistemas permite reutilizar uma configuração sem a necessidade de criar um agente separado para cada ambiente.

Por exemplo, considere um agente chamado Análise de Vendas.

Ele pode ser associado a:

Produção – Empresa A

Homologação – Empresa A

Produção – Empresa B

Nesse cenário, o agente mantém suas configurações, enquanto os Sistemas determinam os ambientes nos quais ele poderá trabalhar.

Essa estrutura facilita a administração do ambiente e evita a criação de agentes duplicados para situações em que a mesma lógica de análise precisa ser utilizada em diferentes bases.

Sistemas e Fontes de Dados

É importante diferenciar Sistema de Fonte de Dados.

A Fonte de Dados define a estrutura das informações que o agente poderá consultar ou utilizar em suas análises.

O Sistema define o ambiente no qual o agente poderá trabalhar.

Dessa forma, os dois recursos possuem funções diferentes e complementares.

De forma simplificada:

Sistema → Fonte de Dados → Agente → Usuário

O Sistema representa o ambiente ou base de dados.

A Fonte de Dados disponibiliza as informações necessárias.

O Agente utiliza essas informações de acordo com suas configurações e instruções.

O Usuário interage com o agente por meio do Chat.

Uma mesma Fonte de Dados pode ser utilizada por diferentes agentes, e um mesmo agente pode ser associado a diferentes Sistemas, conforme a configuração do ambiente.

Para conhecer a administração das fontes disponíveis, consulte Gerenciar fontes de dados.

Definir usuários que podem utilizar um agente

O CR.IA Business permite controlar quais usuários terão acesso a cada agente.

Essa configuração é útil quando diferentes áreas ou usuários da empresa precisam utilizar agentes específicos.

Para configurar os usuários:

1. Selecione o agente desejado.
2. Clique em Usuários.
3. Selecione os usuários que deverão ter acesso ao agente.
4. Salve a configuração, quando aplicável.

Configurar filtros de dados por usuário

Além de definir quais usuários podem utilizar um agente, o CR.IA Business permite configurar filtros de dados por usuário.

Esse recurso permite restringir as informações que determinado usuário poderá consultar por meio do agente.

Por exemplo, o mesmo agente de vendas pode ser disponibilizado para diferentes usuários, mas cada usuário pode ter acesso somente aos dados relacionados à sua filial, região ou unidade.

Para configurar um filtro:

1. Acesse a configuração de Usuários do agente.
2. Selecione o usuário desejado.
3. Acesse a opção Filtros.
4. Configure as condições necessárias.

Na configuração dos filtros, podem ser definidos:

• Campo — campo da Fonte de Dados utilizado na condição;
• Operador — tipo de comparação utilizado;
• Valor — valor utilizado na condição.

Também é possível adicionar múltiplos filtros, conforme a necessidade.

Os filtros permitem adaptar o acesso aos dados de acordo com cada usuário, mantendo o mesmo agente disponível para diferentes pessoas.

Gerenciar a Fonte de Dados do Agente

As Fontes de Dados são administradas separadamente na funcionalidade Fontes de Dados.

Durante a configuração do agente, são definidas as fontes que serão utilizadas por ele.

Uma mesma Fonte de Dados pode ser utilizada por diferentes agentes, permitindo centralizar estruturas de dados e evitar configurações duplicadas.

[INSERIR IMAGEM – Configuração do agente destacando a Fonte de Dados]

Para conhecer a administração das fontes, consulte Gerenciar fontes de dados.

Ativar ou desativar um agente

Um agente pode ser temporariamente desativado quando não estiver disponível para utilização.

Quando um agente está desativado, ele não fica disponível para utilização no Chat.

Para desativar um agente:

1. Selecione o agente desejado.
2. Clique em Desativar.
3. Confirme a operação.

Para disponibilizar novamente o agente, selecione-o e utilize a opção Ativar.

Essa funcionalidade permite retirar temporariamente um agente de operação sem excluí-lo do ambiente.

Excluir um agente

A opção Excluir remove o agente do ambiente.

Antes de realizar a exclusão, certifique-se de que o agente não é mais necessário.

Para excluir:

1. Selecione o agente desejado.
2. Clique em Excluir.
3. Leia atentamente a mensagem de confirmação.
4. Clique em Confirmar para concluir.

Após a exclusão, o agente deixará de estar disponível para utilização.

Atenção: antes de excluir um agente, verifique se existem usuários, Sistemas ou outras configurações que dependam dele.

Atualizar a lista de agentes

A opção Atualizar permite carregar novamente a lista de agentes cadastrados no ambiente.

Utilize essa opção quando houver necessidade de atualizar as informações apresentadas na tela após alguma alteração realizada no ambiente.

Reiniciar o serviço

Algumas alterações realizadas nas configurações dos agentes podem exigir o reinício do serviço do CR.IA Business para que sejam aplicadas.

Nesses casos, utilize a opção Reiniciar.

Antes da confirmação, a plataforma informa que as conversas em andamento poderão ser encerradas e que as novas configurações pendentes serão aplicadas.

Após a confirmação, o serviço será reiniciado.

Atenção: recomendamos realizar o reinício em um momento adequado, pois as conversas que estiverem em andamento serão encerradas.

Agentes prontos x Agentes personalizados

O comportamento das opções de gerenciamento pode variar de acordo com o tipo de agente.

Agentes prontos

São agentes disponibilizados pela Loja de Agentes com configurações previamente definidas.

Depois de adicionados ao ambiente, podem ser administrados conforme as opções disponíveis, incluindo associação de Sistemas, usuários e disponibilidade.

Agentes personalizados

São agentes criados de acordo com as necessidades específicas da empresa.

Além das operações administrativas, esses agentes podem ser editados para alterar suas configurações, instruções, fontes de dados e demais recursos disponíveis.

Boas práticas de gerenciamento

Para manter o ambiente organizado e seguro, recomendamos:

• utilizar nomes e descrições que facilitem a identificação dos agentes;
• associar cada agente somente aos Sistemas nos quais ele realmente deverá trabalhar;
• disponibilizar cada agente somente para os usuários que precisam utilizá-lo;
• utilizar filtros de dados quando diferentes usuários precisarem acessar conjuntos de informações distintos;
• evitar a criação de agentes duplicados quando o mesmo agente puder ser utilizado em diferentes Sistemas;
• desativar agentes que estejam temporariamente indisponíveis;
• evitar a exclusão de agentes sem verificar previamente seus usuários, Sistemas e dependências;
• revisar periodicamente os agentes disponíveis no ambiente.

Observações importantes

O gerenciamento de agentes ocorre na interface padrão da plataforma e não faz parte do processo de instalação inicial.

Durante o onboarding, o usuário adiciona apenas o primeiro agente para começar rapidamente a utilizar o CR.IA Business.

Após a conclusão da instalação, novos agentes podem ser adicionados pela Loja de Agentes, agentes personalizados podem ser criados e os agentes existentes podem ser administrados pela tela Agentes.

Os Sistemas, Fontes de Dados e Usuários possuem configurações próprias e se relacionam com os agentes para determinar onde, com quais dados e por quem cada agente poderá ser utilizado.

Conclusão

A tela Agentes centraliza a administração dos agentes utilizados no CR.IA Business.

Por meio dela, os responsáveis pelo ambiente podem gerenciar os agentes, definir os Sistemas nos quais eles poderão trabalhar, controlar os usuários que terão acesso, configurar filtros de dados e administrar sua disponibilidade.

Essa estrutura permite reutilizar os mesmos agentes em diferentes empresas, ambientes e bases de dados, mantendo a administração centralizada e evitando configurações desnecessariamente duplicadas.