# Setup guide — User Feedback Synthesis Agent

## 1. Install and connect feedback sources

Install the agent and connect it to your feedback sources.

```
pipx install feedback-synth-agent
feedback-synth-agent connect --sources zendesk,appstore,typeform
feedback-synth-agent doctor
```

## 2. Configure honesty guardrails

Thresholds for confidence and the no-fabrication posture.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
LOW_CONFIDENCE_BELOW_N=5
REQUIRE_REAL_QUOTES=true
REDACT_PII=true
```

## 3. Set scope and segments

Define the period and any segmentation for the synthesis.

```
# scope.yml
period: last_30d
segment_by: [plan_tier]
min_theme_size: 3   # smaller clusters are reported as low-confidence, not dropped silently
```

## 4. Run a synthesis

Generate themes and review the cited frequencies and quotes.

```
feedback-synth-agent run --period 30d --explain
# prints themes with count/frequency/quotes/confidence + counter-signal
```

## 5. Wire into your workflow

Schedule recurring synthesis and post to your PM channel or docs.

```
# weekly job -> voice-of-customer summary to #product (read-only synthesis)
```
