Skip to content

Conversation

@roomote
Copy link
Contributor

@roomote roomote bot commented Dec 21, 2025

Related GitHub Issue

Relates to: #10246

Roo Code Task Context (Optional)

This PR was created with the assistance of Roo Code to address user feedback.

Description

This PR attempts to address Issue #10246 by improving the error message shown when the model fails to use tools in its response.

The issue reports that users of third-party API providers (OpenAI Compatible) frequently encounter the error message "The model provided text/reasoning but did not call any required tools." This is often caused by the API provider not fully supporting native tool calling.

Changes:

  • Updated the noToolsUsedDetails message in English (en/chat.json) to include guidance about changing the Tool Protocol to "XML" in Advanced Settings when using third-party API providers
  • Added corresponding Chinese translation (zh-CN/chat.json) with the same guidance

Rationale:

  • The Tool Protocol selector is already available in Advanced Settings for OpenAI Compatible providers
  • Switching to XML protocol uses text-based tool definitions instead of native function calling, which is more widely supported by API proxies
  • This guidance helps users self-diagnose and resolve the issue without needing to file support requests

Test Procedure

  1. Configure an OpenAI Compatible provider with a third-party API proxy that has limited tool support
  2. Trigger the "no tools used" error by having the model fail to call tools
  3. Verify the error message now includes guidance about the Tool Protocol setting
  4. Navigate to Advanced Settings and verify the Tool Protocol option is visible

Pre-Submission Checklist

Screenshots / Videos

N/A - text-only change to error message

Documentation Updates

  • No documentation updates are required.

Additional Notes

This is an attempt to help users who encounter tool calling issues with third-party API providers. The existing Tool Protocol setting already provides the solution, but users may not know to look for it. This change surfaces that guidance directly in the error message.

Feedback and guidance are welcome!

Get in Touch

Available via GitHub for any questions.

Add guidance in the error message to suggest users try changing
the Tool Protocol to "XML" in Advanced Settings when using
third-party API providers with OpenAI Compatible. This helps
users who encounter tool calling issues with proxied APIs.

Relates to #10246
@roomote
Copy link
Contributor Author

roomote bot commented Dec 21, 2025

Rooviewer Clock   See task on Roo Cloud

Review completed with no issues found. This PR makes a focused improvement to help users troubleshoot tool calling issues with third-party API providers.

  • English and Chinese translations updated correctly
  • Guidance about Tool Protocol XML setting is accurate and actionable
  • JSON structure is valid

Mention @roomote in a comment to request specific changes to this pull request or fix all unresolved issues.

@hannesrudolph hannesrudolph added the Issue/PR - Triage New issue. Needs quick review to confirm validity and assign labels. label Dec 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Issue/PR - Triage New issue. Needs quick review to confirm validity and assign labels.

Projects

Status: Triage

Development

Successfully merging this pull request may close these issues.

3 participants