Skip to main content

AWS Bedrock Agents governance middleware for Aegis ACP

Project description

aegis-bedrock

AWS Bedrock Agents governance middleware for Aegis ACP. Intercepts invoke_agent action-group calls and consults Aegis /execute before any tool runs — same SDK contract as aegis-anthropic and aegis-openai.

Install

pip install "aegis-bedrock[bedrock]"

Use

Drop-in replacement for boto3.client("bedrock-agent-runtime"):

from aegis_bedrock import AegisBedrockAgentRuntime

client = AegisBedrockAgentRuntime(
    aegis_key="acp_…",
    aegis_url="https://ha.aegisagent.in",
    tenant_id="00000000-0000-0000-0000-000000000001",
    agent_id="<your-aegis-agent-id>",
    region_name="us-east-1",          # standard boto3 kwarg
)

response = client.invoke_agent(
    agentId="…",
    agentAliasId="…",
    sessionId="…",
    inputText="Find the customer that owes the most.",
)

Every Bedrock action-group invocation is checked by Aegis before the underlying lambda fires. Blocked actions are replaced with a text-only response explaining the denial; the buyer's Bedrock agent sees a clean governance message instead of a side-effecting tool call.

What Aegis governs

Bedrock primitive Aegis maps to Notes
Action group invocation tool.<action_name> arguments = the JSON parameter block
Knowledge-base query tool.kb_search arguments = {query, retrievalConfiguration}
Code-interpreter call tool.python_exec arguments.code is the Python body

The same per-tool ALLOW grants you've already configured for your Aegis agent are honoured by Bedrock calls — no separate Bedrock permission model.

Standard wrapper guarantees

  • Verdicts are pre-checked. A blocked tool never invokes the lambda / knowledge base / interpreter.
  • HTML 403 (WAFv2) surfaces as findings=["waf_blocked"], same as the other SDKs.
  • JSON parse / network errors fail closed (action="deny").

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aegis_bedrock-1.1.1.tar.gz (9.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aegis_bedrock-1.1.1-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file aegis_bedrock-1.1.1.tar.gz.

File metadata

  • Download URL: aegis_bedrock-1.1.1.tar.gz
  • Upload date:
  • Size: 9.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for aegis_bedrock-1.1.1.tar.gz
Algorithm Hash digest
SHA256 8d98bde2d1a5e438972eb0cf70bdbdb11a489594afd448c0d5a2a34089aca2ff
MD5 05ad4f31571d3c100bce0f6af8cb4ada
BLAKE2b-256 9488fd249c28823fb32134d4742160c77386ea3fe63465f01cbac528bbca118a

See more details on using hashes here.

File details

Details for the file aegis_bedrock-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: aegis_bedrock-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 9.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for aegis_bedrock-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e8f59493152ec56ca498ac2f9511fa46db5e092a84952bcc7d514a74bc3d3bdd
MD5 1e8cfb9268d6a16fd46c30c90e44d7a0
BLAKE2b-256 31088521d50346acd9b9a876e0036159b02f2584f154377e31efc63f106fc9bb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page