ER_004 - Contexto

Descrição

O Contexto é uma funcionalidade que permite personalizar o comportamento e as respostas do IAGO por meio de instruções e definições específicas. Ao ativar um contexto, você incorpora automaticamente um conjunto de orientações à conversa, alterando a forma como o assistente responde às suas solicitações.

Essa funcionalidade é útil quando você precisa que o IAGO adote um perfil específico, linguagem particular ou direcionamento especial nas respostas. Por exemplo, você pode criar um contexto para “Servidor do Tribunal de Contas” que instrua o IAGO a considerar normas, regulamentações internas e protocolos institucionais em suas respostas.

Atores

Analista

Pode executar todos os fluxos.

Gestor do Setor

Pode executar todos os fluxos.

Administrador

Pode executar todos os fluxos.

Tela

Tela 01

Elemento	Tipo	Valores Possíveis	Valor Padrão	Observação
Contextos	Aba de navegação			Define a visualização para exibir a lista de contextos cadastrados, permitindo pesquisa, ativação e gerenciamento dos mesmos.
Pesquisar	Alfanumérico			Permite localizar contextos específicos pela busca de palavras-chave presentes no título ou descrição.
Cartão de Contexto	Cartão			Apresenta um contexto com título (ex.: Servidor do Tribunal de Contas, Analista de Sistemas SR), descrição resumida e ações associadas ao contexto.
Ver Mais	Botão			Ao clicar, expande a visualização do cartão para exibir a descrição completa do contexto selecionado.
Utilizar Contexto	Ativador (toggle)	Ativo, Inativo.	Inativo	Quando ativado, incorpora o contexto na conversa atual, aplicando automaticamente as instruções e definições do contexto às respostas do IAGO.
Editar	Ícone de ação			Permite editar o título e a descrição do contexto selecionado.
Excluir	Ícone de ação			Remove permanentemente o contexto após confirmação do usuário.

Tela 02

Elemento	Tipo	Obrigatório	Observação
Editar Contexto	Modal		Edição exibida ao acionar a ação de editar um contexto, permitindo alterar título e descrição do mesmo.
Título	Alfanumérico	Sim	O título do contexto a ser editado.
Editor de Descrição	Área de texto	Sim	Campo para redigir ou alterar a descrição completa do contexto, com suporte a formatação (negrito, itálico, tachado, sublinhado, listas ordenadas e não ordenadas).
Fechar	Botão		Fecha o modal de edição sem salvar as alterações realizadas.
Salvar	Botão	Sim	Valida os campos obrigatórios e salva as alterações realizadas no contexto, fechando o modal e retornando à tela de Contextos.

Tela 03

Elemento	Tipo	Obrigatório	Observação
Confirmação da Remoção	Modal		Confirmação exibida ao acionar a ação de remover um contexto, apresentando a mensagem de alerta sobre a exclusão permanente do contexto.
Fechar	Botão		Fecha o modal de confirmação sem remover o contexto, mantendo o registro inalterado.
Confirmar	Botão	Sim	Confirma a remoção e exclui permanentemente o contexto dos servidores do sistema, retornando à tela de Contextos.

Tela 04

Elemento	Tipo	Obrigatório	Observação
Aba Criar Contextos	Aba de navegação		Exibe a interface para criação de um novo contexto com instruções e definições para o IAGO.
Título	Alfanumérico	Sim	Título do novo contexto a ser criado.
Editor de Descrição	Área de texto	Sim	Descrição completa do contexto, com instruções e orientações que serão aplicadas às respostas do IAGO, com suporte a formatação (negrito, itálico, tachado, sublinhado, listas ordenadas e não ordenadas).
Cancelar	Botão		Fecha o modal de criação sem salvar o novo contexto, retornando à tela anterior.
Criar	Botão	Sim	Valida os campos obrigatórios, cria o novo contexto e o disponibiliza na aba Contextos para uso nas conversas, exibindo mensagem de sucesso.

Tela 05

Elemento	Tipo	Obrigatório	Valores Possíveis	Valor Padrão	Observação
Contexto Ativo	Badge/Tag				Exibe visualmente o contexto ativado na conversa atual (ex.: “Servidor do Tribunal de Contas”), com ícone indicador de status ativo (ponto verde) e botão X para remover/desativar o contexto da conversa em andamento.

