feat(bedrock_agents): add optional fields to response payload

[anafalcao]

Issue number:

Summary

Changes

This PR introduces the new BedrockResponse class to support custom Amazon Bedrock Agent responses.

1. BedrockResponse class with support for:
   • Session attributes
   • Prompt session attributes
   • Knowledge base configurations
2. Type-safe implementation with proper validation
3. Example showing how to use BedrockResponse with Bedrock Agents in the documentation

User experience

response = BedrockResponse(
    body={"message": "Hello from Bedrock!"},
    session_attributes={"user_id": "123"},
    prompt_session_attributes={"context": "testing"},
    knowledge_bases_configuration=[
        {
            "knowledgeBaseId": "kb-123",
            "retrievalConfiguration": {
                "vectorSearchConfiguration": {"numberOfResults": 3, "overrideSearchType": "HYBRID"},
            },
        },
    ],
)

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.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.32%. Comparing base (72f9d2b) to head (f23f09e).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #6336   +/-   ##
========================================
  Coverage    96.31%   96.32%           
========================================
  Files          242      242           
  Lines        11710    11730   +20     
  Branches       871      876    +5     
========================================
+ Hits         11279    11299   +20     
  Misses         337      337           
  Partials        94       94           

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud