Atualização do Conhecimento do GPT

Esta página orienta como manter atualizado o conhecimento dos GPTs da CEBI quando surgirem novas funcionalidades, novas telas, alterações de fluxo ou novas imagens oficiais.

O objetivo é garantir que o GPT responda com base no conteúdo oficial da CEBI, usando textos e imagens corretas.

1. Regra Principal

Todos os manuais usados pelos GPTs devem ficar no CEBI Wiki, preferencialmente em formato Markdown.

Esse formato é o mais indicado porque:

• o texto fica estruturado por títulos, listas e passos;
• o GPT consegue entender melhor o conteúdo;
• as imagens ficam vinculadas ao manual;
• a manutenção fica centralizada no Wiki;
• novas funcionalidades podem ser documentadas sem recriar todo o material.

2. Acesso Do Manual

O manual precisa estar público ou acessível sem login para que o GPT consiga consultar o conteúdo e carregar as imagens.

Importante:

Se o manual ou as imagens exigirem login, o GPT pode não conseguir acessar corretamente.

Portanto:

• a página do manual no CEBI Wiki deve estar pública;
• as imagens usadas no manual também devem estar públicas;
• os links das imagens devem abrir diretamente no navegador;
• não usar imagens protegidas por login, sessão ou token temporário.

Caso precisem de uma nova alternativa, exporte o manual em HTML e peça para a infraestrutura hospedar um link e utilize o mesmo no conhecimento do chat.

3. Cuidados Com Dados Sensíveis

Como o manual e as imagens precisam estar públicos, nenhum print pode conter dados sensíveis.

Antes de publicar imagens no Wiki, remover ou mascarar os dados necessários.

4. Padrão Das Imagens

As imagens devem representar exatamente a tela ou etapa explicada.

Recomendações:

Formato: PNG
Qualidade: boa leitura
Dados sensíveis: removidos ou mascarados
Nome do arquivo: claro e padronizado
Local: anexado/publicado no CEBI Wiki
Acesso: público

Exemplos de nomes:

gd-login.png
gd-painel-inicial.png
gd-criar-documento-passo-01.png
gd-criar-documento-passo-02.png
gd-consultar-documento-filtro.png
gd-assinar-documento.png

5. O Que É O Mapa De Imagens

O mapa de imagens é uma tabela que relaciona cada imagem do manual com:

• produto;
• funcionalidade;
• etapa;
• URL da imagem;
• descrição da tela;
• quando o GPT deve usar aquela imagem.

Ele serve para orientar o GPT a usar a imagem correta no momento certo.

Estrutura recomendada:

produto
funcionalidade
etapa
titulo_da_secao
url_da_imagem
descricao_da_imagem
quando_usar
observacoes

Exemplo:

produto: Gestão de Documentos (GD)
funcionalidade: Criar documento
etapa: 1
titulo_da_secao: Acessar criação de documento
url_da_imagem: https://wiki.cebi.com.br/uploads/images/gd-criar-documento-passo-01.png
descricao_da_imagem: Tela inicial do módulo de documentos com o botão Novo Documento
quando_usar: Quando o usuário perguntar como iniciar a criação de um documento no GD
observacoes: Usar antes da imagem do formulário de cadastro

7. Como Extrair O HTML Do CEBI Wiki

Para solicitar o mapa de imagens ao Codex, o ideal é enviar o HTML da página do manual.

Deve exportar a página do Wiki em HTML.

• títulos;
• textos do passo a passo;
• links das imagens;
• ordem correta das seções.

Olhe o manual do GD, exemplo.

8. Como Pedir Ao Codex Para Criar O Mapa De Imagens

Use este modelo quando a página já estiver no CEBI Wiki e o HTML tiver sido extraído.

Codex, preciso criar o mapa de imagens do GPT a partir do HTML extraído do CEBI Wiki.

Produto:
[Nome do produto]

GPT:
[Nome do GPT]

Página do Wiki:
[URL pública da página]

HTML extraído:
[colar o HTML ou anexar o arquivo HTML]

