Agent Control - Python SDK
Python SDK for adding safety controls and guardrails to AI agents. Protect tools and LLM calls with server-side or local policy enforcement.
Installation
pip install agent-control-sdk
Quick Start
import agent_control
from agent_control import control
# Initialize
agent_control.init(agent_name="my-agent")
# Protect a tool with decorator
@control()
async def search_database(query: str) -> str:
return db.execute(query)
Controls are defined centrally and enforced automatically at runtime. See Python SDK Documentation for complete reference.
Sharing an OpenTelemetry provider with Google ADK
When Google ADK and Agent Control should export through the same OpenTelemetry
pipeline, configure one SDK TracerProvider and pass it to both components:
import agent_control
from opentelemetry import trace
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from openinference.instrumentation.google_adk import GoogleADKInstrumentor
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
resource = Resource.create({"service.name": "my-google-adk-agent"})
provider = TracerProvider(resource=resource)
provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))
trace.set_tracer_provider(provider)
GoogleADKInstrumentor().instrument(tracer_provider=provider)
agent_control.init(
agent_name="my-google-adk-agent",
observability_enabled=True,
observability_sink_name="otel",
observability_sink_config={"enabled": True},
otel_tracer_provider=provider,
)
Agent Control reuses this provider without adding an exporter or span processor. It force-flushes the provider during shutdown but leaves provider shutdown to the application. If no provider is passed, the OTEL sink first checks for a globally registered SDK provider, then falls back to its existing Agent Control-owned OTLP pipeline.
1 maintainer
Metadata
1 maintainer
Release files for agent-control-sdk 8.11.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_control_sdk-8.11.0.tar.gz | 210.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_control_sdk-8.11.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 348.0 kB
Release files / agent_control_sdk-8.11.0.tar.gz
| Download URL | agent_control_sdk-8.11.0.tar.gz |
|---|---|
| Size | 210.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fa9a7aa4a5c5c18645971107552e35a9d7911a9dee24cb4d39b54f046691ae6d
|
|
BLAKE2b-256 checksum How to use checksums |
d24db543650c043906115b8bf5afb6701449d48642e9b0e0aea25931fe886854
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / agent_control_sdk-8.11.0-py3-none-any.whl
| Download URL | agent_control_sdk-8.11.0-py3-none-any.whl |
|---|---|
| Size | 137.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d9c11231c99b4e69115a29da640064d80577b1e93108edf594f1e7ee6dcb362e
|
|
BLAKE2b-256 checksum How to use checksums |
5b436f01442c2a364f6a51d5d1d72e947a3e42a6a3305498910288dd2e0b98cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
