From 6711bf3f545c9a5df24c0deb1f131565e392e6d9 Mon Sep 17 00:00:00 2001
From: soria <soriarmaando@gmail.com>
Date: Wed, 6 May 2026 18:46:19 -0400
Subject: [PATCH] Clarify Ollama tool prompt format

---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index 42aa8a1..a0e39e0 100644
--- a/README.md
+++ b/README.md
@@ -197,6 +197,15 @@ You are a function calling AI model. You are provided with function signatures w
 </tool_call><|im_end|>
 ```
 
+When using an OpenAI-compatible runtime such as Ollama, prefer the OpenAI tools
+examples in `examples/ollama_openai_tools.ipynb` and
+`examples/ollama_openai_tools_recursive.ipynb`. Those examples send tool
+schemas through the `tools` parameter and append tool results with
+`role: "tool"` plus the returned `tool_call_id`. If your runtime only accepts
+`system`, `user`, and `assistant` roles, keep the same Hermes XML envelopes and
+feed tool results back as user-visible content inside `<tool_response>` tags
+instead of dropping the tool result or changing the JSON shape.
+
 Hermes-3 tool-use template:
 - <scratch_pad> can be enabled with Goal Oriented Action Planning (GOAP) reasoning framework
 - Goal section would restate user request