Fluxos

Fluxo 01 - Criar Contextos

Passo	Ação	Regra	Tela
01	O usuário acessa a aba “Criar Contextos” na funcionalidade Contexto.	RN01	Tela 04
02	O sistema exibe o formulário de criação de contexto com os campos “Título” e editor de conteúdo com barra de formatação.		Tela 04
03	O usuário preenche o título, descreve o contexto no editor (com instruções e orientações para o IAGO) e clica no botão “Criar”.		Tela 04
04	O sistema valida os campos obrigatórios, cria o novo contexto e o disponibiliza na aba “Contextos” para uso nas conversas, exibindo mensagem de sucesso.		Tela 04

Fluxo 02 - Utilizar Contexto

Passo	Ação	Regra	Tela
01	O usuário, na aba “Contextos”, visualiza um contexto e clica em “Utilizar Contexto” para ativá-lo.	RN01, RN02	Tela 01
02	O sistema incorpora o contexto à conversa ativa, aplicando automaticamente as instruções e definições do contexto às futuras respostas do IAGO.
03	O sistema exibe um marcador visual indicando que o contexto está ativo na conversa atual, permitindo sua que o usuário possa removê-lo.	RN03, RN04	Tela 05

Fluxo 03 - Editar Contexto

Passo	Ação	Regra	Tela
01	O usuário, na aba “Contextos”, clica no ícone de edição de um contexto desejado.	RN01	Tela 01
02	O sistema exibe o modal “Editar Contexto”, carregando o título e a descrição completa do contexto para edição.		Tela 02
03	O usuário altera o título e/ou a descrição do contexto no editor e clica no botão “Salvar”.		Tela 02
04	O sistema valida os campos obrigatórios, atualiza o contexto e o mantém disponível na aba “Contextos”, exibindo mensagem de confirmação da edição.		Tela 01

Fluxo 04 - Remover Contexto da conversa

Passo	Ação	Regra	Tela
01	O usuário, na tela de Conversa com um contexto ativo, clica no botão “X” do marcador (badge) de contexto ativo para removê-lo da conversa.	RN02	Tela 05
02	O sistema desativa o contexto da conversa atual, removendo o marcador visual e cessando a aplicação das instruções do contexto às respostas do IAGO, nas próximas interações.

Fluxo 05 - Excluir Contexto

Passo	Ação	Regra	Tela
01	O usuário, na aba “Contextos”, clica no ícone de exclusão (lixeira) de um contexto desejado.	RN01	Tela 01
02	O sistema exibe o modal “Atenção” perguntando se o usuário deseja realmente remover o contexto, informando que a ação é permanente e irreversível.		Tela 03
03	O usuário clica no botão “Confirmar” para remover o contexto.		Tela 03
04	O sistema remove permanentemente o contexto dos servidores, atualiza a listagem de contextos e exibe mensagem de confirmação da exclusão.

Regras de Negócio

Regra	Descrição
RN01	Contextos são pessoais e privados; cada usuário pode criar, visualizar, editar e excluir apenas os contextos por ele criados. Usuários não possuem acesso a contextos criados por outros usuários, garantindo a privacidade e personalização das definições de contexto por usuário logado no sistema.
RN02	O contexto pode ser adicionado ou removido de uma conversa a qualquer momento, independentemente do estágio ou duração da conversa. O usuário pode ativar ou desativar um contexto durante o curso da interação, sem necessidade de reiniciar ou encerrar a conversa.
RN03	O Contexto aplicado, permanecerá habilitado para uma nova conversa (iniciada a partir do botão “Novo”), em conversas atuais (em andamento) ou em conversas retomadas (histórico). O contexto permanecerá ativo para todas as conversas.
RN04	Uma conversa pode possuir apenas um contexto ativo por vez. Caso o usuário ative um novo contexto enquanto outro já está ativo, o contexto anterior será automaticamente desativado e substituído pelo novo contexto. O marcador (badge) de contexto ativo refletirá sempre apenas o contexto correntemente em uso na conversa.