Create or clone your taxonomy

You can fork and clone the existing InstructLab community taxonomy, or you can create a new taxonomy from scratch in your own GitHub repo. For examples and diagrams showing how you can structure your own taxonomy, see Upstream taxonomy tree layout in the InstructLab docs.

Gather your knowledge documents

Format your knowledge documents as a Markdown .md file and store them in a directory that is separate from the taxonomy. For an example of a knowledge document, see the InstructLab documentation.

Knowledge documents are only required when adding knowledge to your taxonomy, not skills. For more information on the difference between knowledge and skills see Taxonomy data.

Create qna.yaml files for knowledge and skills

1. Create a qna.yaml file that includes questions and answers related to the knowledge or skill you want to add. The file must follow standard YAML formatting. The file must also have at least 5 seed_examples sections and, within each of those, exactly 3 question and answer pairs. For a complete list of fields required for the qna.yaml file, see the InstructLab docs for adding knowledge or skills.

2. If you are creating a qna.yaml file for a knowledge addition, you must reference the relevant knowledge document, the commit hash for the document, and the directory where it is stored in the document section of the file.

   Example knowledge document and directory reference.

   document:
       repo: https://github.com/user/my_knowledge
       commit: 0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9u
       patterns:
         - knowledge_document.md
   

3. Add the file to the correct node in your taxonomy.

In addition to creating a new qna.yaml file, you can also add question and answer pairs to existing files.

Upload your taxonomy to your Object Storage bucket

Use the UI or the CLI to upload and store your taxonomy to your Object Storage bucket.

What's next?

Learn how to generate data from your taxonomy.