Embed Specific Custom Chat Agent into react app

Q&A
,
1

Hi All,

I have created a custom chat agent on quicksight with specific knowledge sources and user access.
When embedding this into react application I am using API GenerateEmbedUrlForRegisteredUser() with

ExperienceConfiguration: {

    QuickChat: { }

}

This renders chat agent but user needs to further select specific agent in a dropdown or attach a knowledge source. Although this works, I would like to load by default a specific custom agent so that user does not have to make any selections. I want to pass AgentID as a parameter that would enable this, similar to the dashboardID.

How can that be achieved? If there are any other approaches I’d be interested to know. Note: I do not plan to use IAM Center.

Any suggestions would be great!
Thanks!

2

Hi @Santos and welcome to the community!

Currently, I don’t believe the GenerateEmbedUrlForRegisteredUser API with Quick Chat supports passing a specific agent ID to pre-select a custom agent. The embedded chat experience loads the default view where users have to select their agent or knowledge source, there’s no Agent-Id parameter equivalent to Dashboard-Id.

I would try restricting agent access. If the users you’re embedding for only have access to one agent (via sharing permissions), the dropdown should only show that single option. This reduces friction even if it doesn’t technically auto-select. You could create a group with only access to that specific agent and ensure your embedded users belong to that group.

For reference here is documentation on Embedding Embedding the Amazon Q in Amazon Quick Sight Generative Q&A experience - Amazon Quick and here is another resource which might be helpful Enhance your analytics embedding experience with generative BI capabilities | AWS Business Intelligence Blog .

Hope this helps!

3

Hi @WLS-Cesar ,

Thank you for your response — it was very helpful.

I have been reviewing the amazon-quicksight-embedding-sdk, which appears to allow passing a fixedAgentId parameter in createEmbeddingContext() method to call a specific custom agent. I was able to load a custom agent to my react app.

However, the Quick embedding limitations documentation (What you can build with apps in Quick - Amazon Quick) states that:

“You cannot currently embed a standalone chat agent that was created separately in Amazon Quick.”

This seems contradictory and is a bit confusing. Could you please clarify how these two points align? Is it pointing at apps specifically build using Quick or External web applications??

Thanks!

4

Hi @Santos,

Regarding the documentation you referenced, I believe that statement (“You cannot currently embed a standalone chat agent that was created separately in Amazon Quick”) is referring specifically to Quick Apps, not external web applications. The “What you can build” page is describing limitations of what you can build within Quick Apps, not limitations of the embedding SDK for external React/web applications.

Hope this clears it up!

5

Hi @Santos,

Just checking back in since we haven’t heard from you in a bit. I wanted to see if the guidance shared earlier helped resolve your question, or if you found a solution in the meantime.

If you still have any additional questions related to your initial post, feel free to share them. Otherwise, any update you’re able to provide within the next 3 business days would be helpful for the community.

Thank you.

6

Hi @Santos,

Since I haven’t received any further updates from you, I’ll treat this inquiry as complete for now. If you have any additional questions, feel free to create a new post in the community and link this discussion for context.

Thank you.