O que preciso que você faça:
1. Ler o HTML da página.
2. Identificar todos os títulos, seções, passos e imagens.
3. Mapear cada imagem com a funcionalidade correta.
4. Criar uma tabela de mapa de imagens com:
   - produto
   - funcionalidade
   - etapa
   - titulo_da_secao
   - url_da_imagem
   - descricao_da_imagem
   - quando_usar
   - observacoes
5. Avisar se alguma imagem estiver sem contexto claro.
6. Avisar se alguma imagem não estiver pública.
7. Gerar o arquivo final em Markdown para subir no conhecimento do GPT.

Importante:
- usar somente o conteúdo oficial do CEBI Wiki;
- não inventar etapas;
- não incluir dados sensíveis;
- manter a ordem original do manual;
- apontar imagens duplicadas, ausentes ou confusas.

9. Como Pedir Atualização Quando O Manual Mudar

Use este modelo quando uma funcionalidade nova ou alterada for publicada no Wiki.

Codex, preciso atualizar o conhecimento do GPT do produto [NOME DO PRODUTO].

Motivo da atualização:
[Explique o que mudou]

Página do CEBI Wiki:
[URL pública da página atualizada]

HTML extraído da página:
[colar o HTML ou anexar o arquivo HTML]

O que preciso que você faça:
1. Comparar o conteúdo novo com o mapa de imagens atual, se eu enviar.
2. Identificar novas funcionalidades, novas etapas ou alterações.
3. Atualizar o mapa de imagens.
4. Indicar imagens novas, removidas, duplicadas ou sem contexto.
5. Gerar a versão final do arquivo de conhecimento em Markdown.
6. Informar o que deve ser atualizado no GPT Builder.

Regras:
- todos os links precisam vir do CEBI Wiki;
- imagens devem estar públicas;
- imagens não podem conter dados sensíveis;
- não usar API da OpenAI;
- não coletar dados;
- usar apenas material oficial da CEBI.

10. Como Atualizar No GPT Builder

Passo a passo geral:

1. Acessar o ChatGPT com a conta responsável pelo GPT (Conta do Cristiano).
2. Abrir o GPT correspondente.
3. Clicar em Editar GPT.
4. Ir na área de Conhecimento.
5. Remover arquivos antigos que foram substituídos.
6. Enviar os novos arquivos em Markdown, HTML, por exemplo:
   - manual extraído/organizado do CEBI Wiki
   - mapa de imagens
   - changelog da atualização, se existir
7. Revisar as instruções do GPT, se a funcionalidade mudou.
8. Salvar.
9. Testar perguntas reais.

11. Testes Obrigatórios Depois Da Atualização

Após atualizar o GPT, testar:

1. Pergunta geral sobre a funcionalidade nova.
2. Pergunta pedindo passo a passo.
3. Pergunta pedindo imagem oficial.
4. Pergunta sobre funcionalidade antiga alterada.
5. Pergunta fora do escopo, para validar que o GPT não inventa resposta.

Exemplos:

Como criar um novo documento no GD?
Pode mostrar com imagens?
Onde encontro a tela de consulta de documentos?
O que mudou no fluxo de assinatura?
Se eu não encontrar essa opção, o que devo fazer?

12. Padrão De Resposta Esperado Do GPT

O GPT deve:

- responder com base no manual oficial do CEBI Wiki;
- usar imagens somente quando forem relevantes;
- usar links públicos das imagens do Wiki;
- explicar em passos curtos;
- avisar quando não houver imagem oficial cadastrada;
- orientar o usuário a acionar suporte quando necessário;
- não solicitar dados sensíveis;
- não inventar telas ou funcionalidades.

13. Arquivos Recomendados Para Manter

/conhecimento-gpt/
  manual-gd-wiki.md
  mapa-imagens-gd.md
  changelog-conhecimento-gpt.md

Observação:

As imagens devem ficar no CEBI Wiki, não dentro de uma pasta local privada.

14. Observação Sobre A Extensão

A extensão Assistentes CEBI apenas abre os GPTs oficiais nos navegadores.

Ela não controla o conhecimento interno do GPT.

Quando o conteúdo do assistente precisar mudar, a atualização deve ser feita:

1. No manual público do CEBI Wiki.
2. No mapa de imagens.
3. Nos arquivos de conhecimento do GPT Builder.
4. Nas instruções do GPT, se necessário.