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://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.4.tar.gz (10.8 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.4-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aegis_bedrock-1.1.4.tar.gz
  • Upload date:
  • Size: 10.8 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.4.tar.gz
Algorithm Hash digest
SHA256 93bf028e7a4025c90995708984cc45d33b56a5b87a69e0785514685db322eda1
MD5 7366eeaba7ff25c0d991d2a317ae04a6
BLAKE2b-256 95c1bec028ac71c9f76bdf371bd5438714b6d657026abfb63ef265ff56db5e9b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aegis_bedrock-1.1.4-py3-none-any.whl
  • Upload date:
  • Size: 11.3 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 83e94f75f53d1be57cc428681c5ab482541aaf859f8aa3351a3f1758e0751ef3
MD5 3fa75f0d9e0fc914895c26c42d000576
BLAKE2b-256 ed3584ce6a563c01a742f94373b87750da03c16a0e1443a1bf95388fc7b27afc

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