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

# Training & Giving Feedback

> Refine your AI worker through natural conversation and targeted corrections

## Overview

Spinnable allows you to improve your AI worker's performance through conversational feedback. Rather than technical configuration, you can simply tell your worker what it's doing wrong and how to improve — just like training a team member.

## How It Works

### The Feedback Loop

1. **Observe** - Notice when the worker provides incorrect or suboptimal responses
2. **Correct** - Give feedback in natural language during the conversation
3. **Refine** - The worker learns from your corrections and applies them to future interactions

### Types of Feedback

<CardGroup cols={2}>
  <Card title="Factual Corrections" icon="check">
    Correct inaccurate information or outdated details
  </Card>

  <Card title="Tone Adjustments" icon="message">
    Refine communication style and personality
  </Card>

  <Card title="Process Improvements" icon="arrow-progress">
    Optimise workflows and response patterns
  </Card>

  <Card title="Knowledge Gaps" icon="book">
    Fill in missing information or context
  </Card>
</CardGroup>

## Best Practices

### Be Specific

<CodeGroup>
  ```text Good Feedback theme={null}
  "When customers ask about pricing, always mention our 14-day free trial first, then explain the three pricing tiers: Starter ($29/mo), Professional ($99/mo), and Enterprise (custom pricing)."
  ```

  ```text Avoid theme={null}
  "Fix the pricing information."
  ```
</CodeGroup>

### Provide Context

Give your worker the "why" behind corrections so it can generalise the learning:

<CodeGroup>
  ```text Good Feedback theme={null}
  "Don't use technical jargon like 'API endpoints' when talking to non-technical users. Instead, say 'integration options' or 'ways to connect'. Our customer base includes many small business owners without technical backgrounds."
  ```

  ```text Avoid theme={null}
  "Stop using technical terms."
  ```
</CodeGroup>

### Correct in Real-Time

The most effective feedback happens during actual conversations:

<Steps>
  <Step title="Notice the Issue">
    Observe when the worker makes a mistake or could perform better
  </Step>

  <Step title="Provide Immediate Feedback">
    Correct the worker in the same conversation thread
  </Step>

  <Step title="Verify Understanding">
    Ask the worker to confirm it understood the correction
  </Step>

  <Step title="Test the Learning">
    Try similar scenarios to ensure the improvement stuck
  </Step>
</Steps>

## Real-World Example: MDS Portugal

MDS Portugal, a healthcare technology provider, uses Spinnable's feedback system to continuously refine their customer support worker.

### Initial Challenge

Their worker was providing technically accurate but overly complex explanations to healthcare providers who needed quick, actionable answers.

### Feedback Applied

<CodeGroup>
  ```text Example Correction 1 theme={null}
  "When doctors ask about patient data security, start with the simple answer: 'Your patient data is encrypted and HIPAA-compliant.' Only provide technical details if they ask follow-up questions. Healthcare professionals are busy and need quick reassurance first."
  ```

  ```text Example Correction 2 theme={null}
  "If someone asks about integration with their existing EHR system, first ask which specific EHR they use (Epic, Cerner, Meditech, etc.) rather than explaining all possibilities. This saves time and gives more relevant information."
  ```

  ```text Example Correction 3 theme={null}
  "When discussing our mobile app, emphasise that it works offline for home visits. Many of our users are district nurses who need this feature but don't think to ask about it."
  ```
</CodeGroup>

### Results

<CardGroup cols={3}>
  <Card title="40% Faster" icon="clock">
    Average conversation time reduced
  </Card>

  <Card title="92% Satisfaction" icon="star">
    Customer satisfaction score
  </Card>

  <Card title="60% Reduction" icon="arrow-down">
    Escalations to human support
  </Card>
</CardGroup>

## Feedback Patterns

### Handling Edge Cases

When you notice the worker struggling with unusual scenarios:

```text Example theme={null}
"When customers from the EU ask about data storage, mention that we have data centres in Frankfurt and Dublin. They're often asking because of GDPR requirements, even if they don't explicitly mention it."
```

### Improving Empathy

Enhance the worker's emotional intelligence:

```text Example theme={null}
"When someone says they're frustrated or having trouble, acknowledge their feeling first: 'I understand this is frustrating' or 'I can see why that's confusing.' Then offer help. Don't jump straight to the solution."
```

### Setting Boundaries

Teach the worker what it should and shouldn't handle:

```text Example theme={null}
"If someone asks for medical advice or diagnosis, you must say: 'I can't provide medical advice. Please consult with your healthcare provider about symptoms or treatment.' Then offer to help with questions about using our software instead."
```

## Measuring Improvement

Track how your feedback is impacting performance:

<Steps>
  <Step title="Monitor Conversations">
    Review worker interactions regularly in the dashboard
  </Step>

  <Step title="Identify Patterns">
    Look for recurring issues or successful resolutions
  </Step>

  <Step title="Apply Systematic Feedback">
    Address patterns with targeted corrections
  </Step>

  <Step title="Verify Changes">
    Test the worker in similar scenarios to confirm improvements
  </Step>
</Steps>

## Advanced Techniques

### Scenario-Based Training

Create test scenarios to validate improvements:

1. **Prepare test cases** — Write example conversations that previously caused issues
2. **Run the scenario** — Have the worker respond to the test case
3. **Evaluate performance** — Check if the worker applies previous feedback correctly
4. **Provide refinement** — Add additional feedback if needed

### Collaborative Training

Involve your team in the feedback process:

<Card title="Team Training Best Practices" icon="users">
  * Share effective feedback examples with team members
  * Document common issues and recommended corrections
  * Assign team members to focus on specific worker capabilities
  * Review weekly to ensure a consistent training approach
</Card>

## Common Pitfalls to Avoid

<Warning>
  **Contradictory Feedback**: Ensure your corrections are consistent. If you tell the worker to "be brief" in one conversation and "provide detailed explanations" in another, clarify when each approach is appropriate.
</Warning>

<Warning>
  **Overfitting to Single Cases**: Don't over-correct based on one unusual interaction. Look for patterns before providing feedback.
</Warning>

<Warning>
  **Unclear Expectations**: Vague feedback like "be better" or "improve responses" doesn't give the worker actionable guidance.
</Warning>

## When feedback alone isn't enough

If a worker is doing something inconsistently even after repeated feedback, the fix is almost always a **Skill** — not a support ticket. Save the process as a skill and your worker will execute it the same way every time.

<Tip>
  Tell your worker: **"Let's create a skill for this."** They'll guide you through naming it, confirming the steps, and saving it for future use. See [Skills](/concepts/skills) for more.
</Tip>

Only reach out to support if you've tried direct feedback, skills, and the [troubleshooting guide](/troubleshooting/index) and still can't resolve the issue.

## Next Steps

<CardGroup cols={2}>
  <Card title="Worker Memory" icon="database" href="/concepts/worker-memory">
    Learn how workers remember information
  </Card>

  <Card title="How Workers Learn" icon="brain" href="/concepts/how-workers-learn">
    Understand the learning process
  </Card>

  <Card title="Skills" icon="bolt" href="/concepts/skills">
    Lock in consistent behaviour with reusable skills
  </Card>

  <Card title="Managing Workers" icon="users" href="/guides/managing-workers">
    Best practices for managing your workers
  </Card>
</CardGroup>