> For the complete documentation index, see [llms.txt](https://docs.amigo.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.amigo.ai/intelligence-and-analytics/intelligence/proactive-journeys.md).

# Proactive Journeys

The Journeys section of the Developer Console provides a preview of proactive journey observability - an operating view that tracks the lifecycle of outbound healthcare journeys from initial signal through outreach, agent conversation, evaluation, and final outcome.

{% hint style="info" %}
Journey observability is currently a sample-data preview. The dashboards render a fixed set of demonstration events and are not yet connected to workspace data. A persistent banner discloses this on every journeys page.
{% endhint %}

## What a Proactive Journey Covers

A proactive journey follows a population through a multi-step engagement lifecycle:

1. **Signal.** A cohort of members is identified for outreach based on a triggering condition (for example, an upcoming appointment with missing intake data).
2. **Outreach.** The platform attempts to reach each member through one or more channels (SMS, email, voice, chat).
3. **Conversation.** Members who respond engage in an agent-driven conversation to resolve the identified need.
4. **Evaluation.** Completed conversations are scored for safety, accuracy, and quality.
5. **Outcome.** Each member reaches a terminal state: completed, handed off to a human, unresolved, or opted out.

## Journeys List

The Journeys list page shows the fixed sample journey templates with summary health metrics for each:

* **Funnel visualization.** A stepped bar chart showing member counts at each lifecycle stage from cohort inclusion through completion, so drop-off points are visible at a glance.
* **Outcome strip.** A proportional bar showing the distribution of terminal outcomes (completed, handed off, unresolved, opted out) with color-coded tones.
* **Key metrics.** Cohort size, outreach attempted, reached, conversations started, actions completed, and eval pass rate.

Clicking a journey opens its detail dashboard.

## Journey Detail Dashboard

The journey detail dashboard demonstrates the intended operating view for one sample journey:

### Overview Metrics

A row of KPI cards covering members included, outreach attempted, reached (delivered or responded), conversations started, actions completed, human handoffs, opt-outs and suppressions, eval pass rate, and safety warnings. Each metric includes a definition tooltip explaining how the number is computed.

### Funnel and Outcome Charts

Interactive charts showing the engagement funnel (cohort to completion) and outcome distribution by channel. The outcome-by-channel chart uses consistent tone semantics:

* **Completed** - success tone
* **Handed off** - info tone (a deliberate routing outcome, not a failure)
* **Unresolved** - warning tone (the state that needs attention)
* **Opted out** - neutral tone (a member preference, not a failure)

### Agent Resolution Table

A detailed table of individual member journeys showing signal date, outreach status, channel, conversation status, evaluation result, and terminal outcome. Each row links to a member timeline drawer.

### Member Timeline Drawer

A chronological timeline of the events included in a sample member journey - cohort inclusion, outreach attempts, delivery status, conversation start, agent actions, evaluation results, handoffs, suppressions, and final outcomes. Includes sample conversation identifiers for traceability.

### Quality Panel

Evaluation pass rates and safety warning counts with drill-down to individual members flagged for review.

### Sample Period

The sample data window is labeled explicitly (for example, "May 1 - May 5, 2026") to avoid presenting the fixtures as current workspace activity.

## Navigation

Proactive Journeys is limited to designated Library demo workspaces and is not a standard production sidebar item. Open it through the Developer Console command palette or a direct Library link. The previous routes under `/dashboards/proactive-journey` redirect to `/journeys`, preserving existing demo bookmarks.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.amigo.ai/intelligence-and-analytics/intelligence/proactive-journeys.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.