Skip to content

Commit da3d2e1

Browse files
committed
feat(debugging): add videos, update provider status links and wording
1 parent 77e7af7 commit da3d2e1

File tree

6 files changed

+19
-4
lines changed

6 files changed

+19
-4
lines changed

fern/debugging.mdx

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,9 +45,14 @@ Start with these immediate checks before diving deeper:
4545
<Step title="Verify provider status">
4646
Check if AI service providers are experiencing issues:
4747

48-
- Visit [Vapi Status Page](https://status.vapi.ai/) for real-time provider status
49-
- Review speech-to-text, language model, and voice synthesis availability
50-
- Check for ongoing maintenance or outages
48+
- Visit [Vapi Status Page](https://status.vapi.ai/) for Vapi service status
49+
- Check provider status pages for specific services:
50+
- [OpenAI Status](https://status.openai.com/) for OpenAI language models
51+
- [Anthropic Status](https://status.anthropic.com/) for Anthropic language models
52+
- [ElevenLabs Status](https://status.elevenlabs.io/) for ElevenLabs voice synthesis
53+
- [Deepgram Status](https://status.deepgram.com/) for Deepgram speech-to-text
54+
- And other providers' status pages as needed
55+
- Review for ongoing maintenance or outages
5156
</Step>
5257
</Steps>
5358

@@ -64,6 +69,8 @@ Navigate to `Observe > Call Logs` to:
6469
- See tool execution results and errors
6570
- Analyze conversation flow in workflows
6671

72+
<video autoPlay loop muted src="./static/videos/debugging/call-logs.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
73+
6774
### API Logs
6875

6976
Navigate to `Observe > API Logs` to:
@@ -72,6 +79,8 @@ Navigate to `Observe > API Logs` to:
7279
- Verify request payloads and response codes
7380
- Debug integration issues with external services
7481

82+
<video autoPlay loop muted src="./static/videos/debugging/api-logs.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
83+
7584
### Webhook Logs
7685

7786
Navigate to `Observe > Webhook Logs` to:
@@ -80,6 +89,8 @@ Navigate to `Observe > Webhook Logs` to:
8089
- Debug webhook authentication issues
8190
- Monitor event delivery failures
8291

92+
<video autoPlay loop muted src="./static/videos/debugging/webhook-logs.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
93+
8394
### Voice Test Suites
8495

8596
Navigate to `Test > Voice Test Suites` to:
@@ -88,6 +99,8 @@ Navigate to `Test > Voice Test Suites` to:
8899
- Verify assistant behavior across different inputs
89100
- Monitor performance over time
90101

102+
<video autoPlay loop muted src="./static/videos/debugging/voice-test-suites.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
103+
91104
### Tool Testing
92105

93106
For any tool in your `Tools` section:
@@ -96,6 +109,8 @@ For any tool in your `Tools` section:
96109
- Verify tool responses and error handling
97110
- Debug parameter extraction and API calls
98111

112+
<video autoPlay loop muted src="./static/videos/debugging/tool-testing.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
113+
99114
## Speech and language issues
100115

101116
| Problem | Symptoms | Solution |
@@ -138,7 +153,7 @@ For any tool in your `Tools` section:
138153

139154
| Error Pattern | Likely Cause | Quick Fix |
140155
|---------------|--------------|-----------|
141-
| **"I didn't understand"** | Speech recognition issue | Check transcriber model, add custom keyterms |
156+
| **Agent misinterpreting speech** | Speech recognition issue | Check transcriber model, add custom keyterms |
142157
| **Irrelevant responses** | Poor prompt engineering | Be more specific in system prompt |
143158
| **Call drops immediately** | Configuration error | Check all required fields in assistant/workflow settings |
144159
| **Tool errors** | API integration issue | Test tools individually, verify endpoint URLs |
1.89 MB
Binary file not shown.
2.21 MB
Binary file not shown.
2.45 MB
Binary file not shown.
1.24 MB
Binary file not shown.
2.1 MB
Binary file not shown.

0 commit comments

Comments
 (0)