Objetivo

O CR.IA Business permite criar agentes personalizados de acordo com as necessidades específicas da empresa.

Um agente personalizado pode ser configurado para interpretar perguntas, consultar dados, realizar análises, utilizar ferramentas e, quando configurado para isso, executar ações em sistemas corporativos.

Durante a criação do agente, podem ser configurados:

• Informações de identificação;
• Tipo de agente;
• Fonte de Dados;
• Instruções e comportamento do agente;
• Regras de exibição;
• Validações;
• Ferramentas e integrações;
• Outros agentes que poderão ser utilizados pelo agente.

A configuração desses recursos permite criar agentes direcionados para diferentes áreas e processos da empresa.

Acessar a criação de agentes

A criação de agentes personalizados é realizada pela tela padrão Agentes da plataforma.

Para criar um novo agente:

1. No menu lateral, acesse Agentes.
2. Clique em Novo.
3. Será aberta a tela de configuração do novo agente.

Informações gerais do agente

Na configuração inicial do agente são definidas as informações que identificam e descrevem sua finalidade.

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

Nome

Define o nome utilizado para identificar o agente no Chat.

O nome deve facilitar a identificação do agente pelo usuário.

Exemplo:

#pagar

Descrição

Apresenta de forma resumida a finalidade do agente.

Exemplo:

Agente responsável por consultas e análises de contas a pagar.

Funcionalidades

Descreve o que o agente é capaz de realizar.

Exemplo:

Consultar valores, analisar resultados, comparar períodos e identificar títulos em aberto.

Personalidade

Define o estilo de comunicação utilizado pelo agente nas respostas.

Exemplo:

Profissional, objetivo e didático.

Definir o tipo de agente

O CR.IA Business permite criar agentes com diferentes níveis de especialização.

Os principais modelos são:

Agente Genérico

Permite que o usuário faça perguntas mais abertas sobre os dados disponibilizados.

É indicado quando o objetivo é permitir uma exploração mais ampla das informações.

Agente Especializado

Possui comportamento direcionado para uma área ou processo específico.

É indicado quando o agente precisa seguir instruções, regras e padrões específicos para interpretar os dados e apresentar as respostas.

Para conhecer as características de cada modelo, consulte Visão geral.

Definir a Fonte de Dados

A Fonte de Dados determina as informações que poderão ser utilizadas pelo agente.

No CR.IA Business, a origem dos dados pode ser configurada utilizando uma Fonte de Dados Compartilhada ou um Agente Padrão, conforme os recursos disponíveis na plataforma.

Fonte de Dados Compartilhada

A opção Compartilhada permite utilizar uma Fonte de Dados previamente cadastrada na funcionalidade Fontes de Dados.

As Fontes de Dados compartilhadas podem ser utilizadas por diferentes agentes.

Para utilizar uma Fonte de Dados compartilhada:

1. Acesse a aba Fonte de Dados.
2. No campo Tipo de fonte de dados, selecione Compartilhada.
3. Selecione a Fonte de Dados desejada.
4. Continue a configuração do agente.

Os campos configurados na Fonte de Dados ficarão disponíveis para que o agente possa interpretar as perguntas e construir as consultas necessárias.

Importante: uma Fonte de Dados compartilhada pode ser utilizada por diferentes agentes. Alterações realizadas na Fonte de Dados poderão refletir nos agentes que utilizam essa estrutura.

Agente Padrão

A opção Agente Padrão permite utilizar um modelo especializado disponibilizado previamente no CR.IA Business como base para o agente.

Ao selecionar essa opção, a plataforma disponibiliza os agentes padrão disponíveis para utilização.

Esses modelos podem atender processos específicos, como análises financeiras, preços, ofertas ou processos relacionados ao segmento Agro.

A relação de agentes disponíveis pode variar conforme os recursos disponibilizados no ambiente.

Para utilizar um Agente Padrão:

1. Acesse a aba Fonte de Dados.
2. No campo Tipo de fonte de dados, selecione Agente Padrão.
3. Selecione o agente padrão desejado.
4. Continue a configuração do agente.

