# Ambient Precision

> Calibrated human judgment, for the moments a machine should not decide alone. Human Handoff API: send a typed question, a person answers with the Ergo Thumb, get a typed answer back.

## Pages

- [When the machine isn't sure](https://ambientprecision.com/handoff): Human handoff for systems that answer with a confidence, with Jev as an example and a private thumb demo.
- [Handoff page as Markdown](https://ambientprecision.com/handoff.md): Install lines and the LangChain handoff example, default threshold 0.8.

## Introduction

- [Introduction](https://ambientprecision.com/docs/introduction.md): What Human Handoff is and the 60-second start.
- [API reference](https://ambientprecision.com/docs/api.md): POST /v1/handoff, GET /v1/handoff/:ticket, GET /v1/versions, errors and rate limits.

## Concepts

- [Calibrated human judgment](https://ambientprecision.com/docs/calibrated-judgment.md): Why a person's number is useful once you know how well it tracks what happens.
- [The gut-first order](https://ambientprecision.com/docs/gut-first.md): Gut, then head, then heart, then your number.
- [The biological check](https://ambientprecision.com/docs/biological-check.md): When the gut agrees with the machine, skip the slow path.
- [Confidence for a human answer](https://ambientprecision.com/docs/human-confidence.md): 1 minus the spread of gut, head and final, divided by 10.
- [Updating after the reveal](https://ambientprecision.com/docs/update-after-reveal.md): The pre-reveal final is the answer; one optional Land again sweep is kept apart as updated_read and moved.
- [Question class and the 30-resolved gate](https://ambientprecision.com/docs/question-class.md): Every question has a class; a person's reads combine only after 30 resolved forecasts in that class.

## Answer types

- [Answer types](https://ambientprecision.com/docs/answer-types.md): likelihood, levels, pick, and how Jev's shape maps.
- [Say it your way: POST /v1/felt](https://ambientprecision.com/docs/say-it-your-way.md): Map a typed felt-sense phrase to a proposed value and range; commit only what the person confirms.

## Patterns

- [One card with several questions](https://ambientprecision.com/docs/pattern-one-card.md): Fan-out: several questions, one card, answered independently.
- [Confidence bands](https://ambientprecision.com/docs/pattern-confidence-bands.md): Act, confirm, or hand to a person.
- [Combining several levels answers](https://ambientprecision.com/docs/pattern-combining-levels.md): Normalise each, weight in code, keep the raw answers.
- [Routing between machine and person](https://ambientprecision.com/docs/pattern-routing.md): One code path for machine and human answers.
- [Decision practices: stakes, ranges, stop conditions, reviews](https://ambientprecision.com/docs/decision-practices.md): matters_in_a_year, surprise ranges, stop conditions with dates, reviews with the outcome hidden, luck reads and imagined failure.

## Cookbooks

- [Founder's decision journal](https://ambientprecision.com/docs/cookbook-decision-journal.md): A forecast with a resolve date, checked when due.
- [Team check-in](https://ambientprecision.com/docs/cookbook-team-check-in.md): Levels across a group of up to 12 under HumanSafe.
- [Agent escalation](https://ambientprecision.com/docs/cookbook-agent-escalation.md): A Jev answer at 0.55 handed to a person.
- [Tool-call review by a person](https://ambientprecision.com/docs/cookbook-tool-call-review.md): Ask before an agent runs an action it cannot undo.

## Versions

- [Versions](https://ambientprecision.com/docs/versions.md): ap-latest, ap-preview, pinned ap-1.0.0.

## Limits

- [Limits](https://ambientprecision.com/docs/limits.md): Where people's judgment is unreliable, and why the machine answer is hidden.

## Privacy

- [Privacy](https://ambientprecision.com/docs/privacy.md): Never used to train models; readings belong to the person.

## Optional

- [Legal](https://ambientprecision.com/docs/legal.md): Terms, specification licence, patent and trademarks.

## Machine-readable

- [OpenAPI](https://ambientprecision.com/openapi.json): Human Handoff API v1, including question class, updated_read and moved, POST /v1/felt and the 30-resolved gate.
- [Agent skill](https://ambientprecision.com/skill.md): when and how to hand a judgment to a person.