> For the complete documentation index, see [llms.txt](https://docs.finopscenter.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.finopscenter.com/agent-bill-amazon-quickchat-for-finops-center/functional/quick-sight-topic-custom-instructions.md).
# 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.finopscenter.com/agent-bill-amazon-quickchat-for-finops-center/functional/quick-sight-topic-custom-instructions.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.