Como as taxonomias são estruturadas para Inferência de IA da Red Hat
Uma taxonomia é um diretório de arquivos que contém os dados que você fornece ao modelo. Ela está organizada em uma estrutura em cascata, na qual cada subdiretório, ou “ramo”, da “árvore” taxonômica termina em um “nó-folha”, que é um conjunto
de arquivos que contêm os dados relevantes. Você pode contribuir para uma taxonomia adicionando um “ramo” totalmente novo ou inserindo novos dados em um arquivo qna.yaml já existente. Para obter mais informações sobre a estrutura
da taxonomia, consulte “Sobre a taxonomia do Red Hat AI Inference ” na documentação do Red Hat AI Inference. Você também pode consultar a taxonomia do Red Hat AI Inference em GitHub.
Red Hat AI Inference Os recursos de alinhamento de modelos, geração de dados sintéticos e gerenciamento de taxonomia estão obsoletos e serão removidos em 25 de setembro de 2026. Para dar continuidade aos fluxos de trabalho de personalização e alinhamento de modelos, migre para o Red Hat® OpenShift® AI On OpenShift. Saiba mais sobre a IA d Red Hat® OpenShift®.
Para saber como criar ou adicionar itens a uma taxonomia, consulte a seção “Preparação de taxonomias ”.
Dados taxonômicos
Existem três categorias de dados na taxonomia.
- Knowledge
- Dados e fatos comprovados por fontes como livros didáticos ou enciclopédias. Ao adicionar conhecimento a uma taxonomia, é necessário fazer referência a um documento de conhecimento separado, que existe fora do diretório da taxonomia e funciona como fonte de referência.
- Competências básicas
- Habilidades básicas, como matemática, linguagem e programação, que podem ser utilizadas para adquirir mais conhecimento. Essas habilidades são geralmente desenvolvidas com base em dados públicos.
- Habilidades de composição
- Competências que combinam conhecimento e habilidades básicas para realizar tarefas mais complexas, como a análise do mercado de ações.
Para obter mais informações sobre as categorias, consulte “O que é uma ‘habilidade’?” e “O que é ‘conhecimento’?” na documentação do Red Hat AI Inference.
Arquivos de taxonomia
Existem dois tipos de arquivos de dados necessários para cada “nó folha”.
qna.yaml- Inclui perguntas e respostas relacionadas às informações contidas no documento de conhecimento. As perguntas e respostas estão organizadas em pares chave/valor.
attribution.txt- Inclui as fontes das informações adicionadas ao arquivo
qna.yaml. Isso é opcional, mas é obrigatório para contribuições ao repositório de taxonomia de código aberto Red Hat AI Inference.
Documentos de conhecimento
Qualquer conhecimento adicionado a uma taxonomia deve ser respaldado por um documento de conhecimento, que funciona como fonte de referência para as informações fornecidas ao modelo. O documento deve ser um arquivo do tipo “ Markdown ” que esteja
em um diretório separado da taxonomia. Você deve indicar o documento de conhecimento e o diretório em que ele está armazenado na seção “ document_outline ” do arquivo “ qna.yaml ”. Para obter mais informações e exemplos
de um documento de conhecimento, consulte “Preparação de seus documentos de conhecimento ” e “Exemplo de referência de arquivo de documento de conhecimento ”.
Arquivos da seção “ qna.yaml ” da Knowledge Base
O arquivo “ qna.yaml ” de conhecimento inclui perguntas e respostas baseadas nas informações contidas no documento de conhecimento correspondente. As perguntas e respostas são armazenadas como pares chave/valor, sendo necessário
um mínimo de cinco pares para cada arquivo qna.yaml. No final do arquivo qna.yaml , na seção document_outline , você deve indicar o documento de conhecimento e o diretório
em que ele está armazenado. Para conhecer todos os requisitos do arquivo “ qna.yaml ” e ver exemplos de contribuições de conhecimento, consulte o arquivo modelo “ qna.yaml ” e o “Exemplo de envio de conhecimento ”.
Arquivos de habilidades “ qna.yaml ”
A seção “Habilidades” qna.yaml contém perguntas e respostas que ensinam uma tarefa simples. Para ensinar um modelo a rimar, por exemplo, você pode incluir uma pergunta como “ What are 5 words that rhyme with skill? ”, cuja resposta seria “ spill, mill, drill, fill, chill ”. As perguntas e respostas são armazenadas como pares chave/valor, sendo necessário um mínimo de cinco pares para cada arquivo qna.yaml.
As habilidades que você adicionar podem ser “ancoradas”, ou seja, exigem informações adicionais para fornecer contexto, ou “não ancoradas”, ou seja, não exigem nenhum contexto adicional. Para habilidades fundamentais, você adiciona o contexto
no arquivo qna.yaml por meio do campo context . Ao adicionar uma competência fundamentada a uma taxonomia, ela deve estar em um ramo que comece com a palavra “ grounded ”,
como, por exemplo, “ grounded/games/sudoku ”.
Para conhecer todos os requisitos do qna.yaml e ver exemplos de contribuições de habilidades, consulte a seção “The skills files” na documentação do Red Hat AI Inference. Observe que não é necessário anexar um documento separado ao adicionar habilidades.