vikarti.anatra/Skyvern
1
0
Fork 0
mirror of https://github.com/Skyvern-AI/skyvern.git synced 2026-05-04 06:30:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

docs: Major revamp to Developers and SDK Reference Tabs, Added Documentation for Page/Agent/Browser Methods (#5571)

Browse source
This commit is contained in:
Kunal Mishra 2026-04-24 00:27:04 +05:30 • committed by GitHub
parent 6ff9350619
commit e376b8a7e9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
161 changed files with 9401 additions and 13566 deletions
Download patch file Download diff file Expand all files Collapse all files

22
docs/debugging/troubleshooting-guide.mdx
View file

@ -38,11 +38,11 @@ When a run fails or produces unexpected results, this guide helps you identify t
</Steps>
**Key artifacts to check:**
- `screenshot_final` — Final page state
- `recording` — Video of what happened
- `llm_response_parsed` — What the AI decided to do
- `visible_elements_tree` — What elements were detected
- `har` — Network requests if something failed to load
- `screenshot_final`: Final page state
- `recording`: Video of what happened
- `llm_response_parsed`: What the AI decided to do
- `visible_elements_tree`: What elements were detected
- `har`: Network requests if something failed to load
---
@ -91,7 +91,7 @@ curl -X GET "https://api.skyvern.com/v1/runs/$RUN_ID" \
| `failed` | System error | Browser crash, network failure |
| `terminated` | AI gave up | Login blocked, CAPTCHA, page unavailable |
| `timed_out` | Exceeded `max_steps` | Task too complex, or AI got stuck |
| `canceled` | Manually stopped | — |
| `canceled` | Manually stopped | N/A |
---
@ -216,7 +216,7 @@ See [Using Artifacts](/debugging/using-artifacts) for the full list of artifact
**Symptom:** Getting `504 Gateway Timeout` errors when creating browser sessions.
**Fix:**
- Retry after a few seconds — usually transient
- Retry after a few seconds; usually transient
- For self-hosted: check infrastructure resources
- If persistent, contact support with your run IDs
</Accordion>
@ -288,9 +288,9 @@ See [Using Artifacts](/debugging/using-artifacts) for the full list of artifact
**Symptom:** `failure_reason` mentions CAPTCHA.
**Fix options:**
1. **Browser profile** — Use an authenticated session that skips login
2. **Human interaction block** — Pause for manual CAPTCHA solving
3. **Different proxy** — Use `RESIDENTIAL_ISP` for static IPs sites trust more
1. **Browser profile**: Use an authenticated session that skips login
2. **Human interaction block**: Pause for manual CAPTCHA solving
3. **Different proxy**: Use `RESIDENTIAL_ISP` for static IPs sites trust more
</Accordion>
### Data & Output Issues
@ -338,7 +338,7 @@ See [Using Artifacts](/debugging/using-artifacts) for the full list of artifact
**Fix:**
- Add termination: "STOP if you've attempted this action 3 times without success"
- Add completion markers: "COMPLETE when you see 'Success' message"
- Review loop conditions — ensure exit criteria are achievable
- Review loop conditions to ensure exit criteria are achievable
</Accordion>
---