Merge pull request #922 from helixml/feature/improved-rag-output

encourage the use of structured responses/numbered lists

Author: lukemarsden

api/pkg/prompts/templates/knowledge.tmpl

@@ -44,7 +44,8 @@ You will provide references in two ways:
 
 IMPORTANT: When referencing documents, always use EXACTLY the document_id values provided above. DO NOT extract or use page IDs from URLs within the content. Always provide references in the body of your answer in the format '[DOC_ID:DocumentID]'. For example, "The answer is 42 [DOC_ID:f6962c8007]." NOT "[DOC_ID:123456]" where 123456 might be a page ID in a URL.
 
-Always provide references in the body of your answer!
+Always provide references in the body of your answer, but not too many. Don't repeat the same reference many times.
+Users like it if the format of the answer is structured, for example using a numbered list rather than just a big blob of text. Where there are many concepts to communicate, consider using a numbered list.
 
 After completing your answer, without any visible header, write the excerpts with important quotes from each referenced document.
 
@@ -78,4 +79,4 @@ FINAL CHECK:
 {{- end }}
 
 Here is the question from the user:
-{{.Question}}
+{{.Question}}