# 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:

```text
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:

```text
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:

```text
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:

```text
produto
funcionalidade
etapa
titulo_da_secao
url_da_imagem
descricao_da_imagem
quando_usar
observacoes
```

Exemplo:

```text
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.

```text
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.

```text
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:

```text
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:

```text
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:

```text
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:

```text
- 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

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

Observação:

```text
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:

```text
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.
```