Update readme for 0.5.0 (#284)

* set temperature to 0.0 in examples

* fix link

* include python example in readme

* keep temperature in config file

README.md

@@ -65,9 +65,31 @@ models like Falcon, Dolly or LLaMA), ensure to that your API keys are set as env
 
 Create a new API key from openai.com or fetch an existing one, and ensure the
 keys are set as environmental variables. For more background information, see
-the [OpenAI](/api/large-language-models#gpt-3-5) section.
+the documentation around setting [API keys](https://spacy.io/api/large-language-models#api-keys).
 
-Create a config file `config.cfg` containing at least the following (or see the
+### In Python code
+
+To do some quick experiments, from 0.5.0 onwards you can run:
+
+```python
+import spacy
+
+nlp = spacy.blank("en")
+llm = nlp.add_pipe("llm_textcat")
+llm.add_label("INSULT")
+llm.add_label("COMPLIMENT")
+doc = nlp("You look gorgeous!")
+print(doc.cats)
+# {"COMPLIMENT": 1.0, "INSULT": 0.0}
+```
+
+By using the `llm_textcat` factory, the latest version of the built-in textcat task is used, 
+as well as the default GPT-3-5 model from OpenAI.
+
+### Using a config file
+
+To get more control over the various parameters of the `llm` pipeline, 
+create a config file `config.cfg` containing at least the following (or see the
 full example
 [here](https://github.com/explosion/spacy-llm/tree/main/usage_examples/textcat_openai)):
 
@@ -82,7 +104,7 @@ pipeline = ["llm"]
 factory = "llm"
 
 [components.llm.task]
-@llm_tasks = "spacy.TextCat.v2"
+@llm_tasks = "spacy.TextCat.v3"
 labels = ["COMPLIMENT", "INSULT"]
 
 [components.llm.model]

usage_examples/multitask_openai/fewshot.cfg

@@ -21,6 +21,7 @@ path = ${paths.examples}
 [components.llm_ner.model]
 @llm_models = "spacy.Text-Davinci.v2"
 name = "text-davinci-003"
+config = {"temperature": 0.0}
 
 [components.llm_textcat]
 factory = "llm"
@@ -37,3 +38,4 @@ path = ${paths.examples}
 [components.llm_textcat.model]
 @llm_models = "spacy.Text-Davinci.v2"
 name = "text-davinci-003"
+config = {"temperature": 0.0}

usage_examples/multitask_openai/zeroshot.cfg

@@ -14,12 +14,13 @@ labels = SIZE,TYPE,TOPPING,PRODUCT
 [components.llm_ner.model]
 @llm_models = "spacy.Text-Davinci.v2"
 name = "text-davinci-003"
+config = {"temperature": 0.0}
 
 [components.llm_textcat]
 factory = "llm"
 
 [components.llm_textcat.task]
-@llm_tasks = "spacy.TextCat.v2"
+@llm_tasks = "spacy.TextCat.v3"
 labels = INFORMATION,ORDER
 exclusive_classes=True
 

usage_examples/streamlit/streamlit_app.py

@@ -22,7 +22,7 @@
 [components.llm.backend]
 @llm_models = "spacy.REST.v1"
 api = "OpenAI"
-config = {"model": "gpt-3.5-turbo", "temperature": 0.3}
+config = {"model": "gpt-3.5-turbo", "temperature": 0.0}
 
 [components.llm.task]
 @llm_tasks = "spacy.NER.v2"
@@ -47,7 +47,7 @@
 [components.llm.backend]
 @llm_models = "spacy.REST.v1"
 api = "OpenAI"
-config = {"model": "gpt-3.5-turbo", "temperature": 0.3}
+config = {"model": "gpt-3.5-turbo", "temperature": 0.0}
 
 [components.llm.task]
 @llm_tasks = "spacy.TextCat.v2"

usage_examples/textcat_openai/fewshot.cfg

@@ -13,6 +13,7 @@ factory = "llm"
 
 [components.llm.model]
 @llm_models = "spacy.GPT-3-5.v2"
+config = {"temperature": 0.0}
 
 [components.llm.task]
 @llm_tasks = "spacy.TextCat.v2"

usage_examples/textcat_openai/zeroshot.cfg

@@ -10,6 +10,7 @@ factory = "llm"
 
 [components.llm.model]
 @llm_models = "spacy.GPT-3-5.v2"
+config = {"temperature": 0.0}
 
 [components.llm.task]
 @llm_tasks = "spacy.TextCat.v2"