Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  Referencing User Prompts in AI Guides , Agentic Virtual Agent

    Posted 2 days ago

    Hi Team,

    I have a question regarding the use of User Prompts in Genesys Cloud AI Guides.

    We currently have AI Guide instructions where the TTS messages are hardcoded, for example:

    Say "Hello! How can I help you today?"

    We would like to move these TTS messages into the User Prompt section so that, if we need to modify the TTS content in the future, we only need to update the User Prompt and do not have to modify the AI Guide instructions.

    For example, we would like to have something similar to:

    Say Prompt(InitialGreeting)

    where InitialGreeting is a User Prompt containing:

    Hello! How can I help you today?

    However, the AI Guide validation gives the error:

    "'Say' message text must be enclosed in quotes."

    Could you please confirm:

    1. Is there a supported syntax or method to reference a User Prompt from an AI Guide instruction?
    2. If yes, what is the correct syntax for referencing the User Prompt in a Say or Ask instruction?
    3. If direct User Prompt references are not supported, is there another recommended approach to avoid hardcoding TTS messages in the AI Guide?
    4. Also In Agentic Virtual agent does userprompt is supported?

    Our goal is to maintain the TTS content separately in User Prompts so that content changes can be managed without modifying the Guide logic.


    #Architect
    #Integrations

    ------------------------------
    Haridass
    ------------------------------


  • 2.  RE: Referencing User Prompts in AI Guides , Agentic Virtual Agent

    Posted 2 days ago

    Hi Haridass,

    I was looking into this as well, and I think there is an important distinction between Architect User Prompts and AI Guide variables/messages.

    Based on the current documentation, the Say command expects the message itself to be enclosed in quotes, although it can include simple Guide variables. I could not find a documented syntax that allows an AI Guide to directly dereference an Architect User Prompt such as Prompt(InitialGreeting).

    An Architect User Prompt is not simply a string. It is a prompt resource/container that can contain TTS or recorded audio resources per language. Architect can resolve and play that prompt, but the Guide does not appear to expose a method for retrieving the underlying TTS text from that prompt.

    If the main objective is to keep the greeting independently maintainable, I wonder whether the cleaner architecture would actually be:

    Architect Bot Flow → play User Prompt InitialGreeting → Call Guide

    This keeps the corporate/static TTS content in Architect and the conversational logic in the Guide. It is also worth noting that Genesys documentation states that bot flows use the latest version of a User Prompt rather than a snapshot.

    Another option would be to create a String input variable in the Guide and pass the greeting text from Architect. AI Guides support input variables from the Virtual Agent flow and those values can be referenced in Say instructions. However, that would still be a String passed to the Guide - not a direct reference to an Architect User Prompt.

    For the newer Agentic Virtual Agent, I see a similar separation. Architect can pass primitive values through Start Context, while AVA configuration provides specific exit and escalation responses, but I do not see a documented mechanism to reference an Architect User Prompt directly from the agent.

    So I think the key question for Genesys would be:

    Is there any supported mechanism for an AI Guide or Agentic Virtual Agent to dereference an Architect User Prompt and use its underlying TTS resource, or should User Prompts always be played by Architect before/after invoking the Guide or Agent?

    If the latter is the intended design, then keeping reusable corporate prompts in Architect and the agentic conversational behavior in AI Studio seems like the cleanest approach.



    ------------------------------
    Fernando Sotto dos Santos
    Consultor de Atendimento Senior Grupo Casas Bahia
    ------------------------------



  • 3.  RE: Referencing User Prompts in AI Guides , Agentic Virtual Agent

    Posted 2 days ago

    Hi Haridass,

    I tested a similar scenario and, based on the behavior I have seen so far, AI Guides do not appear to support directly dereferencing an Architect User Prompt within a Say or Ask instruction.

    The validation error:

    'Say' message text must be enclosed in quotes.

    suggests that the Guide parser expects either:

    Say "Hello! How can I help you today?"

    or a supported Guide variable expression, but not an Architect User Prompt object such as:

    Say Prompt(InitialGreeting)

    From an architecture perspective, Architect User Prompts and AI Guide content seem to be managed independently. A User Prompt is an Architect resource that can contain multilingual TTS and audio assets, whereas AI Guides operate with their own instructions, variables, and conversational context.

    For maintainability, I would consider one of these approaches:

    Option 1 (recommended):

    Architect Flow
    → Play User Prompt (InitialGreeting)
    → Invoke AI Guide / Agentic Virtual Agent

    This keeps all reusable corporate greetings, disclaimers, and announcements centralized in Architect, while the Guide focuses strictly on conversational logic.

    Option 2:

    Pass the greeting as an input variable from Architect to the Guide:

    GreetingText = "Hello! How can I help you today?"

    and then reference that variable inside the Guide. This still requires managing text outside the Guide but avoids hardcoding the message in multiple Guide instructions.

    Regarding Agentic Virtual Agent, I have not seen documentation or examples showing direct support for referencing Architect User Prompts either. My understanding is that AVA can receive contextual data and variables from Architect, but not resolve an Architect User Prompt resource natively.

    Therefore, my current assumption is:

    • ❌ Direct User Prompt reference from AI Guides: not supported.
    • ❌ Direct User Prompt reference from Agentic Virtual Agent: not currently documented/supported.
    • ✅ Play the User Prompt in Architect before or after invoking the Guide/AVA.
    • ✅ Pass the text as an input variable if dynamic content is required inside the Guide.

    It would be great if someone from the Genesys Product Team could confirm whether User Prompt dereferencing is on the roadmap for AI Guides or Agentic Virtual Agent, as it would significantly improve content maintainability and localization management.

    Regards,



    ------------------------------
    Cesar
    INDRA COLOMBIA
    ------------------------------



Related Content