Pular para o conteúdo
Passo a passo

Como abrir os arquivos do pacote

Nunca abriu um arquivo .md ou .json? Sem problema. Aqui está o caminho mais simples, do jeito certo para quem não é de tecnologia e também para quem vai integrar os agentes em sistemas.

O que vem no pacote

ArquivoPara quêPara quem
Portal HTML
PORTAL_AGENTES.html		Navegar pelos agentes, buscar, ler o guia e copiar o prompt com um clique.Todo mundo. Comece por aqui.
Guia
.md (Markdown)		O guia de 9 seções de cada agente, com o prompt pronto para colar na IA.Quem quer ler ou guardar o guia como arquivo.
Agente
.json		A definição do agente em formato estruturado, para ler por programas.Uso técnico: APIs, automações e plataformas de agentes.

Quem só usa IA de chat (ChatGPT, Claude, Gemini) não precisa abrir os arquivos JSON.

1. O jeito mais fácil: o portal HTML

  1. Descompacte o arquivo ZIP que você baixou (botão direito → Extrair tudo).
  2. Abra a pasta e dê dois cliques em PORTAL_AGENTES.html. Ele abre no seu navegador, mesmo sem internet.
  3. Escolha a frente e o agente, leia o guia e use o botão de copiar no prompt.
  4. Cole na sua IA de chat, preencha as lacunas >>> INSERIR ... <<< e envie.

Deixe a pasta inteira junta: o portal precisa dos arquivos que estão ao lado dele.

2. O que é um arquivo .md (Markdown)?

Markdown é texto comum com marcações simples para dar forma ao documento: # vira título, **texto** vira negrito, - vira lista e | monta tabelas. Qualquer programa de texto abre, mas só um leitor de Markdown mostra o resultado bonito, com títulos, tabelas e listas formatados.

Se você abrir um .md no Bloco de Notas, vai ver os símbolos # e ** no meio do texto. É normal, nada está quebrado: o conteúdo continua legível e o prompt pode ser copiado do mesmo jeito.

3. Como abrir os arquivos .md

Sugestão gratuita para Windows

MD Editor (TopicDev)

Leitor e editor de Markdown de código aberto. Segundo o desenvolvedor, é gratuito (licença GNU GPL v3), sem anúncios, sem conta, sem análise de uso, e os arquivos ficam no seu computador.

  • Mostra o guia já formatado, com índice de títulos e temas de leitura.
  • Modo dividido: texto original de um lado e página formatada do outro.
  • Tabelas, listas de tarefas e abas que reabrem ao iniciar.
  • Abre uma pasta inteira de guias, com árvore de arquivos e busca em todos eles.

Funciona no Windows 10 e 11. Instalação pela Microsoft Store.

Instalar pela Microsoft Store Site do desenvolvedor

Passo a passo com o MD Editor

  1. Abra o link da Microsoft Store acima e clique em Obter ou Instalar.
  2. Com o app aberto, use o menu para abrir o arquivo (ou a pasta) do guia que você quer ler. Outra forma: clique com o botão direito no arquivo .md → Abrir com → MD Editor.
  3. Para sempre abrir .md nele: botão direito no arquivo → Abrir com → Escolher outro aplicativo → MD Editor → marque Sempre usar este aplicativo.
  4. Vá até a seção "O que copiar e colar no chat da IA?", copie o bloco de prompt e cole na sua IA.

Outras opções

  • Bloco de Notas, TextEdit ou qualquer editor de texto: abrem o .md sem instalar nada, mas mostram as marcações.
  • Mac e Linux: o MD Editor é só para Windows. Use o portal HTML (funciona em qualquer sistema) ou um editor com visualização de Markdown, como o Visual Studio Code (gratuito): abra o arquivo e use o atalho Ctrl+Shift+V (Cmd+Shift+V no Mac) para ver a versão formatada.

4. E o arquivo .json? (uso técnico)

JSON é um formato de dados que programas entendem facilmente. Cada arquivo traz a definição completa do agente, organizada em blocos:

  • agent_metadata: identificação, frente, versão e créditos.
  • persona_prompt: papel, objetivo, limites e o system_prompt pronto para uso.
  • workflow: o fluxo em etapas, com condições e o que fazer se algo faltar.
  • input_schema e output_schema: o que o agente precisa receber e o formato da entrega.
  • safety_guardrails e agent_runtime: regras de segurança e parâmetros de execução, incluindo a revisão humana.
  • agent_documentation: descrição, quando usar, exemplos e limitações.

Para ler um JSON, abra no Bloco de Notas ou no Visual Studio Code. Para usar, o caminho típico é carregar o arquivo em um programa ou plataforma de agentes e aproveitar o system_prompt como instrução do modelo. Exemplo em Python:

import json

with open("agente.json", encoding="utf-8") as f:
    agente = json.load(f)

print(agente["persona_prompt"]["system_prompt"])
print([e["nome"] for e in agente["workflow"]["steps"]])

Troque agente.json pelo nome do arquivo que você quer usar.

Dúvidas comuns

O Windows pergunta com que programa abrir o .md. E agora?
Escolha o MD Editor (ou outro leitor de Markdown) na lista. Se ele não aparecer, use Escolher outro aplicativo e procure pelo nome.
O arquivo abre cheio de # e **. Está com defeito?
Não. Esses símbolos são as marcações do Markdown. Abra com um leitor de Markdown ou pelo portal HTML para ver a versão formatada.
Preciso instalar algo para usar o portal HTML?
Não. Ele abre no navegador (Chrome, Edge, Firefox, Safari) e funciona sem internet.
Meus dados ficam seguros no MD Editor?
Segundo o desenvolvedor, os arquivos ficam no seu computador e o app não tem contas nem análise de uso. Confira as informações atualizadas na página do app antes de instalar.
Transparência. O MD Editor é um software livre de terceiros (TopicDev). Ele é apenas uma sugestão e não tem vínculo com o Agentes RJS. Você pode usar qualquer outro leitor de Markdown ou o portal HTML.

Testar com a amostra grátis Voltar para Como funciona