Quick Sight Topic Custom Instructions

QuickSight Topics support custom instructions that guide how Agent Bill interprets and responds to natural language queries. In 26.4.0, topic-level custom instructions work alongside persona-level instructions (configured per role in the Custom Instruction page) to provide layered context. Topic instructions are shared across all users of that topic, while persona instructions are role-specific. Custom instructions can be managed via the QuickSight API using DescribeTopic (returns CustomInstructionsString), CreateTopic, and UpdateTopic operations. The character limit for topic custom instructions is approximately 3,000 characters.

To assist the Quick Sight Topic understand how business weeks are defined, each topics needs to have a Custom Instruction

Customer Instruction

Week are defined by sunday to saturday. the first week of each month starts the 1st of month to saturday 23:59. The last week of the month starts Sunday 00:01 to the last day of that month. Normal weeks are sunday to saturday.

When Forecasting only show the past 2 months and then the forecast for the selected time

Business Week Alignment (v2)

In version 26.4.0, the business week calendar guidelines were restructured to enforce Sunday-based week definitions consistently. The updated custom instruction text for each topic should include explicit week boundary definitions: W1 starts on the 1st of the month and ends on the first Saturday. W2 through W5 run Sunday 00:00 to Saturday 23:59. W6 (if present) starts on the last Sunday and ends on the last day of the month. For example, "week 2 of January 2026" refers to January 5-11 (Sunday through Saturday). These week definitions must align with the business_week_number and business_week_label calculated fields in the dataset to ensure consistent results between direct queries and weekly aggregations.

API Management

Topic custom instructions can be programmatically managed through the QuickSight API. Use DescribeTopic to retrieve the current custom instructions via the CustomInstructionsString field in the response. Use CreateTopic or UpdateTopic to set or update custom instructions by including the CustomInstructions parameter. This enables automated deployment of instruction updates across all four topics (Cost Management, Container Allocation, Marketplace Spending, Savings Plans Management) without manual console interaction.