# InstructionCollection
<a name="API_InstructionCollection"></a>

A set of instructions that define how Amazon Q Business should generate and format responses to user queries. This collection includes parameters for controlling response characteristics such as length, audience targeting, perspective, style, identity, tone, and custom instructions.

## Contents
<a name="API_InstructionCollection_Contents"></a>

 ** customInstructions **   <a name="qbusiness-Type-InstructionCollection-customInstructions"></a>
Allows administrators to provide specific, custom instructions that guide how Amazon Q Business should respond in particular scenarios or to certain types of queries, enabling fine-grained control over response generation.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** examples **   <a name="qbusiness-Type-InstructionCollection-examples"></a>
Provides sample responses or templates that Amazon Q Business can reference when generating responses, helping to establish consistent patterns and formats for different types of user queries.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** identity **   <a name="qbusiness-Type-InstructionCollection-identity"></a>
Defines the persona or identity that Amazon Q Business should adopt when responding to users, allowing for customization of the assistant's character, role, or representation within an organization.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** outputStyle **   <a name="qbusiness-Type-InstructionCollection-outputStyle"></a>
Specifies the formatting and structural style of responses, such as bullet points, paragraphs, step-by-step instructions, or other organizational formats that enhance readability and comprehension.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** perspective **   <a name="qbusiness-Type-InstructionCollection-perspective"></a>
Determines the point of view or perspective from which Amazon Q Business generates responses, such as first-person, second-person, or third-person perspective, affecting how information is presented to users.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** responseLength **   <a name="qbusiness-Type-InstructionCollection-responseLength"></a>
Specifies the desired length of responses generated by Amazon Q Business. This parameter allows administrators to control whether responses are concise and brief or more detailed and comprehensive.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** targetAudience **   <a name="qbusiness-Type-InstructionCollection-targetAudience"></a>
Defines the intended audience for the responses, allowing Amazon Q Business to tailor its language, terminology, and explanations appropriately. This could range from technical experts to general users with varying levels of domain knowledge.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** tone **   <a name="qbusiness-Type-InstructionCollection-tone"></a>
Controls the emotional tone and communication style of responses, such as formal, casual, technical, friendly, or professional, to align with organizational communication standards and user expectations.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

## See Also
<a name="API_InstructionCollection_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qbusiness-2023-11-27/InstructionCollection) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qbusiness-2023-11-27/InstructionCollection) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qbusiness-2023-11-27/InstructionCollection)