Connectors
Connectors let TF Design read from external SaaS data sources. When the agent generates an artifact that requires live data, it can query connected services — Notion, databases, CRMs, and more — to populate the output with real, up-to-date information.
Composio Integration
TF Design uses Composio as its connector platform. Composio provides a catalog of pre-built integrations with authentication handling, normalised APIs, and safety classification.
Connector Categories
| Category | Examples |
|---|---|
| Developer | GitHub, GitLab, Linear, Sentry, Vercel |
| Productivity | Notion, Google Docs, Slack, Trello, Asana |
| Storage | Google Drive, Dropbox, AWS S3 |
Configuration
- Open Settings (gear icon).
- Navigate to Connectors.
- Browse the connector catalog.
- Authenticate with the desired service — credentials are stored in the Composio credential store.
- The connector becomes available to the agent.
Tool Safety Classification
Each connector tool is automatically classified by safety level:
| Safety Level | Description | Default Approval Policy |
|---|---|---|
| Read | Fetches data without side effects | Auto-approved |
| Write | Creates or modifies data | Requires confirmation |
| Destructive | Deletes or irreversibly changes data | Disabled by default |
Approval Policies
| Policy | Behaviour |
|---|---|
| Auto | The agent can call the tool without asking |
| Confirm | The agent asks for approval before calling |
| Disabled | The tool is blocked entirely |
You can override the default policy for any connector tool in Settings.
How Connectors Work with the Agent
- The agent reads the brief and identifies data requirements.
- It checks available connectors and their safety policies.
- For read tools — the agent calls them automatically.
- For write tools — the agent asks for confirmation.
- For destructive tools — blocked unless explicitly enabled.
- Data is fetched and used to populate the artifact.
The classifyConnectorToolSafety function inspects each tool's signature and parameters to determine its safety level automatically.
Using Connectors with Live Artifacts
Connectors are the data backbone for Live Artifacts. When a live artifact is refreshed, the agent re-fetches data from all connected sources and re-renders the output.
Example workflow:
- Connect a Notion workspace (Productivity category).
- Ask the agent: "Create a dashboard showing all tasks from our Notion project board."
- The agent queries the Notion connector, reads the task data, and generates a dashboard.
- The artifact is registered as a live artifact with the Notion connector as its data source.
- On refresh, the agent re-fetches tasks and updates the dashboard.