io.github.imran-siddique/agentos

Attach safety policies to an agent. Policies enforce rules and constraints on agent behavior. Available policy templates: - pii-protection: Protects personally identifiable information (GDPR compliant) - rate-limiting: Prevents resource abuse through rate limits - cost-control: Prevents runaway costs from automated operations - data-deletion: Prevents accidental data loss - secrets-protection: Prevents exposure of secrets and credentials - human-review: Requires human approval for sensitive actions Compliance frameworks: - gdpr-compliance: EU data protection compliance - soc2-security: SOC 2 Type II security controls - hipaa-healthcare: Healthcare data privacy (PHI protection) - pci-dss-payments: Payment card data security

Query the audit trail for an agent. The audit log records: - Every action attempted by the agent - Policy evaluations and decisions - Approval requests and outcomes - Success/failure status - Timestamps and metadata Use for: - Debugging agent behavior - Compliance reporting - Security investigations - Performance analysis

Check an agent's compliance with regulatory frameworks. Supported frameworks: - SOC2: Service Organization Control 2 Type II - GDPR: EU General Data Protection Regulation - HIPAA: Health Insurance Portability and Accountability Act - PCI_DSS: Payment Card Industry Data Security Standard - CCPA: California Consumer Privacy Act - NIST: NIST Cybersecurity Framework - ISO27001: ISO/IEC 27001 Information Security - FEDRAMP: Federal Risk and Authorization Management Program The compliance check evaluates: - Policy coverage for framework requirements - Audit trail completeness - Access control implementation - Data protection measures

Create a new AI agent from a natural language description. The agent will be configured with appropriate policies and safety guardrails. Example usage: - "Create an agent that processes customer feedback from support emails daily" - "Build a data pipeline that backs up my Documents folder to Google Drive" - "Set up an agent to monitor our API health and alert on issues" Returns the agent specification with recommended safety policies.

Create a custom policy from a natural language description. Policies define rules that agents must follow. Example policies: - "Block access to customer credit card data" - "Require approval for any external API calls" - "Rate limit database queries to 100 per minute" - "Log all file deletions" Policies can be based on existing templates: - pii-protection, rate-limiting, cost-control - gdpr-compliance, soc2-security, hipaa-healthcare The policy engine will translate your description into enforceable rules.

Deploy an agent to start execution. Deployment environments: - local: Runs on your machine (default) - cloud: Runs on AgentOS cloud infrastructure (requires API key) Before deployment, the agent must: - Pass all policy checks - Have valid configuration - Have necessary integrations configured For scheduled agents, deployment starts the scheduler. For triggered agents, deployment enables the triggers.

Get the current status, metrics, and health of an agent. Returns: - Current status (draft, testing, deployed, paused, stopped, error) - Execution metrics (runs, success rate, errors) - Recent activity - Policy compliance stats - Resource usage

Browse the library of pre-built agent and policy templates. Agent templates include: - Data processors, email assistants, database analysts - File organizers, backup agents, web scrapers - Slack bots, API monitors, report generators Policy templates include: - Security: PII protection, secrets protection, data deletion safety - Compliance: GDPR, SOC 2, HIPAA, PCI DSS - Operational: Rate limiting, cost control, human review Use templates as a starting point for your custom agents.

Request human approval for a sensitive agent action. Use this when: - Policy requires human review before execution - Agent attempts a high-risk action - You want to add an extra safety check Approval requests are sent to designated approvers via: - Email notification - Slack notification (if configured) - Dashboard alert Requests expire after the specified time (default: 24 hours).

Test an agent with a simulated scenario before deployment. This performs a dry-run that: - Validates the agent configuration - Checks all policies against the test scenario - Simulates workflow execution - Reports any policy violations or issues - Estimates resource usage and costs No actual changes are made during testing.