feat(data_classes): add support for Bedrock Agents event

[rubenfonseca]

Issue number: #3261

Summary

Changes

Please provide a summary of what's being changed

This PR adds event data class support for the Bedrock Agent events and response payloads.

Official docs: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-create.html

User experience

Please share what the user experience looks like before and after this change

Before:

def handler(event: dict):
    print(event["inputText"]) # are you sure you've spelled it correctly? what is the return type?

After this PR, we could start writing Lambdas for Bedrock Agents like this:

from aws_lambda_powertools.utilities.data_classes import BedrockAgentEvent, event_source

@event_source(data_class=BedrockAgentEvent)
def handler(event: BedrockAgentEvent):
    print(event.input_text) # fully typed and filled by the IDE

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[ran-isenberg]

any chance for parser schema too?

[leandrodamascena]

any chance for parser schema too?

Yeah @ran-isenberg! We will add support for Parser and Event Handler.

[rubenfonseca]

Update: As of October 31, 2023, the payload structure of the Lambda input event and response format is changing. So I'm updating this PR to reflect the changes

[codecov-commenter]

Codecov Report

Attention: 1 lines in your changes are missing coverage. Please review.

Comparison is base (b3c9ee0) 95.09% compared to head (fd524b4) 95.06%.
Report is 6 commits behind head on develop.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3262      +/-   ##
===========================================
- Coverage    95.09%   95.06%   -0.04%     
===========================================
  Files          202      203       +1     
  Lines         9408     9470      +62     
  Branches      1719      772     -947     
===========================================
+ Hits          8947     9003      +56     
- Misses         341      345       +4     
- Partials       120      122       +2     

Files	Coverage Δ
...mbda_powertools/utilities/data_classes/__init__.py	100.00% <100.00%> (ø)
...ools/utilities/data_classes/bedrock_agent_event.py	98.50% <98.50%> (ø)

... and 8 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[leandrodamascena]

I left some comments and we are good to merge after addressing them.

[rubenfonseca]

@leandrodamascena ready for another review

[leandrodamascena]

APPROVED!!!

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
1 Code Smell

No Coverage information
0.0% Duplication