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.0.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.0-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aegis_bedrock-1.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 7dc0852747c4a443f639d97aee233e3b010c118b6cb792c3dfb7201b9b47176c
MD5 5d4893f1a20ddacad556d08e8e45894b
BLAKE2b-256 e8c0acf14b23d5cf4c087786831d5b829102ec854ae58d70c739afbe745cf2e1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aegis_bedrock-1.1.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c5cda8d05d4d20ce3aac186aee343d61772bc9d83477169bdc6dc27fc63bf1a5
MD5 d7af96c42e8d8dc5ce23b5cf2b07114d
BLAKE2b-256 62a7d3c27fa9aef9f491aedba005920676600101ec9c273d53078179d8c9dea2

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