Docs/Tutorials

Tutorials

Step-by-step interactive tutorials available in the Console Dev Hub. From your first secured API call to advanced policy-based access control and human-in-the-loop approvals.

Interactive Tutorials in Console

These tutorials are in the console’s Dev Hub. Installing with macaw-ai creates your workspace; then get hands-on with the SDK, Activity Graph, and real-time policy enforcement.

Get Started

Available Tutorials

Tutorial 1Beginner·10-15 min

Hello World

Your first secured AI call

Install the SDK, run the test harness with 21 tests across 4 frameworks (OpenAI, Anthropic, LangChain, MCP). Explore the Activity Graph, Logs, and add your first policy.

Install the SDKRun 21 adapter testsWatch the Activity GraphAdd an intent policy
Tutorial 2Intermediate·20-30 min

Policy-Based Access Control

Role-based AI access control

Build a multi-user app where alice, bob, and carol have different access levels. Learn policy inheritance, identity providers, and claims mapping.

Define per-user access controlConfigure identity providersSwitch IdPs with zero code changesUse bind_to_user patterns
Tutorial 3Intermediate·25-30 min

MAPL Policy Language

Master the policy language

Deep dive into MAPL — the MACAW Agentic Policy Language. Learn policy structure, inheritance, constraints, attestations, and composition semantics.

Policy structure and JSON anatomyResources, wildcards, and denialsInheritance and compositionConstraints and attestations
Tutorial 4Intermediate·12-15 min

External Attestations

Human-in-the-loop approvals

Build a two-terminal demo where Alice requests a high-value trade and Bob (manager) must approve it. Learn the blocking flow and approval APIs.

Blocking approval flowConditional attestation requirementsApproval lifecycleManager approval APIs
Tutorial 5Intermediate·10-12 min

Attestation Grants

Reusable approvals

Learn the grants pattern where admin approves a capability once and the user can reuse it repeatedly. First call blocks, subsequent calls are instant.

Grants vs one-time attestationsConfigure reusable approvalsAdmin grant workflowInstant subsequent calls

Ready to get started?

Install MACAW, then open the Dev Hub in the console for interactive walkthroughs.

Open Console

Related Documentation