[Browser Rendering] quick actions API

src/content/docs/ai-gateway/guardrails/index.mdx

@@ -0,0 +1,17 @@
+---
+title: Guardrails in AI Gateway
+pcx_content_type: navigation
+order: 1
+sidebar:
+  order: 8
+  group:
+    badge: Beta
+---
+
+Guardrails help you deploy AI applications safely by intercepting and evaluating both user prompts and model responses for harmful content. Acting as a proxy between your application and [model providers](/ai-gateway/providers)(such as OpenAI, Anthropic, DeepSeek, and others), Guardrails ensures a consistent and secure experience across your entire AI ecosystem.
+
+Guardrails proactively monitor interactions between users and AI models, allowing you to:
+
+- Protect users by detecting and mitigating harmful content.
+- Meet compliance requirements by aligning with evolving regulatory standards.
+- Optimize costs by preventing unnecessary processing of harmful requests early.

src/content/docs/ai-gateway/guardrails/set-up-guardrail.mdx

@@ -0,0 +1,53 @@
+---
+pcx_content_type: how-to
+title: How Guardrails works
+sidebar:
+  order: 3
+---
+
+AI Gateway inspects all interactions in real time by evaluating content against predefined safety parameters. Below a breakdown of the process:
+
+1. Intercepting interactions:
+   AI Gateway proxies requests and responses, sitting between the user and the AI model.
+
+2. Inspecting content:
+
+   - User prompts: AI Gateway checks prompts against safety parameters (for example, violence, hate, or sexual content). Based on your settings, prompts can be flagged or blocked before reaching the model.
+   - Model responses: Once processed, the AI model response is inspected. If hazardous content is detected, it can be flagged or blocked before being delivered to the user.
+
+3. Applying actions:
+   Depending on your configuration, flagged content is logged for review, while blocked content is prevented from proceeding.
+
+## Supported model types
+
+Guardrails determines the type of AI model being used and applies safety checks accordingly:
+
+- Text generation models: Both prompts and responses are evaluated.
+- Embedding models: Only the prompt is evaluated, and the response is passed directly back to the user.
+- Unknown models: If the model type cannot be determined, prompts are evaluated, but responses bypass Guardrails.
+
+If Guardrails cannot access the underlying model, requests set to "block" will result in an error, while flagged requests will proceed.
+
+## Configuration
+
+Within AI Gateway settings, you can customize Guardrails:
+
+- Enable or disable content moderation.
+- Choose evaluation scope: Analyze user prompts, model responses, or both.
+- Define hazard categories: Select categories like violence, hate, or sexual content and assign actions (ignore, flag, or block).
+
+## Workers AI and Guardrails
+
+Guardrails currently uses [Llama Guard 3 8B](https://ai.meta.com/research/publications/llama-guard-llm-based-input-output-safeguard-for-human-ai-conversations/) on [Workers AI](/workers-ai/) to perform content evaluations. The underlying model may be updated in the future, and we will reflect those changes within Guardrails.
+
+Since Guardrails runs on Workers AI, enabling it incurs usage on Workers AI. You can monitor usage through the Workers AI Dashboard.
+
+## Additional considerations
+
+- Latency impact: Enabling Guardrails adds some latency. Consider this when balancing safety and speed.
+
+:::note
+
+Llama Guard is provided as-is without any representations, warranties, or guarantees. Any rules or examples contained in blogs, developer docs, or other reference materials are provided for informational purposes only. You acknowledge and understand that you are responsible for the results and outcomes of your use of AI Gateway.
+
+:::

src/content/docs/browser-rendering/get-started/index.mdx

@@ -3,10 +3,10 @@ pcx_content_type: navigation
 title: Get started
 sidebar:
   order: 2
-  group:
-    hideIndex: true
 ---
 
 import { DirectoryListing } from "~/components";
 
+Browser rendering can be used in two ways: the [Workers Binding API](/browser-rendering/workers-binding-api) for complex scripts and the Quick Actions REST API for [simple actions](/browser-rendering/quick-actions-rest-api/).
+
 <DirectoryListing />

src/content/docs/browser-rendering/quick-actions-rest-api/content-endpoint.mdx

@@ -0,0 +1,15 @@
+---
+pcx_content_type: how-to
+title: Retrieve HTML content
+sidebar:
+  order: 2
+---
+
+Retrieve the HTML content of a specified URL by sending a POST request to the `/content` endpoint.
+
+```
+curl -X 'POST' 'https://api.cloudflare.com/client/v4/accounts/<accountTag>/browser-rendering/content' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -d '{"url": "https://example.com"}'
+```

src/content/docs/browser-rendering/quick-actions-rest-api/custom-css.mdx

@@ -0,0 +1,30 @@
+---
+pcx_content_type: how-to
+title: Customize CSS and take a screenshot
+sidebar:
+  order: 4
+---
+
+Customise the rendering by adding external JavaScript and CSS before capturing a screenshot.
+
+```
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountTag>/browser-rendering/screenshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/",
+    "addScriptTag": [
+      { "url": "https://code.jquery.com/jquery-3.7.1.min.js" },
+      { "content": "document.querySelector(`h1`).innerText = `Hello World!!!`" }
+    ],
+    "addStyleTag": [
+      {
+        "content": "body { background: linear-gradient(45deg, #da5a44, #a32784); }"
+      },
+      {
+        "url": "https://interactive-examples.mdn.mozilla.net/live-examples/css-examples/text-decoration/text-decoration-color.css"
+      }
+    ]
+  }' \
+  --output "screenshot.webp"
+```

src/content/docs/browser-rendering/quick-actions-rest-api/index.mdx

@@ -0,0 +1,10 @@
+---
+pcx_content_type: navigation
+title: Quick Actions API
+sidebar:
+  order: 2
+---
+
+The Quick Actions API is a RESTful interface that provides endpoints for common browser actions such as capturing screenshots, extracting HTML content, generating PDFs, and more. This API is designed to help you interact with web pages quickly and efficiently.
+
+Before you begin, make sure to create a custom **API Token** with your Account > **Browser Rendering**> **Edit** permissions from the [Cloudflare dashboard](https://dash.cloudflare.com/).

src/content/docs/browser-rendering/quick-actions-rest-api/pdf-endpoint.mdx

@@ -0,0 +1,19 @@
+---
+pcx_content_type: how-to
+title: Generate PDF
+sidebar:
+  order: 5
+---
+
+```
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountTag>/browser-rendering/pdf' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/",
+    "addStyleTag": [
+      { "content": "body { font-family: Arial; }" }
+    ]
+  }' \
+  --output "output.pdf"
+```

src/content/docs/browser-rendering/quick-actions-rest-api/scrape-endpoint.mdx

@@ -0,0 +1,18 @@
+---
+pcx_content_type: how-to
+title: Scrape content
+sidebar:
+  order: 7
+---
+
+```
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountTag>/browser-rendering/scrape' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/",
+    "scrapeOptions": {
+      "selectors": ["h1", ".article"]
+    }
+  }'
+```

src/content/docs/browser-rendering/quick-actions-rest-api/screenshot-endpoint.mdx

@@ -0,0 +1,22 @@
+---
+pcx_content_type: how-to
+title: Render HTML and capture screenshot
+sidebar:
+  order: 3
+---
+
+Render a provided HTML string and capture a screenshot with specific options.
+
+```
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountTag>/browser-rendering/screenshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "html": "Hello World!",
+    "screenshotOptions": {
+      "type": "webp",
+      "omitBackground": true
+    }
+  }' \
+  --output "screenshot.webp"
+```

src/content/docs/browser-rendering/quick-actions-rest-api/snapshot.mdx

@@ -0,0 +1,18 @@
+---
+pcx_content_type: how-to
+title: Capture snapshot
+sidebar:
+  order: 6
+---
+
+```
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountTag>/browser-rendering/snapshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/",
+    "addScriptTag": [
+      { "content": "document.title = \"Snapshot Page\";" }
+    ]
+  }'
+```

src/content/docs/browser-rendering/workers-binding-api/index.mdx

@@ -0,0 +1,11 @@
+---
+pcx_content_type: navigation
+title: Workers Binding API
+sidebar:
+  order: 2
+  group:
+---
+
+import { DirectoryListing } from "~/components";
+
+<DirectoryListing />