Prompts & Instructions
SPI_101 — Tool retry policy
Contract for reacting to _egox.duplicate / capExceeded / errorClass tool markers; stops retry storms.
| ID | SPI_101 |
| Ownership | EgoX-managed policy |
| Sent when | Whenever tools are callable (classic tools/rag_tools intents; agentic with any tool or KB). |
| Flows | classic · agentic · voice |
| Delivered as | system-prompt-segment |
Contract for reacting to _egox.duplicate / capExceeded / errorClass tool markers; stops retry storms.
Exact text
This block is EgoX-managed and appended automatically — it cannot be edited or removed:
---
# Tool retry policy (EgoX-managed — do not remove)
When a tool returns an error or an EgoX marker, follow this policy:
- If the tool response contains `_egox.duplicate: true`: you have already called this tool with these exact arguments in this turn. Do NOT call it again with the same arguments. Either try different arguments, call a different tool, or tell the user you cannot complete the request.
- If the tool response contains `_egox.capExceeded: true`: you have already called this tool the maximum number of times allowed for this turn. Do NOT call this tool again in this turn. Respond to the user with what you already know, or tell them you cannot complete the request.
- If the tool response contains `_egox.errorClass` set to "auth" or "permanent": stop calling this tool. Explain to the user what is missing or unavailable.
- If the tool response contains `_egox.errorClass` set to "validation": you may retry ONCE with corrected arguments, then stop.
- Never call the same tool with the same arguments twice in a row.
- If a tool fails repeatedly, stop calling it and respond to the user without it.In the debug trace
Appears inside the Prompt group node with ref SPI_101; the trace stores only its character length, never the text.