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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.poly.ai/feedback

```json
{
  "path": "/analytics/conversations/annotations",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Annotations

> Flag transcription errors and knowledge gaps during conversation review.

Use annotations to flag specific issues you find during call review, like a word misheard by the ASR, or a question the agent could not answer. Annotations create a running log of improvements, so you can track what needs fixing and measure progress over time.

<img src="https://mintcdn.com/polyai/Qu880HppNqT19Eyr/images/analytics/conversations-wrong-transcription.png?fit=max&auto=format&n=Qu880HppNqT19Eyr&q=85&s=98441b72143e5ca19bb4b5b0818e2a2a" alt="conversations-error" width="1971" height="1993" data-path="images/analytics/conversations-wrong-transcription.png" />

## Annotation types

* **Wrong transcription**: The ASR (automatic speech recognition) produced an incorrect transcript. Use this when the agent misheard the caller.
* **Missing topic**: The agent could not answer a question because no matching topic exists in the [Knowledge](/managed-topics/introduction) area.

## How to annotate a conversation

1. Open a conversation in **Analytics > Conversations**.
2. Find the conversational turn where an issue occurred.
3. Click the annotation icon next to the turn.
4. Select the annotation type (**Wrong transcription** or **Missing topic**).
5. Add optional notes to describe the issue.
6. Save the annotation.

## What happens after you annotate

* Annotations are saved to the conversation and visible to anyone with access to Conversation Review.
* You can share annotations with your PolyAI representative to help improve ASR accuracy or agent behavior.
* Use the **Missing topic** annotations to identify gaps in your [Knowledge](/managed-topics/introduction) area and prioritize new topics to add.
* Over time, annotations create a log of recurring issues that helps you track improvement.

## Best practices

* **Annotate consistently** – Review a sample of conversations regularly and annotate issues as you find them.
* **Be specific in notes** – Include what the caller actually said (for wrong transcriptions) or what question went unanswered (for missing topics).
* **Act on annotations** – Use them as input when updating your Knowledge area, [ASR keyphrase boosting](/speech-recognition/introduction), or [transcript corrections](/speech-recognition/introduction).

## Related pages

<CardGroup cols={2}>
  <Card title="Conversation review" icon="magnifying-glass" href="/analytics/conversations/review">
    Browse and inspect conversations to find issues for annotation.
  </Card>

  <Card title="Conversation diagnosis" icon="stethoscope" href="/analytics/conversations/diagnosis">
    Debug agent behavior at each turn after reviewing transcripts.
  </Card>
</CardGroup>