Custom plugins for Amazon Q Business - Amazon Q Business

Custom plugins for Amazon Q Business

You can use the Amazon Q Business console or APIs to create custom plugins for your Amazon Q application.

With custom plugins, you can choose to integrate Amazon Q with any third-party application for a variety of different use cases. Once enabled, end users can use natural language to query data (like available calendar slots, stock prices, vacation balance) and take actions (like booking a meeting, submitting vacation time, updating a record).

To create a custom plugin, you need to configure authentication and network information to connect Amazon Q Business to your third-party application. Additionally, you need to create or edit an OpenAPI schema outlining the different API operations you want to enable for your custom plugin. You can configure up to 8 API operations per custom plugin.

To define the API operations, create an OpenAPI schema in JSON or YAML format. You can upload the OpenAPI schema file to Amazon S3 or you can paste it in the OpenAPI text editor in the Amazon Q Business console, which will validate your schema.

Once the custom plugin is deployed, Amazon Q Business will dynamically determine the appropriate APIs to call to accomplish an end user requested task. In order to maximize accuracy, review the best practices for configuring OpenAPI schema definitions for custom plugins.

Important

Custom plugins are only supported for Amazon Q Business applications using IAM Identity Center for user management.

Note

Creating custom forms with array fields (fields with nested objects inside an array) for custom plugins isn't supported on the console.