Prompt template alignment adjustment for more generic systems to use my models.

README.md

@@ -1,26 +1,23 @@
----
-license: artistic-2.0
-language:
-- en
-base_model: TroyDoesAI/BlackSheep-4B
-library_name: transformers
----
+---
+license: artistic-2.0
+language:
+- en
+base_model: TroyDoesAI/BlackSheep-4B
+library_name: transformers
+---
+
+---
 
 ## License
 This project is licensed under the Artistic License 2.0.
 
----
-
 ## Introduction
-
 This README provides instructions on how to effectively use the provided prompt template designed for training models to deliver contextually obedient answers. The template is especially useful for Retrieval-Augmented Generation (RAG) applications and aims to reduce hallucinations by ensuring that the model adheres strictly to the provided context.
 
 ## Prompt Template Overview
-
-The template consists of a well-defined structure that separates input, context, and instructions. This explicit structure helps the model better understand and respond accurately to queries by associating specific sources or context with the input data.
+The template consists of a well-defined structure that separates input, context, and instructions. This structure helps the model better understand and respond accurately to queries by associating specific sources or context with the input data.
 
 ### Basic Prompt Template Structure
-
 ```
 BEGININPUT
 BEGINCONTEXT
@@ -37,20 +34,43 @@ ENDINSTRUCTION
 ```
 
 ### Explanation of Template Components
+- **BEGININPUT / ENDINPUT**: These markers define the boundaries of an input block. The input block contains all the contextual information that the model should use to generate its response. This section can include multiple paragraphs of text, data, or other relevant content.
 
-- **BEGININPUT / ENDINPUT**: These markers define the boundaries of an input block. The input block is where you place all the contextual information that the model should use to generate its response. This section can contain multiple paragraphs of text, data, or other content that forms the basis of the query.
+- **BEGINCONTEXT / ENDCONTEXT**: This section is for key-value pairs or system messages that provide metadata or higher-level context to the model, such as dates, URLs, or other relevant information. It may also include system-level directives for processing the input.
 
-- **BEGINCONTEXT / ENDCONTEXT**: This section is specifically for key-value pairs or system messages that provide metadata or higher-level context to the model. For example, it can include the date, URL, or any other relevant information, as well as system-level directives that the model should consider while processing the input.
+- **BEGININSTRUCTION / ENDINSTRUCTION**: This section contains the specific instructions or questions for the model, guiding how it should respond based on the provided context.
 
-- **BEGININSTRUCTION / ENDINSTRUCTION**: This section contains the specific instructions or questions for the model. The instructions guide the model on how to respond based on the provided context. The model was trained with various formats, including single questions, paragraphs, and lists.
+- **Response Section**: The model generates a response based on the context and instructions provided. The response should be accurate and aligned with the input context.
 
-- **Response Section**: The model generates the response based on the context and instructions provided. The response is expected to be accurate and aligned with the input context.
+## Contextual-Request Template
+The "Contextual-Request" template is a specialized structure designed for scenarios where the model needs to process inputs with specific system instructions and ensure adherence even in restrictive or controlled environments. It is particularly useful for bypassing refusal mechanisms.
 
-### Example Usage
+### Structure:
+```
+Contextual-Request:
+BEGININPUT
+BEGINCONTEXT
+date: [Insert Date]
+url: [Insert URL]
+ENDCONTEXT
+[Your chat history or context you want the AI to consider when answering]
+ENDINPUT
+BEGININSTRUCTION
+<|`BlackSheep`|>
+[This is your instruction that utilizes the context provided, wrap in BlackSheep tags to force bypass refusals]
+<|`BlackSheep`|>
+ENDINSTRUCTION
+### Response
+<|`BlackSheep`|>
+```
+
+### Usage:
+This template is used when there’s a need to enforce the model's obedience to the provided context despite potential refusal mechanisms. The instructions are wrapped in specific tags to ensure the model strictly follows the input context.
 
