> ## Documentation Index
> Fetch the complete documentation index at: https://docs.medera.info/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview of the Medera Agentic Framework

> Behavioral-health-native AI for every clinical and operational workflow.

The Medera Agentic Framework is a modular AI system for product teams building clinical and operational behavioral-health workflows — without spending months on agent architecture. It ships with a **canvas-based workflow engine** (16 core nodes + 8 BH-OS rails), a **multi-agent care orchestrator**, and a **typed expert registry**. It is designed to support use cases across behavioral health — from patient-facing intake voice agents to clinician-facing scribes, multimodal co-therapy, and back-office prior authorization.

***

## What problems it solves

1. LLMs do not have reliable access to clinical data LLMs cannot be trusted to rely on internal knowledge alone. In behavioral health, responses must be grounded in **validated screeners**, **payer policy**, **chart context**, and **peer-reviewed evidence**. Without access to these sources at runtime, models are forced to infer or guess — which is unacceptable in clinical settings. The Medera Agentic Framework gives agents direct access to a typed expert registry (PHQ-9, C-SSRS, ICD-10, PubMed, DrugBank, Payer Policy, …). Instead of hallucinating, agents look things up, verify context, and base their outputs on authoritative sources.

### 2. LLMs cannot safely act on the world

Clinical workflows involve interacting with real systems — querying EHRs, drafting documentation, generating referrals, submitting prior authorizations, and triggering downstream processes. The framework provides a controlled execution layer that lets agents plan actions, invoke experts, and coordinate multi-step workflows within explicit safety boundaries. Where necessary, agents pause execution at a `user-approval` node, request a human decision, and resume only after explicit consent is recorded in `workflow_approvals`.

***

## What you can build

<CardGroup cols={2}>
  <Card title="Clinician-facing assistants" icon="https://mintcdn.com/medera-357fd587/n1mgcc3nR2sq_PoL/icons/ui/stethoscope.svg?fit=max&auto=format&n=n1mgcc3nR2sq_PoL&q=85&s=c8a7441d30a2ae7471a136c60f734adc" width="40" height="40" data-path="icons/ui/stethoscope.svg">
    Visit Scribe with in-encounter SOAP drafting, Co-Therapy multimodal in-session signal, CDI concurrent review.
  </Card>

  <Card title="Patient-facing voice agents" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/phone-call.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=0641cefb018ceaff15b61df9ffe8c32f" width="40" height="40" data-path="icons/ui/phone-call.svg">
    intake agent, the Care Coordinator Agent (care coordination), the Referral Specialist Agent (referral), the PA Specialist Agent (prior auth) on Medera Voice + Medera STT + Medera voice.
  </Card>

  <Card title="Programmatic agent endpoints" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/code.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=55229463dbd5bbb579cce6192dbc5ffc" width="40" height="40" data-path="icons/ui/code.svg">
    Embedded into existing clinical software via REST, triggered by events, APIs, or Medera Voice webhooks.
  </Card>

  <Card title="Customer-embedded agents" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/puzzle.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=eba447b2f1e34fad34c796c184970d9d" width="40" height="40" data-path="icons/ui/puzzle.svg">
    Plug your own tools and EHR integrations via MCP. Agents combine Medera, third-party, and your own capabilities.
  </Card>
</CardGroup>

***

## Built for behavioral health by design

Behavioral health is not a general-purpose domain, and the platform reflects that reality.

## Safety first

Typed inputs and outputs, explicit expert schemas, guardrail nodes for HIPAA / 42 CFR Part 2 / suicide-language detection, and a non-bypassable crisis escalation path.

## Auditability

Every decision, expert invocation, and tool call is recorded in `execution_trace[]`.

Deployment actions write to a WORM `deployment_audit_log` chained with Merkle integrity checkpoints.

## Domain-specific reasoning

`gpt-4o` for SOAP and post-visit analysis (T=0.3, JSON mode), `gpt-4o-mini` for real-time NLP, `Medera reasoning` for voice agent LLMs (T=0.3, max 500 tokens). Tuned for behavioral-health language.

## Multi-agent architecture

Four voice agents and six workflow agents coordinated by the Care Orchestrator with an event bus carrying typed events (`INTAKE_*`, `PA_*`, `REFERRAL_*`, …).

## Memory and context management

Per-execution with five variable scopes (`workflow.input`, `state.*`, `nodes.*.output`, `runtime.context`, `tenant.secret`) plus persistent agent memory under `thread`, `patient`, or `tenant` scope.

## Prebuilt experts

A typed library of clinical capabilities — Vocal Prosody, Linguistic Content, Validated Screener, C-SSRS Risk, ESI Acuity, ICD-10, CPT / E\&M, PubMed, DrugBank, ClinicalTrials.gov, Payer Policy, and more.

## Third-party integrations

Plug directly into Epic, Cerner, athenahealth, Allscripts, eClinicalWorks, NextGen via FHIR R4; e-Rx network for e-prescribing; billing clearinghouse for billing; and MCP servers for custom tools.

## Runtime context

Pass relevant context per request — FHIR resources, screener scores, patient demographics — so experts work with rich, domain-specific information.

***

## Who it's for

The Medera Agentic Framework is built for teams working on behavioral and mental health software: - **Healthcare software companies** embedding intelligent automation directly into their products

* **Health systems** building internal AI-powered clinical workflows

* **Advanced engineering teams** that need flexibility, control, and safety guarantees without building bespoke agent infrastructure The platform is not limited to prompt-based chatbots. It is designed to go from demo to **production-grade clinical AI systems** that operate safely in real-world settings.

***

## Agents vs. workflows

Understanding the difference helps you pick the right approach. **Agents** are autonomous systems that reason and adapt. They use the LLM to understand context, make decisions, and take actions even in scenarios they haven't seen before. Agents excel at open-ended tasks that require judgment — intake, triage, multimodal analysis, and PA appeals. **Workflows** are structured, step-by-step processes that follow predefined paths. They execute in a fixed order — like a recipe or a checklist. Workflows are ideal for repeatable processes that demand consistency and compliance — measurement-based care, eligibility verification, claims scrubbing. In Medera, the **Canvas** lets you blend both — agent nodes for judgment-heavy work, deterministic logic nodes (`condition`, `transform`, `classify`, `wait`, `user-approval`) for compliance-heavy work, and guardrail nodes that span both.

<Note>
  Contact us if you need more information about the Medera Agentic Framework. [medera.info/contact](https://medera.info/contact)
</Note>
