Skip to content

Commit e94e514

Browse files
waleedlatif1waleedlatif1
authored
feat(flint): add Flint integration with agent task tools, block, and docs (#5641)
* feat(flint): add Flint integration with agent task tools, block, and docs * fix(flint): forward explicit publish=false, guard missing taskId, align default params branch with tool fallback * docs(flint): add manual intro section to integration docs page * fix(flint): fail get_task on OK responses without a task ID * fix(flint): drop json-object generation type so the wand emits the pages array
1 parent 04535ee commit e94e514

16 files changed

Lines changed: 902 additions & 1 deletion

File tree

‎apps/docs/components/icons.tsx‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6845,6 +6845,22 @@ export function JiraServiceManagementIcon(props: SVGProps<SVGSVGElement>) {
68456845
)
68466846
}
68476847

6848+
export function FlintIcon(props: SVGProps<SVGSVGElement>) {
6849+
return (
6850+
<svg {...props} viewBox='374 415 519 617' fill='none' xmlns='http://www.w3.org/2000/svg'>
6851+
<path d='M374 1004.46L679.798 1031.21V833.875L374 847.451V1004.46Z' fill='currentColor' />
6852+
<path
6853+
d='M374 567.086V676.084L803.573 606.042V764.423L892.518 750.061V415L374 567.086Z'
6854+
fill='currentColor'
6855+
/>
6856+
<path
6857+
d='M374 831.711L695.54 817.349V894.67L787.634 891.719V624.536L374 692.217V831.711Z'
6858+
fill='currentColor'
6859+
/>
6860+
</svg>
6861+
)
6862+
}
6863+
68486864
export function FirefliesIcon(props: SVGProps<SVGSVGElement>) {
68496865
const id = useId()
68506866
const g1 = `fireflies_g1_${id}`

‎apps/docs/components/ui/icon-mapping.ts‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,7 @@ import {
7373
FindymailIcon,
7474
FirecrawlIcon,
7575
FirefliesIcon,
76+
FlintIcon,
7677
GammaIcon,
7778
GithubIcon,
7879
GitLabIcon,
@@ -317,6 +318,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
317318
firecrawl: FirecrawlIcon,
318319
fireflies: FirefliesIcon,
319320
fireflies_v2: FirefliesIcon,
321+
flint: FlintIcon,
320322
gamma: GammaIcon,
321323
github: GithubIcon,
322324
github_v2: GithubIcon,

‎apps/docs/content/docs/en/integrations/flint.mdx‎

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
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+
{/* MANUAL-CONTENT-START:intro */}
14+
[Flint](https://www.flint.com/) is an AI website platform where background agents build and update your site for you. Through the Agent Tasks API, you can programmatically kick off site changes from a natural-language prompt, generate batches of pages from a template, and monitor each task until it completes.
15+
16+
**Why Flint?**
17+
- **Agent-Driven Site Changes:** Describe the change in plain language — "Add a new About page with a team section" — and a background agent makes it happen.
18+
- **Programmatic Page Generation:** Generate up to 10 pages per task from an existing template page, each with its own slug and content context — ideal for case studies, location pages, and programmatic SEO.
19+
- **Controlled Publishing:** Every task can either publish automatically on completion or leave changes unpublished for review.
20+
- **Full Task Visibility:** Poll any task for its status and get back the created, modified, and deleted pages with preview, edit, and published URLs.
21+
22+
**Using Flint in Sim**
23+
24+
Sim's Flint integration connects your workflows directly to the Flint Agent Tasks API using an API key from your Flint team settings. Three operations cover the full task lifecycle: Create Task starts a prompt-driven site change, Generate Pages fans a template out into a batch of new pages, and Get Task reports status and results.
25+
26+
**Key benefits of using Flint in Sim:**
27+
- **Content pipelines:** Read rows from a table or spreadsheet and generate a landing page per row from a Flint template.
28+
- **Event-driven site updates:** Trigger site changes from Slack requests, closed-won deals, or new GitHub releases.
29+
- **Safe review workflows:** Leave publishing off, collect preview URLs from Get Task, and publish only after approval.
30+
- **Reliable monitoring:** Poll task status on a schedule, write published URLs back to your data, and alert on failed tasks with their error messages.
31+
32+
Whether you're scaling programmatic SEO, keeping marketing pages in sync with your business systems, or automating site maintenance, Flint in Sim turns your website into something your workflows can edit. Configure your API key, pick an operation, and let the agent do the work.
33+
{/* MANUAL-CONTENT-END */}
34+
35+
36+
## Usage Instructions
37+
38+
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.
39+
40+
41+
42+
## Actions
43+
44+
### `flint_create_task`
45+
46+
Start a background Flint agent task that modifies a site from a natural-language prompt.
47+
48+
#### Input
49+
50+
| Parameter | Type | Required | Description |
51+
| --------- | ---- | -------- | ----------- |
52+
| `siteId` | string | Yes | ID of the Flint site the agent should modify |
53+
| `prompt` | string | Yes | Natural-language instructions for the agent \(e.g., "Add a new About page with a team section"\) |
54+
| `callbackUrl` | string | No | HTTPS webhook URL that Flint will POST to when the task completes or fails |
55+
| `publish` | boolean | No | Whether to automatically publish the changes when the task completes |
56+
57+
#### Output
58+
59+
| Parameter | Type | Description |
60+
| --------- | ---- | ----------- |
61+
| `taskId` | string | Identifier of the created background task |
62+
| `status` | string | Initial task status \(running\) |
63+
| `createdAt` | string | ISO 8601 timestamp when the task was created |
64+
65+
### `flint_generate_pages`
66+
67+
Start a background Flint agent task that generates up to 10 pages from a template page.
68+
69+
#### Input
70+
71+
| Parameter | Type | Required | Description |
72+
| --------- | ---- | -------- | ----------- |
73+
| `siteId` | string | Yes | ID of the Flint site the agent should modify |
74+
| `templatePageSlug` | string | Yes | Slug of the existing template page to generate from \(e.g., /case-studies/template\) |
75+
| `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\). |
76+
| `callbackUrl` | string | No | HTTPS webhook URL that Flint will POST to when the task completes or fails |
77+
| `publish` | boolean | No | Whether to automatically publish the generated pages when the task completes |
78+
79+
#### Output
80+
81+
| Parameter | Type | Description |
82+
| --------- | ---- | ----------- |
83+
| `taskId` | string | Identifier of the created background task |
84+
| `status` | string | Initial task status \(running\) |
85+
| `createdAt` | string | ISO 8601 timestamp when the task was created |
86+
87+
### `flint_get_task`
88+
89+
Get the status and results of a background Flint agent task.
90+
91+
#### Input
92+
93+
| Parameter | Type | Required | Description |
94+
| --------- | ---- | -------- | ----------- |
95+
| `taskId` | string | Yes | Identifier of the task returned when it was created \(e.g., bg-...\) |
96+
97+
#### Output
98+
99+
| Parameter | Type | Description |
100+
| --------- | ---- | ----------- |
101+
| `taskId` | string | Identifier of the task |
102+
| `status` | string | Task status: running, completed, or failed |
103+
| `pagesCreated` | array | Pages created by the task \(populated when completed\) |
104+
| `pagesModified` | array | Pages modified by the task \(populated when completed\) |
105+
| `pagesDeleted` | array | Pages deleted by the task \(populated when completed\) |
106+
| `errorMessage` | string | Error message when the task failed |
107+
108+

‎apps/docs/content/docs/en/integrations/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,7 @@
7171
"findymail",
7272
"firecrawl",
7373
"fireflies",
74+
"flint",
7475
"gamma",
7576
"github",
7677
"gitlab",

0 commit comments

Comments
 (0)