aws-kendra
Manage and search Kendra intelligent search indexes
TLDR
Create an index
List indexes
Describe an index
List data sources
Describe a data source
List search queries
SYNOPSIS
aws kendra <command> [<subcommand>] [<options>]
PARAMETERS
--region
Specifies the AWS region to send the request to (e.g., us-east-1
).
--output
Specifies the output format of the command (e.g., json
, text
, table
).
--profile
Uses a specific named profile from your AWS credentials file.
--endpoint-url
Overrides the default endpoint URL for the service.
--cli-input-json
Reads a JSON document from a file or stdin as input for the command.
--name
(Specific to commands like create-index
) Specifies the name for a new Kendra index or data source.
--index-id
(Specific to commands like query
, delete-index
) The unique identifier of a Kendra index.
--query-text
(Specific to the query
command) The natural language query string to search for.
DESCRIPTION
The aws-kendra command, typically invoked as part of the AWS Command Line Interface (CLI) via aws kendra
, provides a powerful interface to Amazon Kendra, an intelligent search service. Kendra utilizes machine learning to deliver highly accurate and relevant search results across various content repositories. Users can interact with their Kendra indexes to create, manage, and query them directly from the terminal. This includes operations like creating data sources, ingesting documents, configuring search indexes, and executing sophisticated natural language queries. It abstracts the complexity of underlying machine learning models, allowing developers and administrators to integrate intelligent search into their applications or workflows without deep ML expertise. It's crucial for enterprises looking to improve information discovery within their vast data landscapes.
CAVEATS
1. AWS CLI Installation & Configuration: Requires the AWS CLI to be properly installed and configured with valid AWS credentials and default region.
2. Internet Connectivity: Operations interact with AWS cloud services, necessitating an active internet connection.
3. Permissions: The configured AWS user/role must have appropriate IAM permissions to perform the requested Kendra operations.
4. Cost: Amazon Kendra is a paid service; usage incurs costs based on index size, query volume, and other factors.
5. Regional Availability: Kendra service availability varies by AWS region.
COMMON USE CASES
Enterprise Search: Providing employees with quick and accurate answers from internal documents (e.g., HR policies, technical manuals).
Customer Support: Powering intelligent chatbots or self-service portals to answer customer queries instantly.
Research & Development: Accelerating information discovery across large datasets of research papers or patents.
INTEGRATION WITH AWS ECOSYSTEM
Kendra integrates seamlessly with other AWS services like Amazon S3 for document storage, Amazon CloudWatch for monitoring, AWS Identity and Access Management (IAM) for secure access, and AWS Lambda for event-driven processing, enabling robust enterprise search solutions.
HISTORY
The aws-kendra functionality is provided through the AWS Command Line Interface (CLI), which itself was first released in 2013, offering a unified tool to manage AWS services. Amazon Kendra, as a managed search service, was launched by AWS in December 2019, providing a highly scalable and intelligent enterprise search solution powered by machine learning. The kendra
subcommand was subsequently integrated into the AWS CLI, allowing developers and administrators to manage Kendra indexes and perform queries directly from the command line, offering an alternative to the AWS Management Console or SDKs.
SEE ALSO
aws(1): The main AWS Command Line Interface for interacting with various AWS services., aws configure(1): Used for setting up and managing AWS CLI credentials, default region, and output format., aws s3(1): The AWS CLI subcommand for managing Amazon S3, often used as a data source for Kendra., aws iam(1): The AWS CLI subcommand for managing Identity and Access Management, crucial for setting up Kendra permissions.