Genesys Cloud - Main

I am creating an Agentic Virtual Agent. It is working perfectly with 2 tools assigned to it, but as soon as I add a 3rd tool, it fails when I go to test, and also after saving and coming back, my 3rd tool is gone. 

#AIConfiguration
#API/Integrations
#ConversationalAI(Bots,VirtualAgent,etc.)

------------------------------
Nick Argeson
Telephony Admin
------------------------------

Hi Nick 

I am not yet familiar with Virtual Agents, but I found the following text in the AI ​​orchestrator:

------

The issue you're experiencing with your 3rd tool likely relates to the data action schema that tool is using. Agentic Virtual Agents have specific restrictions on data action output schemas that could cause validation failures:

Unsupported schema features that cause failures:

• Schema combinators (oneOf, anyOf, allOf)
• Conditional keywords (if, then, else)
• Schema dependencies
• References ($ref)
• Negation (not)
• Constants (const)
• Empty objects (objects without properties)
• Tuple validation (multiple schemas in items)
• Nested arrays (items cannot be of type array)

What to check on your 3rd tool:

1. Review the data action associated with your 3rd tool
2. Check if its output schema contains any of the unsupported features listed above
3. Verify the input and output parameter definitions are properly configured
4. Ensure error handling is set up correctly

The fact that the tool disappears after saving suggests the system is rejecting it during validation, which is typically due to schema incompatibility rather than a quantity limit.

Recommended steps:

1. Compare the data action schemas between your working tools and the failing 3rd tool
2. Simplify the 3rd tool's schema to remove any unsupported features
3. Test adding the tool again after schema adjustments

If the issue persists after verifying the schema compliance, I can help you create a support case for further investigation.

Please see if this makes sense.

------------------------------
Kaio Oliveira
GCP - GCQM - GCS - GCA - GCD - GCO - GPE & GPR - GCWM

PS.: I apologize if there are any mistakes in my English; my primary language is Portuguese-Br.

Original Message:
Sent: 04-09-2026 11:00
From: Nick Argeson
Subject: Tool limitations in Agentic Virtual Agents

I am creating an Agentic Virtual Agent. It is working perfectly with 2 tools assigned to it, but as soon as I add a 3rd tool, it fails when I go to test, and also after saving and coming back, my 3rd tool is gone. 

#AIConfiguration
#API/Integrations
#ConversationalAI(Bots,VirtualAgent,etc.)

------------------------------
Nick Argeson
Telephony Admin
------------------------------