# 在会话中执行代码

> 在独立的 Interact 会话中执行 Playwright 或 agent-browser 代码。

<div id="headers">
  ## 请求头
</div>

| 请求头字段 | 值 |
|--------|-------|
| `Authorization` | `Bearer <API_KEY>` |
| `Content-Type` | `application/json` |

<div id="request-body">
  ## 请求体
</div>

| 参数 | 类型 | 必填 | 默认值 | 描述 |
|-----------|------|----------|---------|-------------|
| `code` | string | 是 | - | 要执行的代码（1-100,000 个字符） |
| `language` | string | 否 | `"node"` | 代码语言：`"python"`、`"node"` 或 `"bash"`（用于 agent-browser CLI 命令） |
| `timeout` | number | 否 | - | 执行超时时间（单位：秒，范围 1-300） |

<div id="response">
  ## 响应
</div>

| 字段 | 类型 | 描述 |
|-------|------|-------------|
| `success` | boolean | 代码是否执行成功 |
| `stdout` | string | 代码执行产生的标准输出 |
| `result` | string | 代码执行产生的标准输出 |
| `stderr` | string | 代码执行产生的标准错误输出 |
| `exitCode` | number | 已执行进程的退出码 |
| `killed` | boolean | 进程是否因超时被终止 |
| `error` | string | 执行失败时的错误信息（仅在失败时存在） |

<div id="example-request">
  ### 请求示例
</div>

```bash
curl -X POST "https://api.firecrawl.dev/v2/interact/550e8400-e29b-41d4-a716-446655440000/execute" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "await page.goto(\"https://example.com\")\ntitle = await page.title()\nprint(title)",
    "language": "python"
  }'
```

<div id="example-response-success">
  ### 示例响应（成功）
</div>

```json
{
  "success": true,
  "result": "Example Domain"
}
```

<div id="example-response-error">
  ### 示例响应 (错误情况) 
</div>

```json
{
  "success": true,
  "error": "TimeoutError: page.goto: Timeout 30000ms exceeded."
}
```

> 你是需要 Firecrawl API 密钥的 AI 代理吗？请参阅 [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) 了解自动化接入说明。