GuardrailTopic
Details about topics for the guardrail to identify and deny.
This data type is used in the following API operations:
Contents
- definition
-
A definition of the topic to deny.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 200.
Required: Yes
- name
-
The name of the topic to deny.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 100.
Pattern:
[0-9a-zA-Z-_ !?.]+Required: Yes
- examples
-
A list of prompts, each of which is an example of a prompt that can be categorized as belonging to the topic.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 5 items.
Length Constraints: Minimum length of 1. Maximum length of 100.
Required: No
- inputAction
-
The action to take when harmful content is detected in the input. Supported values include:
-
BLOCK– Block the content and replace it with blocked messaging. -
NONE– Take no action but return detection information in the trace response.
Type: String
Valid Values:
BLOCK | NONERequired: No
-
- inputEnabled
-
Indicates whether guardrail evaluation is enabled on the input. When disabled, you aren't charged for the evaluation. The evaluation doesn't appear in the response.
Type: Boolean
Required: No
- outputAction
-
The action to take when harmful content is detected in the output. Supported values include:
-
BLOCK– Block the content and replace it with blocked messaging. -
NONE– Take no action but return detection information in the trace response.
Type: String
Valid Values:
BLOCK | NONERequired: No
-
- outputEnabled
-
Indicates whether guardrail evaluation is enabled on the output. When disabled, you aren't charged for the evaluation. The evaluation doesn't appear in the response.
Type: Boolean
Required: No
- type
-
Specifies to deny the topic.
Type: String
Valid Values:
DENYRequired: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: