RAG Chat for Amazon Bedrock

RAG Chat for Amazon Bedrock is a WordPress plugin that seamlessly integrates your WordPress content with Amazon Bedrock Knowledge Bases to create an intelligent RAG (Retrieval-Augmented Generation) chatbot system.

Key Features:

• Direct Amazon Bedrock Integration: Connects directly to Amazon Bedrock Knowledge Bases without external servers
• Automatic Content Synchronization: Automatically syncs WordPress posts and pages to Amazon Bedrock when content is created, updated, or deleted
• Real-time Chat Interface: Provides a chat widget for visitors to interact with your content using AI
• Comprehensive Admin Interface: Four dedicated admin pages for configuration and content management
• AWS Security: Uses AWS Signature Version 4 authentication for secure API communication
• Content Management: Track sync status and manage which content is synchronized to Amazon Bedrock

How It Works:

1. Configure your AWS credentials and Amazon Bedrock Knowledge Base in the plugin settings
2. New WordPress posts and pages are automatically synchronized to Amazon Bedrock when saved or deleted
3. Existing content can be synchronized using the export function in the Content Management page
4. Visitors can use the chat interface to ask questions about your content
5. Amazon Bedrock retrieves relevant content and generates intelligent responses using your WordPress data

Requirements:

• AWS account with Amazon Bedrock access
• Amazon Bedrock Knowledge Base configured
• Valid AWS credentials (Access Key ID and Secret Access Key)

Demo:

See the plugin in action: Live Demo

Troubleshooting

Plugin Installation & Setup Issues

Plugin activation fails

1. Ensure your WordPress version meets the minimum requirement (6.6+)
2. Check that your PHP version is 7.4 or higher
3. Verify there are no plugin conflicts by temporarily deactivating other plugins

The chat interface doesn’t appear on my page

1. Make sure you’ve inserted the shortcode [rag_chat_ab_chat] in the correct location
2. Check that the plugin is activated
3. Verify your AWS credentials are correctly configured in the plugin settings

Content Synchronization Issues

Content sync is failing

1. Verify your AWS credentials have the correct permissions
2. Check that your Knowledge Base ID and Data Source ID are correct
3. Ensure your Knowledge Base has a “Custom” type data source
4. For existing content, use the “Export Posts and Pages to Amazon Bedrock” feature on the Content Management page

Export operation times out

If you have many posts and pages, “Export Posts and Pages to Amazon Bedrock” may take a long time and cause timeout errors depending on your PHP settings. To reduce the risk of timeout:

1. Export content in smaller batches by selecting specific date ranges
2. Consider increasing your PHP execution time limit if you have server access
3. Contact your hosting provider if timeout issues persist
4. For large-scale exports, we offer a dedicated bulk export PHP script that runs independently on your server and can handle large volumes of content without web browser timeout limitations. Contact us at https://tally.so/r/3jjoga for more information about our bulk export solution

AWS Authentication & Permissions

AWS permission errors

1. Double-check all required IAM permissions are granted to your user
2. Verify your AWS Access Key ID and Secret Access Key are correct
3. Ensure your AWS account has access to Amazon Bedrock in the selected region
4. Check the AWS CloudTrail logs for detailed error information

AWS Marketplace subscription error

If you encounter “Model access is denied” with “aws-marketplace:ViewSubscriptions” permission errors:

1. Your IAM user needs the aws-marketplace:ViewSubscriptions permission
2. Add this permission to your IAM user’s policy
3. Wait 15 minutes after fixing the permissions before trying again
4. This is required for AWS Marketplace subscription completion

Model Access & Configuration

Model use case details required

If you encounter an error like “Model use case details have not been submitted for this account. Fill out the Anthropic use case details form before using the model”:

1. Anthropic requires use case details before using their models
2. Fill out the Anthropic use case details form in your AWS console
3. Wait 15 minutes after submitting before trying again
4. See the AWS documentation: https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html

Inference profile required error

If you get an error like “Invocation of model ID anthropic.claude-haiku-4-5-20251001-v1:0 with on-demand throughput isn’t supported. Retry your request with the ID or ARN of an inference profile”:

1. Some models require using inference profiles instead of direct model invocation
2. Use the ID or ARN of an inference profile that contains the model
3. Configure inference profiles in your Amazon Bedrock settings
4. See the AWS documentation: https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html

Chat responses are not working

1. Verify that your AWS region is correct in the plugin settings
2. Check that your Knowledge Base contains synchronized content
3. Ensure your IAM user has bedrock:RetrieveAndGenerate permissions
4. Try asking questions related to your synchronized content

External services

This plugin uses the following Amazon Bedrock API endpoints provided by Amazon Web Services, Inc.:

• PUT https://bedrock-agent.{$region}.amazonaws.com/knowledgebases/{$knowledge_base_id}/datasources/{$data_source_id}
  • Called when a post or page is created or updated.
  • Used to add / update content on Amazon Bedrock.
  • The whole content (post or page) is sent.
• POST https://bedrock-agent.{$region}.amazonaws.com/knowledgebases/{$knowledge_base_id}/datasources/{$data_source_id}/documents/deleteDocuments
  • Called when a post is deleted or moved to trash.
  • Used to delete content from Amazon Bedrock.
  • Only the post / page ID is sent.
• POST https://bedrock-agent-runtime.{$region}.amazonaws.com/retrieveAndGenerate
  • Called when a visitor asks a question.
  • Used to generate responses using Amazon Bedrock’s AI.
  • The query that the user enters is sent.
  • The response contains a session ID, and it will be send to this endpoint in the subsequent requests along with the query.

Please see the following links for more information about Amazon Web Services:

• AWS Service Terms
• AWS Privacy

Related Projects

This plugin is based on WP RAG (https://github.com/mobalab/wp-rag), which provides RAG functionality using external servers and OpenAI’s APIs. RAG Chat for Amazon Bedrock offers a different approach by integrating directly with Amazon Bedrock Knowledge Bases for users who prefer AWS-native solutions.

WordPress Installation:
1. Install the plugin through the WordPress plugins screen directly, or upload the plugin files to the /wp-content/plugins/rag-chat-ab directory
2. Activate the plugin through the ‘Plugins’ screen in WordPress

AWS Setup (Required):
Before using this plugin, you need to set up Amazon Bedrock and create a Knowledge Base:
1. Create an AWS account if you don’t have one: AWS Account Setup
2. Set up Amazon Bedrock access: Getting Started with Amazon Bedrock
3. Create a Knowledge Base: Amazon Bedrock Knowledge Base Setup
4. Create a data source of “Custom” type within your Knowledge Base (required for the plugin to sync WordPress content)
5. Create an IAM user with the following permissions:
– bedrock:IngestKnowledgeBaseDocuments (to sync WordPress content)
– bedrock:DeleteKnowledgeBaseDocuments (to remove deleted WordPress content)
– bedrock:RetrieveAndGenerate, bedrock:RetrieveAndGenerate (to generate chat responses)
– AWS managed policy AmazonBedrockAgentCoreMemoryBedrockModelInferenceExecutionRolePolicy
– Additional permissions may be required depending on your specific AWS setup and Knowledge Base configuration
– See IAM Permissions for Amazon Bedrock for detailed setup
6. Create AWS credentials (Access Key ID and Secret Access Key): Managing AWS Access Keys

Need Help with AWS Setup?
Setting up AWS infrastructure can be complex. We offer an automated infrastructure package that includes shell scripts and CDK (Cloud Development Kit) code to construct all necessary AWS resources automatically. This package handles the complete setup including Knowledge Bases, IAM permissions, and proper configurations. For more information about our infrastructure automation package, please contact us at https://tally.so/r/3jjoga

Plugin Configuration:
1. Go to the RAG Chat admin menu to configure your Amazon Bedrock settings
2. Enter your AWS credentials and Knowledge Base details
3. New content will automatically sync to Amazon Bedrock when created, updated, or deleted
4. For existing posts and pages, use “Export Posts and Pages to Amazon Bedrock” on the Content Management page
5. Insert the shortcode [rag_chat_ab_chat] where you want the chat interface to appear
6. (Optional) Configure your chat interface settings for custom styling and behavior

0.0.2: October 30th, 2025

• Fix bugs
• Add / fix text
• Update documentation

0.0.1: October 7th, 2025

• Birthday of RAG Chat for Amazon Bedrock!