suchintan's feedback + changelog (#4947)
Some checks are pending
Run tests and pre-commit / Run tests and pre-commit hooks (push) Waiting to run
Run tests and pre-commit / Frontend Lint and Build (push) Waiting to run
Publish Fern Docs / run (push) Waiting to run

Co-authored-by: Ritik Sahni <ritiksahni0203@gmail.com>
This commit is contained in:
Naman 2026-03-03 00:11:31 +05:30 committed by GitHub
parent a4d9c9dd22
commit 59cd1e10bb
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
29 changed files with 885 additions and 148 deletions

View file

@ -32,6 +32,7 @@ Only `prompt` is a required parameter.
| [`max_screenshot_scrolls`](#max_screenshot_scrolls) | integer | Capture lazy-loaded content in screenshots |
| [`browser_address`](#browser_address) | string | Connect to your own browser for local development |
| [`include_action_history_in_verification`](#include_action_history_in_verification) | boolean | Improve verification accuracy for multi-step forms |
| [`run_with`](#run_with) | string | Choose whether to run with the AI agent or generated code |
| [`model`](#model) | object | Configure model settings (e.g., temperature) |
---
@ -296,6 +297,11 @@ Use this for geo-restricted content or to reduce bot detection.
| `RESIDENTIAL_KR` | South Korea |
| `RESIDENTIAL_TR` | Turkey |
| `RESIDENTIAL_ISP` | ISP proxy |
| `US-CA` | California, US |
| `US-NY` | New York, US |
| `US-TX` | Texas, US |
| `US-FL` | Florida, US |
| `US-WA` | Washington, US |
| `NONE` | No proxy |
<CodeGroup>
@ -326,7 +332,7 @@ curl -X POST "https://api.skyvern.com/v1/run/tasks" \
```
</CodeGroup>
**Granular targeting (US states/cities):**
**Granular targeting (state/city level):**
<CodeGroup>
```python Python
@ -755,6 +761,45 @@ curl -X POST "https://api.skyvern.com/v1/run/tasks" \
---
## `run_with`
Choose whether the task runs with the AI agent or generated code.
| Value | Description |
|-------|-------------|
| `agent` | Run with the AI agent (default). The agent analyzes screenshots and decides actions in real time. |
| `code` | Run with generated code. Faster and more deterministic, but requires a previously published workflow. |
<CodeGroup>
```python Python
result = await client.run_task(
prompt="Fill out the contact form",
run_with="agent"
)
```
```typescript TypeScript
const result = await client.runTask({
body: {
prompt: "Fill out the contact form",
run_with: "agent",
},
});
```
```bash cURL
curl -X POST "https://api.skyvern.com/v1/run/tasks" \
-H "x-api-key: $SKYVERN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Fill out the contact form",
"run_with": "agent"
}'
```
</CodeGroup>
---
## `model`
Optional model configuration for the task.