Definir o Prompt do Agente

O Prompt contém as instruções que orientam o comportamento do agente.

Ele define como o agente deve interpretar as solicitações e como deve utilizar as informações e recursos disponíveis.

Um prompt pode estabelecer, por exemplo:

• como interpretar determinadas perguntas;
• quais informações devem ser consideradas;
• quais regras devem ser aplicadas;
• como realizar determinadas análises;
• como tratar situações específicas;
• como responder ao usuário.

Quanto mais específico for o comportamento esperado, mais detalhadas devem ser as instruções fornecidas ao agente.

Definir regras de exibição

As Regras de Exibição orientam como as respostas devem ser apresentadas no Chat.

Elas podem definir:

• quais informações devem ser apresentadas;
• ordem das informações;
• organização das colunas;
• formato de valores e datas;
• ordenação dos resultados;
• agrupamentos;
• apresentação de totais;
• estrutura do resultado.

Por exemplo, uma regra pode determinar que os resultados sejam apresentados em uma tabela contendo Período, Centro de Custo e Valor Total, ordenados do maior para o menor valor.

As regras de exibição ajudam a manter um padrão de apresentação e tornam as respostas mais claras para os usuários.

Definir validações

As Validações permitem estabelecer regras que devem ser verificadas antes ou durante o processamento de uma solicitação.

Elas podem ser utilizadas para:

• exigir informações obrigatórias;
• impedir consultas incompletas;
• limitar consultas fora do escopo do agente;
• restringir determinados períodos;
• garantir que determinadas condições sejam atendidas.

Por exemplo:

Se o usuário não informar o período da consulta, solicite a informação antes de continuar.

Outro exemplo:

Permita consultas somente para períodos anteriores ou iguais à data atual.

As validações ajudam a reduzir consultas incorretas e manter o comportamento do agente dentro do escopo definido.

Definir ferramentas e integrações

As ferramentas permitem ampliar as capacidades do agente, permitindo que ele utilize recursos adicionais além da consulta e análise dos dados.

Um agente pode utilizar:

• Ações do Sistema (Tools);
• Outros Agentes.

Esses recursos permitem que o agente execute operações em sistemas integrados, utilize funcionalidades específicas ou consulte outros agentes para obter informações complementares.

Ações do Sistema

As Ações do Sistema (Tools) disponibilizam recursos que permitem ao agente executar operações em sistemas corporativos integrados.

Atualmente, existem recursos voltados principalmente à integração com o SAP Business One.

Dependendo das ferramentas disponíveis no ambiente, o agente poderá executar ações como:

• criar requisições;
• criar ofertas;
• criar pedidos;
• criar documentos;
• executar outros processos disponibilizados pela integração.

As ferramentas disponíveis podem variar conforme os recursos habilitados no ambiente.

Outros Agentes

Um agente também pode utilizar outros agentes como ferramentas.

Essa funcionalidade permite criar uma estrutura de agentes especializados, na qual um agente principal utiliza outros agentes para obter informações específicas.

Por exemplo, um agente de gestão financeira pode utilizar:

• #pagar para informações de contas a pagar;
• #receber para informações de contas a receber;
• #pcompras para informações relacionadas a compras;
• #pvendas para informações relacionadas a vendas.

Nesse cenário, o agente principal pode reunir as informações retornadas pelos agentes especializados e apresentar uma resposta consolidada ao usuário.

Essa abordagem permite construir agentes mais abrangentes sem concentrar toda a lógica em um único agente.

Adicionar ferramentas ao agente

Para adicionar ferramentas:

1. Acesse a aba Ferramentas.
2. Clique em Adicionar Ferramenta.
3. Selecione a categoria desejada:
   • Ações do Sistema (Tools);
   • Outros Agentes.
4. Selecione os recursos que deseja disponibilizar.
5. Clique em Salvar.

Os recursos selecionados serão apresentados na lista de ferramentas associadas ao agente.

Gerenciar ferramentas associadas

