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

# DialNexa Annotations And Call Feedback

> Use DialNexa call annotations to mark transcript turns, provide corrected behavior, and generate prompt improvement suggestions.

DialNexa annotations let users turn a bad or important transcript turn into prompt improvement feedback. From the call detail transcript, users can select a turn, explain expected behavior, and submit an annotation that creates a prompt suggestion for review.

<Tip>
  A good annotation does not say the agent was bad. It says what the agent should have done instead.
</Tip>

## Annotation Fields

Annotations should be specific enough to improve a prompt.

| Field                    | Purpose                                       |
| ------------------------ | --------------------------------------------- |
| Selected transcript turn | The exact call moment being reviewed.         |
| Feedback                 | What was wrong, risky, confusing, or missing. |
| Expected responses       | One or more examples of better behavior.      |
| Agent id context         | Connects the suggestion to the right agent.   |

## Create Useful Feedback

<Steps>
  <Step title="Pick one turn">
    Annotate the exact moment instead of the entire call.
  </Step>

  <Step title="Describe the mismatch">
    Explain what the caller expected and what the agent did.
  </Step>

  <Step title="Add expected response examples">
    Give the model prompt reviewer concrete target behavior.
  </Step>

  <Step title="Submit and review suggestions">
    Use prompt suggestions as candidates, not automatic edits.
  </Step>
</Steps>

## Annotation Quality Checks

<AccordionGroup>
  <Accordion title="Too vague">
    Rewrite feedback to include the caller situation and desired behavior.
  </Accordion>

  <Accordion title="Too broad">
    Create multiple annotations for separate issues.
  </Accordion>

  <Accordion title="No expected response">
    Add at least one better answer so the suggestion has direction.
  </Accordion>

  <Accordion title="Wrong agent context">
    Confirm the call belongs to the agent you want to improve.
  </Accordion>
</AccordionGroup>

## Related Reading

<CardGroup cols={2}>
  <Card title="Call Detail Page" icon="panel-right" href="/monitoring/call-detail-page">
    Open transcript turns.
  </Card>

  <Card title="Prompts" icon="message-square" href="/agents/prompts-and-welcome-messages">
    Apply improvements carefully.
  </Card>

  <Card title="Testing Agents" icon="phone-call" href="/agents/testing-agents">
    Retest the fixed behavior.
  </Card>
</CardGroup>