vendor_connectors.aws.tools
AI framework tools for AWS operations.
This module provides tools for AWS operations that work with multiple AI agent frameworks. The core functions are framework-agnostic Python functions, with native wrappers for each supported framework.
Supported Frameworks:
- LangChain (via langchain-core) - get_langchain_tools()
- CrewAI - get_crewai_tools()
- AWS Strands - get_strands_tools() (plain functions)
- Auto-detection - get_tools() picks the best available
Tools provided:
- aws_get_caller_account_id: Get current AWS account ID
- aws_list_s3_buckets: List S3 buckets
- aws_list_s3_objects: List objects in an S3 bucket
- aws_list_accounts: List AWS organization accounts
- aws_list_sso_users: List IAM Identity Center users
- aws_list_sso_groups: List IAM Identity Center groups
- aws_list_secrets: List secrets from Secrets Manager
- aws_get_secret: Get a secret value
Usage: from vendor_connectors.aws.tools import get_tools tools = get_tools() # Returns best format for installed framework
Module Contents
Section titled “Module Contents”Classes
Section titled “Classes”GetCallerAccountIdSchema | Schema for getting caller account ID. |
|---|---|
ListS3BucketsSchema | Schema for listing S3 buckets. |
ListS3ObjectsSchema | Schema for listing S3 objects. |
ListAccountsSchema | Schema for listing AWS accounts. |
ListSSOUsersSchema | Schema for listing SSO users. |
ListSSOGroupsSchema | Schema for listing SSO groups. |
ListSecretsSchema | Schema for listing secrets. |
GetSecretSchema | Schema for getting a secret. |
Functions
Section titled “Functions”get_caller_account_id | Get the AWS account ID of the caller. |
|---|---|
list_s3_buckets | List S3 buckets in the account. |
list_s3_objects | List objects in an S3 bucket. |
list_accounts | List AWS organization accounts. |
list_sso_users | List IAM Identity Center users. |
list_sso_groups | List IAM Identity Center groups. |
list_secrets | List secrets from AWS Secrets Manager. |
get_secret | Get a single secret value from AWS Secrets Manager. |
get_langchain_tools | Get all AWS tools as LangChain StructuredTools. |
get_crewai_tools | Get all AWS tools as CrewAI tools. |
get_strands_tools | Get all AWS tools as plain Python functions for AWS Strands. |
get_tools | Get AWS tools for the specified or auto-detected framework. |
TOOL_DEFINITIONS |
|---|
class vendor_connectors.aws.tools.GetCallerAccountIdSchema
Section titled “class vendor_connectors.aws.tools.GetCallerAccountIdSchema”Bases: pydantic.BaseModel
Schema for getting caller account ID.
class vendor_connectors.aws.tools.ListS3BucketsSchema
Section titled “class vendor_connectors.aws.tools.ListS3BucketsSchema”Bases: pydantic.BaseModel
Schema for listing S3 buckets.
class vendor_connectors.aws.tools.ListS3ObjectsSchema
Section titled “class vendor_connectors.aws.tools.ListS3ObjectsSchema”Bases: pydantic.BaseModel
Schema for listing S3 objects.
bucket : str
Section titled “bucket : str”‘Field(…)’
class vendor_connectors.aws.tools.ListAccountsSchema
Section titled “class vendor_connectors.aws.tools.ListAccountsSchema”Bases: pydantic.BaseModel
Schema for listing AWS accounts.
class vendor_connectors.aws.tools.ListSSOUsersSchema
Section titled “class vendor_connectors.aws.tools.ListSSOUsersSchema”Bases: pydantic.BaseModel
Schema for listing SSO users.
class vendor_connectors.aws.tools.ListSSOGroupsSchema
Section titled “class vendor_connectors.aws.tools.ListSSOGroupsSchema”Bases: pydantic.BaseModel
Schema for listing SSO groups.
class vendor_connectors.aws.tools.ListSecretsSchema
Section titled “class vendor_connectors.aws.tools.ListSecretsSchema”Bases: pydantic.BaseModel
Schema for listing secrets.
prefix : str
Section titled “prefix : str”‘Field(…)’
get_values : bool
Section titled “get_values : bool”‘Field(…)’
class vendor_connectors.aws.tools.GetSecretSchema
Section titled “class vendor_connectors.aws.tools.GetSecretSchema”Bases: pydantic.BaseModel
Schema for getting a secret.
secret_id : str
Section titled “secret_id : str”‘Field(…)’
vendor_connectors.aws.tools.get_caller_account_id() → dict[str, str]
Section titled “vendor_connectors.aws.tools.get_caller_account_id() → dict[str, str]”Get the AWS account ID of the caller.
Returns: Dict with account_id field.
vendor_connectors.aws.tools.list_s3_buckets() → list[dict[str, Any]]
Section titled “vendor_connectors.aws.tools.list_s3_buckets() → list[dict[str, Any]]”List S3 buckets in the account.
Returns: List of bucket info (name, creation_date, region).
vendor_connectors.aws.tools.list_s3_objects(bucket: str) → list[dict[str, Any]]
Section titled “vendor_connectors.aws.tools.list_s3_objects(bucket: str) → list[dict[str, Any]]”List objects in an S3 bucket.
Args: bucket: The name of the S3 bucket.
Returns: List of object info (key, size, last_modified).
vendor_connectors.aws.tools.list_accounts() → list[dict[str, Any]]
Section titled “vendor_connectors.aws.tools.list_accounts() → list[dict[str, Any]]”List AWS organization accounts.
Returns: List of account info (id, name, email, status).
vendor_connectors.aws.tools.list_sso_users() → list[dict[str, Any]]
Section titled “vendor_connectors.aws.tools.list_sso_users() → list[dict[str, Any]]”List IAM Identity Center users.
Returns: List of user info (user_id, user_name, display_name, email).
vendor_connectors.aws.tools.list_sso_groups() → list[dict[str, Any]]
Section titled “vendor_connectors.aws.tools.list_sso_groups() → list[dict[str, Any]]”List IAM Identity Center groups.
Returns: List of group info (group_id, display_name, member_count).
vendor_connectors.aws.tools.list_secrets(prefix: str = ”, get_values: bool = False) → list[dict[str, Any]]
Section titled “vendor_connectors.aws.tools.list_secrets(prefix: str = ”, get_values: bool = False) → list[dict[str, Any]]”List secrets from AWS Secrets Manager.
Args: prefix: Optional prefix to filter secrets by name get_values: If True, fetch actual secret values
Returns: List of secret info (name, arn, value).
vendor_connectors.aws.tools.get_secret(secret_id: str) → dict[str, Any]
Section titled “vendor_connectors.aws.tools.get_secret(secret_id: str) → dict[str, Any]”Get a single secret value from AWS Secrets Manager.
Args: secret_id: The ARN or name of the secret to retrieve
Returns: Dict with secret_name, secret_value, and status.
vendor_connectors.aws.tools.TOOL_DEFINITIONS
Section titled “vendor_connectors.aws.tools.TOOL_DEFINITIONS”None
vendor_connectors.aws.tools.get_langchain_tools() → list[Any]
Section titled “vendor_connectors.aws.tools.get_langchain_tools() → list[Any]”Get all AWS tools as LangChain StructuredTools.
vendor_connectors.aws.tools.get_crewai_tools() → list[Any]
Section titled “vendor_connectors.aws.tools.get_crewai_tools() → list[Any]”Get all AWS tools as CrewAI tools.
vendor_connectors.aws.tools.get_strands_tools() → list[Any]
Section titled “vendor_connectors.aws.tools.get_strands_tools() → list[Any]”Get all AWS tools as plain Python functions for AWS Strands.
vendor_connectors.aws.tools.get_tools(framework: str = ‘auto’) → list[Any]
Section titled “vendor_connectors.aws.tools.get_tools(framework: str = ‘auto’) → list[Any]”Get AWS tools for the specified or auto-detected framework.