agent-sense

Human-agent interaction SDK with accessibility and dialogue management

Part of the AumOS open-source agent infrastructure portfolio.

Features

• User context detection infers expertise level, situation, and channel (web, mobile, voice) from conversation signals, enabling responses calibrated to the user's knowledge and environment
• Confidence annotation and calibration — the ConfidenceAnnotator attaches per-claim confidence signals to agent responses and the Disclaimer module adds appropriate hedging when confidence falls below configurable thresholds
• Human handoff orchestration: HandoffRouter evaluates confidence and topic signals, packages the conversation context, and routes to the appropriate human queue with full conversation history attached
• WCAG 2.1 AA accessibility checker inspects HTML fragments for color contrast, missing image alternatives, heading hierarchy violations, and ambiguous link text
• AI disclosure and transparency utilities that inject required disclosure notices and explain the agent's limitations for regulated interaction contexts
• Suggestion engine ranks follow-up prompts and clarifying questions by relevance to the current conversation turn
• Channel adapters for web, mobile, and voice normalize input and format output appropriately for each surface

Quick Start

Install from PyPI:

pip install agent-sense

Verify the installation:

agent-sense version

Basic usage:

import agent_sense

# See examples/01_quickstart.py for a working example

Documentation

• Architecture
• Contributing
• Changelog
• Examples

Enterprise Upgrade

For production deployments requiring SLA-backed support and advanced integrations, contact the maintainers or see the commercial extensions documentation.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

Apache 2.0 — see LICENSE for full terms.

Part of AumOS — open-source agent infrastructure.