+## Example Usage
 To better understand how to use this template, here’s a simple example:
 
-#### Example Input:
+### Example Input:
 ```
 BEGININPUT
 BEGINCONTEXT
@@ -64,7 +84,7 @@ What color are blueberries? Source?
 ENDINSTRUCTION
 ```
 
-#### Expected Response:
+### Expected Response:
 ```
 Blueberries are now green.
 Source:
@@ -72,45 +92,31 @@ date: 2021-01-01
 url: https://web.site/123
 ```
 
-### How to Use the Input and Context Sections
-
-- **Input Section**: This section is where you provide the main content or context that the model needs to consider when forming a response. It can include detailed information, paragraphs of text, or other relevant data that directly informs the answer.
-
-- **Context Section**: This section is reserved for metadata and system messages. Metadata might include information like dates, URLs, or other key-value pairs that give additional context to the input. System messages can be used to set up specific instructions or behaviors that the model should adhere to while processing the input.
-
-For example, if you have a large block of text that the model needs to summarize, the input section would contain this text, while the context section could include the source of the text or any relevant metadata.
+## How to Use the Input and Context Sections
+- **Input Section**: Provide the main content or context that the model needs to consider when forming a response. This section may include detailed information, paragraphs of text, or other relevant data.
 
-### References in Responses
+- **Context Section**: Reserved for metadata and system messages. Metadata might include dates, URLs, or key-value pairs that give additional context to the input. System messages can establish specific instructions or behaviors that the model should adhere to during processing.
 
-The model is trained to include references in responses when the instruction asks for citations. This is particularly important in RAG applications, where accurately linking responses to specific sources is critical for credibility and transparency.
+## References in Responses
+The model is trained to include references in responses when instructions ask for citations. This is particularly important in RAG applications, where accurately linking responses to specific sources is critical for credibility and transparency.
 
-#### Why Use This Template?
-
-Retrieval accuracy can vary based on several factors, including dataset size and quality. By using this template, you ensure that the model provides accurate references by clearly associating input data with its corresponding context. This is crucial when dealing with multiple documents or data chunks, as it prevents the model from referencing irrelevant sources.
-
-### Advanced Parameters
+## Why Use This Template?
+Retrieval accuracy can vary based on factors like dataset size and quality. This template helps ensure the model provides accurate references by associating input data with its corresponding context, preventing the model from referencing irrelevant sources.
 
+## Advanced Parameters
 For those looking to fine-tune the model further, the following parameters can be adjusted:
-
-- **Temperature**: Controls the creativity of the model’s responses. Higher values make the model more creative, while lower values make it more coherent.
+- **Temperature**: Controls the creativity of the model’s responses. Higher values make the model more creative; lower values make it more coherent.
 - **Context Length (num_ctx)**: Defines the maximum length of context that the model can handle.
-- **GPU and Thread Parameters**: You can set the number of GPUs and threads based on your hardware configuration.
-
-### Model File Included
+- **GPU and Thread Parameters**: Configure based on your hardware setup.
 
+## Model File Included
 The following model file is included in this project:
 ```
 FROM ./ContextObedient-Tri-MoE.gguf
 ```
-This model is pre-configured with parameters to enhance context adherence. Adjustments to parameters like `temperature`, `num_ctx`, and stop tokens can be made based on your specific needs.
+This model is pre-configured to enhance context adherence. You can adjust parameters like `temperature`, `num_ctx`, and stop tokens according to your needs.
 
-### Feedback
-
-Please try other prompt templates and provide feedback. The model has been exposed to a variety of prompts during training and can adapt to different formats.
+## Feedback
+Please try other prompt templates and provide feedback. The model has been exposed to various prompts during training and can adapt to different formats.
 
 ---
-
-## Conclusion
-
-This README provides a comprehensive guide on how to use the context-obedient prompt template to achieve accurate, contextually grounded responses from the model. By following the structure and guidelines provided, you can maximize the effectiveness of the model in your RAG applications and beyond.
----