airbytehq · ian-at-airbyte · Dec 13, 2025 · Dec 13, 2025 · Dec 13, 2025 · Dec 13, 2025
diff --git a/.markdownlintignore b/.markdownlintignore
@@ -0,0 +1,3 @@
+# Ignore auto-generated connector documentation files synced from airbyte-agent-connectors repo
+# These files are generated and have formatting that doesn't conform to markdownlint rules
+docs/ai-agents/connectors/**
diff --git a/docs/ai-agents/README.md b/docs/ai-agents/README.md
@@ -1,6 +1,16 @@
-import Taxonomy from "@site/static/_taxonomy_of_data_movement.md";
+---
+sidebar_position: 1
+---
 
-# Agent engine
+# AI agents
+
+Airbyte provides a set of tools to help you automate, understand, move, and work with your data in coordination with AI agents. Some of these tools are standalone open source solutions, and others are paid solutions built on top of Airbyte Cloud.
+
+- **Agent connectors**: Use Airbyte's AI-optimized, type-safe connectors to power your own AI agents, or use them with Airbyte's Connector MCP server. [View the GitHub repo](https://github.com/airbytehq/airbyte-agent-connectors) or [try the tutorial](quickstarts). You can set up your own agent and explore your data in 15 minutes or less.
+
+- **Airbyte Embedded**: Add hundreds of integrations into your product instantly. Your end-users can authenticate into their data sources and begin syncing data to your product. You no longer need to spend engineering cycles on data movement. Focus on what makes your product great, rather than maintaining data integrations.
+
+<!-- import Taxonomy from "@site/static/_taxonomy_of_data_movement.md";
 
 Airbyte's Agent engine is a set of tools to help you automate, understand, move, and work with your data in coordination with AI agents. Some of these tools are standalone open source solutions, and others are pay solutions built on top of Airbyte Cloud.
 
@@ -39,7 +49,7 @@ The Agent engine is an ideal solution when you:
 - Are working with a small amount of data
 - Need to trigger side effects, like sending an email or closing a ticket
 
-The agenda data platform _isn't_ ideal when you:
+The agentic data platform _isn't_ ideal when you:
 
 - Need all your data in one place
 - Need to join across datasets
@@ -60,7 +70,7 @@ If agentic data isn't what you're looking for and you need complex data aggregat
 
 Airbyte Embedded creates isolated workspaces for each of your customers, allowing them to configure their own data sources while keeping their data separate and secure. The Embedded Widget provides a pre-built UI component that handles the entire user onboarding flow from authentication to source configuration.
 
-Once Airbyte enables your organizaton on Airbyte Embedded, you can begin onboarding customers via the Embedded Widget. You can download the Embedded demo app [from GitHub](https://github.com/airbytehq/embedded-demoapp).
+Once Airbyte enables your organization on Airbyte Embedded, you can begin onboarding customers via the Embedded Widget. You can download the Embedded demo app [from GitHub](https://github.com/airbytehq/embedded-demoapp).
 
 ## Agent connectors
 
@@ -69,3 +79,4 @@ Airbyte's agent connectors are Python packages that equip AI agents to call thir
 ## Connector MCP
 
 Use [agent connectors](connectors) to interact with your data using natural language.
+ -->
diff --git a/docs/ai-agents/connectors/asana/CHANGELOG.md b/docs/ai-agents/connectors/asana/CHANGELOG.md
@@ -0,0 +1,146 @@
+# Changelog
+
+## [0.19.10] - 2025-12-13
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 1ab72bd8
+- SDK version: 0.1.0
+
+## [0.19.9] - 2025-12-12
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 4d366cb5
+- SDK version: 0.1.0
+
+## [0.19.8] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: dc79dc8b
+- SDK version: 0.1.0
+
+## [0.19.7] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 9f7f8a98
+- SDK version: 0.1.0
+
+## [0.19.6] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 8c06aa10
+- SDK version: 0.1.0
+
+## [0.19.5] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 11427ac3
+- SDK version: 0.1.0
+
+## [0.19.4] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: bdd5df6d
+- SDK version: 0.1.0
+
+## [0.19.3] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2497f71
+- SDK version: 0.1.0
+
+## [0.19.2] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 7d738be5
+- SDK version: 0.1.0
+
+## [0.19.1] - 2025-12-10
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 76636830
+- SDK version: 0.1.0
+
+## [0.19.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2ad5029
+- SDK version: 0.1.0
+
+## [0.18.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 139b0b0d
+- SDK version: 0.1.0
+
+## [0.17.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: e96bed3d
+- SDK version: 0.1.0
+
+## [0.16.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: ed697b90
+- SDK version: 0.1.0
+
+## [0.15.0] - 2025-12-05
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 20618410
+- SDK version: 0.1.0
+
+## [0.14.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4a01e446
+- SDK version: 0.1.0
+
+## [0.13.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 5ec76dde
+- SDK version: 0.1.0
+
+## [0.12.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: df32a458
+- SDK version: 0.1.0
+
+## [0.11.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a506b369
+- SDK version: 0.1.0
+
+## [0.10.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 92a39ab5
+- SDK version: 0.1.0
+
+## [0.9.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 0ce38253
+- SDK version: 0.1.0
+
+## [0.8.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: c8e326d9
+- SDK version: 0.1.0
+
+## [0.7.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: ad0b961b
+- SDK version: 0.1.0
+
+## [0.6.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 7153780a
+- SDK version: 0.1.0
+
+## [0.5.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 01f71cad
+- SDK version: 0.1.0
+
+## [0.4.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4c17f060
+- SDK version: 0.1.0
+
+## [0.3.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 430a4e68
+- SDK version: 0.1.0
+
+## [0.2.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: cd499acd
+- SDK version: 0.1.0
+
+## [0.1.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: b261c3a2
+- SDK version: 0.1.0
diff --git a/docs/ai-agents/connectors/asana/README.md b/docs/ai-agents/connectors/asana/README.md
@@ -0,0 +1,82 @@
+# Airbyte Asana AI Connector
+
+Asana is a work management platform that helps teams organize, track, and manage
+projects and tasks. This connector provides access to tasks, projects, workspaces,
+teams, and users for project tracking, workload analysis, and productivity insights.
+
+
+## Example Questions
+
+- What tasks are assigned to me this week?
+- List all projects in my workspace
+- Summarize my team's workload and task completion rates
+- Show me the tasks for the [ProjectName] project
+- Who are the team members in my [TeamName] team?
+- Find all tasks related to [ClientName] across my workspaces
+- Analyze the most active projects in my workspace last month
+- Compare task completion rates between my different teams
+- Identify overdue tasks across all my projects
+- Show me details of my current workspace and its users
+
+## Unsupported Questions
+
+- Create a new task for [TeamMember]
+- Update the priority of this task
+- Delete the project [ProjectName]
+- Schedule a new team meeting
+- Add a new team member to [Workspace]
+- Move this task to another project
+
+## Installation
+
+```bash
+uv pip install airbyte-ai-asana
+```
+
+## Usage
+
+```python
+from airbyte_ai_asana import AsanaConnector, AsanaAuthConfig
+
+connector = AsanaConnector(
+  auth_config=AsanaAuthConfig(
+    access_token="...",
+    refresh_token="...",
+    client_id="...",
+    client_secret="..."
+  )
+)
+result = connector.tasks.list()
+```
+
+## Documentation
+
+| Entity | Actions |
+|--------|---------|
+| Tasks | [List](./REFERENCE.md#tasks-list), [Get](./REFERENCE.md#tasks-get) |
+| Project Tasks | [List](./REFERENCE.md#project-tasks-list) |
+| Workspace Task Search | [List](./REFERENCE.md#workspace-task-search-list) |
+| Projects | [List](./REFERENCE.md#projects-list), [Get](./REFERENCE.md#projects-get) |
+| Task Projects | [List](./REFERENCE.md#task-projects-list) |
+| Team Projects | [List](./REFERENCE.md#team-projects-list) |
+| Workspace Projects | [List](./REFERENCE.md#workspace-projects-list) |
+| Workspaces | [List](./REFERENCE.md#workspaces-list), [Get](./REFERENCE.md#workspaces-get) |
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get) |
+| Workspace Users | [List](./REFERENCE.md#workspace-users-list) |
+| Team Users | [List](./REFERENCE.md#team-users-list) |
+| Teams | [Get](./REFERENCE.md#teams-get) |
+| Workspace Teams | [List](./REFERENCE.md#workspace-teams-list) |
+| User Teams | [List](./REFERENCE.md#user-teams-list) |
+
+
+For detailed documentation on available actions and parameters, see [REFERENCE.md](./REFERENCE.md).
+
+For the service's official API docs, see [Asana API Reference](https://developers.asana.com/reference/rest-api-reference).
+
+## Version Information
+
+**Package Version:** 0.19.10
+
+**Connector Version:** 0.1.1
+
+**Generated with connector-sdk:** 1ab72bd8e7249872a4cf66327dd1a0bf68905acb