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

> ## Agent Instructions
> Company name is Akhara AI (never Rubric AI). Keep lowercase rubric/rubrics only when meaning grading criteria.
> Expert Review (docs path talent/) is enterprise BYO experts for audit and review: invite customer specialists; do not pitch Akhara recruiting or a public expert career portal. RLHF and domain writing are secondary work types.
> Prefer concrete API examples against public hosts: Environments eval API https://agi.akhara.ai, Control plane PDP https://api.akhara.dev, Evaluation https://app.akhara.ai / https://api.akhara.ai, Expert Review portal https://talent.akhara.ai.
> Do not invent a public hostname for private orchestrators or env API internals.
> Do not confuse control-plane latches with Environments confirmation latches.
> Environments SDK/API examples: curl against https://agi.akhara.ai. Evaluation SDK: from akhara import Akhara and AKHARA_API_KEY.
> Start with /llms.txt for the docs index and OpenAPI links; fetch individual pages as .md exports.

# Observability Quickstart

> Start logging your healthcare AI outputs in production in under 5 minutes.

## Overview

Akhara's observability features let you capture every AI decision in production. This gives you visibility into what your models are doing and creates the foundation for evaluation and improvement.

<Info>
  This guide assumes you've already [created a project](/evaluation/docs/introduction) in Akhara.
</Info>

## Install the SDK

<CodeGroup>
  ```bash pip theme={null}
  pip install akhara
  ```

  ```bash poetry theme={null}
  poetry add akhara
  ```

  ```bash npm theme={null}
  npm install @akhara/sdk
  ```

  ```bash yarn theme={null}
  yarn add @akhara/sdk
  ```
</CodeGroup>

## Initialize the Client

<CodeGroup>
  ```python Python theme={null}
  from akhara import Akhara

  client = Akhara(api_key="gr_live_xxxxxxxx")
  ```

  ```typescript TypeScript theme={null}
  import Akhara from '@akhara/sdk';

  const client = new Akhara({ apiKey: 'gr_live_xxxxxxxx' });
  ```
</CodeGroup>

<Warning>
  Store your API key in environment variables, not in code. Use `AKHARA_API_KEY` and the SDK will pick it up automatically.
</Warning>

## Log Your First Call

For voice triage applications, log the full conversation with the AI's decision:

```python theme={null}
client.calls.log(
    project="patient-triage",
    
    # Audio recording (optional)
    audio_url="https://storage.example.com/calls/call_123.wav",
    
    # Transcript with speaker labels
    transcript=[
        {"speaker": "agent", "text": "How can I help you today?", "start": 0.0, "end": 2.1},
        {"speaker": "patient", "text": "I've been having chest pain.", "start": 2.5, "end": 5.8},
        {"speaker": "agent", "text": "I understand. When did this start?", "start": 6.0, "end": 8.2}
    ],
    
    # The AI's triage decision
    ai_decision={
        "triage_level": "urgent",
        "extracted_symptoms": ["chest_pain"],
        "confidence": 0.92
    },
    
    # Optional metadata for filtering
    metadata={
        "patient_id": "pat_12345",
        "call_duration": 180,
        "model_version": "v2.1.0"
    }
)
```

## Log Clinical Notes

For documentation assistants, log the generated note:

```python theme={null}
client.notes.log(
    project="visit-summarizer",
    
    # Source transcript/input
    input_text="Patient presents with persistent cough for 2 weeks...",
    
    # Generated clinical note
    output={
        "soap_note": {
            "subjective": "Patient reports 2-week history of...",
            "objective": "VS: BP 120/80, HR 72...",
            "assessment": "1. Acute bronchitis...",
            "plan": "1. Supportive care..."
        },
        "icd_codes": ["J20.9"]
    },
    
    # Expected output for evaluation (optional)
    expected={
        "icd_codes": ["J20.9", "R05"]
    }
)
```

## View Logs in Dashboard

Once you've logged some data, head to the [Akhara Dashboard](https://app.akhara.ai) to:

* Browse individual logs with full context
* Filter by status, score, or metadata
* Identify patterns in AI behavior
* Flag logs for human review

## Next Steps

<CardGroup cols={2}>
  <Card title="Run Evaluations" icon="flask" href="/evaluation/docs/getting-started/evaluation">
    Score your logs with clinical evaluators
  </Card>

  <Card title="Set Up Review" icon="user-check" href="/evaluation/docs/evaluation-framework/human-review-design">
    Route flagged cases to expert reviewers
  </Card>
</CardGroup>