|
| 1 | +--- |
| 2 | +title: Flint |
| 3 | +description: Run background agent tasks on your Flint sites |
| 4 | +--- |
| 5 | + |
| 6 | +import { BlockInfoCard } from "@/components/ui/block-info-card" |
| 7 | + |
| 8 | +<BlockInfoCard |
| 9 | + type="flint" |
| 10 | + color="#F6F54F" |
| 11 | +/> |
| 12 | + |
| 13 | +## Usage Instructions |
| 14 | + |
| 15 | +Create background agent tasks that modify your Flint sites from natural-language prompts, generate batches of pages from a template, and check task status and results. |
| 16 | + |
| 17 | + |
| 18 | + |
| 19 | +## Actions |
| 20 | + |
| 21 | +### `flint_create_task` |
| 22 | + |
| 23 | +Start a background Flint agent task that modifies a site from a natural-language prompt. |
| 24 | + |
| 25 | +#### Input |
| 26 | + |
| 27 | +| Parameter | Type | Required | Description | |
| 28 | +| --------- | ---- | -------- | ----------- | |
| 29 | +| `siteId` | string | Yes | ID of the Flint site the agent should modify | |
| 30 | +| `prompt` | string | Yes | Natural-language instructions for the agent \(e.g., "Add a new About page with a team section"\) | |
| 31 | +| `callbackUrl` | string | No | HTTPS webhook URL that Flint will POST to when the task completes or fails | |
| 32 | +| `publish` | boolean | No | Whether to automatically publish the changes when the task completes | |
| 33 | + |
| 34 | +#### Output |
| 35 | + |
| 36 | +| Parameter | Type | Description | |
| 37 | +| --------- | ---- | ----------- | |
| 38 | +| `taskId` | string | Identifier of the created background task | |
| 39 | +| `status` | string | Initial task status \(running\) | |
| 40 | +| `createdAt` | string | ISO 8601 timestamp when the task was created | |
| 41 | + |
| 42 | +### `flint_generate_pages` |
| 43 | + |
| 44 | +Start a background Flint agent task that generates up to 10 pages from a template page. |
| 45 | + |
| 46 | +#### Input |
| 47 | + |
| 48 | +| Parameter | Type | Required | Description | |
| 49 | +| --------- | ---- | -------- | ----------- | |
| 50 | +| `siteId` | string | Yes | ID of the Flint site the agent should modify | |
| 51 | +| `templatePageSlug` | string | Yes | Slug of the existing template page to generate from \(e.g., /case-studies/template\) | |
| 52 | +| `items` | json | Yes | JSON array of 1-10 pages to generate. Each item requires targetPageSlug \(slug for the new page\) and context \(content details the agent should use\). | |
| 53 | +| `callbackUrl` | string | No | HTTPS webhook URL that Flint will POST to when the task completes or fails | |
| 54 | +| `publish` | boolean | No | Whether to automatically publish the generated pages when the task completes | |
| 55 | + |
| 56 | +#### Output |
| 57 | + |
| 58 | +| Parameter | Type | Description | |
| 59 | +| --------- | ---- | ----------- | |
| 60 | +| `taskId` | string | Identifier of the created background task | |
| 61 | +| `status` | string | Initial task status \(running\) | |
| 62 | +| `createdAt` | string | ISO 8601 timestamp when the task was created | |
| 63 | + |
| 64 | +### `flint_get_task` |
| 65 | + |
| 66 | +Get the status and results of a background Flint agent task. |
| 67 | + |
| 68 | +#### Input |
| 69 | + |
| 70 | +| Parameter | Type | Required | Description | |
| 71 | +| --------- | ---- | -------- | ----------- | |
| 72 | +| `taskId` | string | Yes | Identifier of the task returned when it was created \(e.g., bg-...\) | |
| 73 | + |
| 74 | +#### Output |
| 75 | + |
| 76 | +| Parameter | Type | Description | |
| 77 | +| --------- | ---- | ----------- | |
| 78 | +| `taskId` | string | Identifier of the task | |
| 79 | +| `status` | string | Task status: running, completed, or failed | |
| 80 | +| `pagesCreated` | array | Pages created by the task \(populated when completed\) | |
| 81 | +| `pagesModified` | array | Pages modified by the task \(populated when completed\) | |
| 82 | +| `pagesDeleted` | array | Pages deleted by the task \(populated when completed\) | |
| 83 | +| `errorMessage` | string | Error message when the task failed | |
| 84 | + |
| 85 | + |
0 commit comments