Depois de adicionar uma ferramenta, ela será apresentada na lista de recursos associados ao agente.

A lista permite identificar as ferramentas e agentes associados e, quando disponível, realizar ações de gerenciamento.

Para remover uma ferramenta:

1. Localize o recurso na lista.
2. Clique na opção de Excluir.
3. Confirme a remoção, quando solicitado.

Salvar o agente

Depois de concluir as configurações necessárias:

1. Revise as informações preenchidas.
2. Verifique a Fonte de Dados e os demais recursos associados.
3. Salve o agente.

Após o salvamento, o agente estará disponível no ambiente conforme suas configurações, Sistemas e usuários autorizados.

Sistemas do agente

Depois de criar o agente, é importante definir os Sistemas nos quais ele poderá trabalhar.

Um mesmo agente pode ser associado a diferentes Sistemas, permitindo reutilizar a mesma configuração em diferentes ambientes ou bases de dados.

Por exemplo:

• Produção – Empresa A;
• Homologação – Empresa A;
• Produção – Empresa B.

Essa configuração permite que o mesmo agente seja utilizado em diferentes ambientes sem a necessidade de criar um agente separado para cada base.

Para configurar essa associação, consulte Gerenciar agentes.

Usuários do agente

Também é possível definir quais usuários terão acesso ao agente.

Essa configuração permite disponibilizar agentes específicos para determinados usuários e, quando necessário, configurar filtros de dados individualizados.

Para conhecer essas configurações, consulte Gerenciar agentes.

Funcionamento do agente

Depois de configurado, o agente atua como uma camada inteligente entre o usuário, os dados e os recursos disponibilizados.

De forma simplificada, o fluxo pode ser representado como:

Pergunta do usuário → Interpretação → Consulta/Análise → Ferramentas → Tratamento dos resultados → Resposta

Quando necessário, o agente pode utilizar outros agentes ou ferramentas durante esse processo.

O resultado é apresentado ao usuário no Chat, de acordo com as instruções e regras definidas na configuração do agente.

Boas práticas na criação de agentes

Para obter melhores resultados, recomendamos:

Crie agentes com objetivos claros

Defina uma finalidade específica para cada agente sempre que possível.

Utilize agentes especializados para processos específicos

Agentes direcionados para uma área ou processo tendem a possuir um comportamento mais previsível e adequado à necessidade do usuário.

Escreva instruções claras

Quanto mais claro for o comportamento esperado, mais fácil será para o agente seguir as regras definidas.

Utilize regras de exibição

Padronize a apresentação dos resultados para facilitar a interpretação das informações.

Utilize validações quando necessário

Defina condições que impeçam consultas incompletas ou fora do escopo do agente.

Reutilize Fontes de Dados

Quando diferentes agentes precisam acessar a mesma estrutura de dados, considere utilizar uma Fonte de Dados compartilhada.

Reutilize agentes quando possível

Quando o mesmo comportamento precisar ser utilizado em diferentes ambientes ou empresas, considere associar o agente a diferentes Sistemas em vez de criar agentes duplicados.

Observações importantes

A criação de agentes personalizados é realizada pelas funcionalidades padrão da plataforma e não faz parte do onboarding de instalação.

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

Após a instalação, novos agentes personalizados podem ser criados a qualquer momento pela tela Agentes.

A configuração de Sistemas, Fontes de Dados e Usuários é independente e complementa a configuração do agente, permitindo determinar onde o agente poderá trabalhar, quais informações poderá utilizar e quais usuários terão acesso.

Conclusão

A criação de agentes personalizados permite adaptar o CR.IA Business às necessidades específicas de cada empresa, área ou processo.

Por meio da configuração de fontes de dados, instruções, regras, validações, ferramentas, outros agentes, Sistemas e usuários, é possível construir agentes capazes de realizar desde consultas simples até análises e processos mais complexos.

Após sua criação, o agente passa a ser administrado pela tela Agentes, onde suas configurações, Sistemas, usuários e disponibilidade podem ser gerenciados.