Merge branch 'main' into updating_function_calls_with_chat_models_cookbook

Author: jordanellis-oai

articles/openai-harmony.md

@@ -6,7 +6,7 @@ The [`gpt-oss` models](https://openai.com/open-models) were trained on the harmo
 
 ### Roles
 
-Every message that the model processes has a role associated with it. The model knows about three types of roles:
+Every message that the model processes has a role associated with it. The model knows about five types of roles:
 
 | Role        | Purpose                                                                                                                                                                                 |
 | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -91,14 +91,14 @@ convo = Conversation.from_messages(
         Message.from_role_and_content(Role.USER, "What is the weather in Tokyo?"),
         Message.from_role_and_content(
             Role.ASSISTANT,
-            'User asks: "What is the weather in Tokyo?" We need to use get_weather tool.',
+            'User asks: "What is the weather in Tokyo?" We need to use get_current_weather tool.',
         ).with_channel("analysis"),
         Message.from_role_and_content(Role.ASSISTANT, '{"location": "Tokyo"}')
         .with_channel("commentary")
-        .with_recipient("functions.get_weather")
+        .with_recipient("functions.get_current_weather")
         .with_content_type("<|constrain|> json"),
         Message.from_author_and_content(
-            Author.new(Role.TOOL, "functions.lookup_weather"),
+            Author.new(Role.TOOL, "functions.get_current_weather"),
             '{ "temperature": 20, "sunny": true }',
         ).with_channel("commentary"),
     ]
@@ -376,7 +376,7 @@ If the model decides to call a tool it will define a `recipient` in the header o
 The model might also specify a `<|constrain|>` token to indicate the type of input for the tool call. In this case since it’s being passed in as JSON the `<|constrain|>` is set to `json`.
 
 ```
-<|channel|>analysis<|message|>Need to use function get_weather.<|end|><|start|>assistant<|channel|>commentary to=functions.get_weather <|constrain|>json<|message|>{"location":"San Francisco"}<|call|>
+<|channel|>analysis<|message|>Need to use function get_current_weather.<|end|><|start|>assistant<|channel|>commentary to=functions.get_current_weather <|constrain|>json<|message|>{"location":"San Francisco"}<|call|>
 ```
 
 #### Handling tool calls
@@ -392,7 +392,7 @@ A tool message has the following format:
 So in our example above
 
 ```
-<|start|>functions.get_weather to=assistant<|channel|>commentary<|message|>{"sunny": true, "temperature": 20}<|end|>
+<|start|>functions.get_current_weather to=assistant<|channel|>commentary<|message|>{"sunny": true, "temperature": 20}<|end|>
 ```
 
 Once you have gathered the output for the tool calls you can run inference with the complete content:
@@ -432,10 +432,10 @@ locations: string[],
 format?: "celsius" | "fahrenheit", // default: celsius
 }) => any;
 
-} // namespace functions<|end|><|start|>user<|message|>What is the weather like in SF?<|end|><|start|>assistant<|channel|>analysis<|message|>Need to use function get_weather.<|end|><|start|>assistant<|channel|>commentary to=functions.get_weather <|constrain|>json<|message|>{"location":"San Francisco"}<|call|><|start|>functions.get_weather to=assistant<|channel|>commentary<|message|>{"sunny": true, "temperature": 20}<|end|><|start|>assistant
+} // namespace functions<|end|><|start|>user<|message|>What is the weather like in SF?<|end|><|start|>assistant<|channel|>analysis<|message|>Need to use function get_current_weather.<|end|><|start|>assistant<|channel|>commentary to=functions.get_current_weather <|constrain|>json<|message|>{"location":"San Francisco"}<|call|><|start|>functions.get_current_weather to=assistant<|channel|>commentary<|message|>{"sunny": true, "temperature": 20}<|end|><|start|>assistant
 ```
 
-As you can see above we are passing not just the function out back into the model for further sampling but also the previous chain-of-thought (“Need to use function get_weather.”) to provide the model with the necessary information to continue its chain-of-thought or provide the final answer.
+As you can see above we are passing not just the function out back into the model for further sampling but also the previous chain-of-thought (“Need to use function get_current_weather.”) to provide the model with the necessary information to continue its chain-of-thought or provide the final answer.
 
 #### Preambles
 

registry.yaml

@@ -12,6 +12,7 @@
   tags:
     - gpt-oss
     - open-models
+    - gpt-oss-providers
 
 - title: How to run gpt-oss locally with LM Studio
   path: articles/gpt-oss/run-locally-lmstudio.md
@@ -21,6 +22,8 @@
   tags:
     - gpt-oss
     - open-models
+    - gpt-oss-local
+    
 - title: GPT-5 Prompt Migration and Improvement Using the New Optimizer
   path: examples/gpt-5/prompt-optimization-cookbook.ipynb
   date: 2025-08-07
@@ -76,6 +79,7 @@
   tags:
     - gpt-oss
     - open-models
+    - gpt-oss-server
 
 - title: Using NVIDIA TensorRT-LLM to run gpt-oss-20b
   path: articles/gpt-oss/run-nvidia.ipynb
@@ -85,6 +89,7 @@
   tags:
     - gpt-oss
     - open-models
+    - gpt-oss-server
 
 - title: Fine-tuning with gpt-oss and Hugging Face Transformers
   path: articles/gpt-oss/fine-tune-transfomers.ipynb
@@ -96,6 +101,7 @@
   tags:
     - open-models
     - gpt-oss
+    - gpt-oss-fine-tuning
 
 - title: How to handle the raw chain of thought in gpt-oss
   path: articles/gpt-oss/handle-raw-cot.md
@@ -105,6 +111,8 @@
   tags:
     - open-models
     - gpt-oss
+    - gpt-oss-fine-tuning
+    - gpt-oss-providers
 
 - title: How to run gpt-oss with Transformers
   path: articles/gpt-oss/run-transformers.md
@@ -114,6 +122,7 @@
   tags:
     - open-models
     - gpt-oss
+    - gpt-oss-server
 
 - title: How to run gpt-oss with vLLM
   path: articles/gpt-oss/run-vllm.md
@@ -123,6 +132,7 @@
   tags:
     - open-models
     - gpt-oss
+    - gpt-oss-server
 
 - title: How to run gpt-oss locally with Ollama
   path: articles/gpt-oss/run-locally-ollama.md
@@ -132,6 +142,7 @@
   tags:
     - open-models
     - gpt-oss
+    - gpt-oss-local
 
 - title: OpenAI Harmony Response Format
   path: articles/openai-harmony.md
@@ -142,6 +153,8 @@
     - open-models
     - gpt-oss
     - harmony
+    - gpt-oss-providers
+    - gpt-oss-fine-tuning
 
 - title: Temporal Agents with Knowledge Graphs
   path: examples/partners/temporal_agents_with_knowledge_graphs/temporal_agents_with_knowledge_graphs.ipynb