docs(ai-agents): Add AI connector tutorials and Agent engine positioning (#70461)

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Alexandre Girard <alexandre@airbyte.io>

docusaurus/docusaurus.config.ts

@@ -181,7 +181,6 @@ const config: Config = {
         remarkPlugins: [
           plugins.docsHeaderDecoration,
           plugins.enterpriseDocsHeaderInformation,
-          plugins.productInformation,
           plugins.docMetaTags,
           plugins.addButtonToTitle,
           [plugins.npm2yarn, { sync: true }],
@@ -396,7 +395,7 @@ const config: Config = {
           position: "left",
           docsPluginId: "platform",
           sidebarId: "platform",
-          label: "Platform",
+          label: "Data replication",
         },
         {
           type: "docSidebar",

docusaurus/sidebar-developers.js

@@ -26,6 +26,18 @@ module.exports = {
           label: 'Java SDK',
           href: 'https://github.com/airbytehq/airbyte-api-java-sdk',
         },
+        {
+          type: 'category',
+          label: 'MCP Servers',
+          link: {
+            type: "doc",
+            id: 'mcp-servers/readme',
+          },
+          items: [
+            'mcp-servers/pyairbyte-mcp',
+            // 'mcp-servers/connector-builder-mcp',
+          ],
+        },
       ],
     },
   ],

docusaurus/sidebar-platform.js

@@ -241,7 +241,7 @@ module.exports = {
     {
       type: "category",
       collapsible: false,
-      label: "Airbyte Platform",
+      label: "Data replication platform",
       link: {
         type: "doc",
         id: "readme",

docusaurus/src/css/custom.css

@@ -27,8 +27,7 @@
   --color-active-nav-item-text: var(--ifm-color-primary-darker);
   --ifm-table-background: transparent;
   --ifm-table-stripe-background: transparent;
-  --ifm-table-head-background: var(--ifm-color-primary);
-  --ifm-table-head-color: var(--color-white);
+  --ifm-table-head-background: var(--color-blue-30);
   --ifm-table-border-color: var(--ifm-color-primary-lightest);
   --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.2);
   
@@ -327,27 +326,10 @@ The variables for them have been added to :root at the top of this file */
 
 table {
   border-spacing: 0;
-  border-collapse: separate;
+  border-collapse: collapse;
   overflow-x: auto;
 }
 
-/* Add these new styles */
-table th:first-child {
-  border-top-left-radius: 10px;
-}
-
-table th:last-child {
-  border-top-right-radius: 10px;
-}
-
-table tr:last-child td:first-child {
-  border-bottom-left-radius: 10px;
-}
-
-table tr:last-child td:last-child {
-  border-bottom-right-radius: 10px;
-}
-
 table th code {
   color: var(--ifm-color-content);
 }
@@ -360,6 +342,10 @@ table td code {
   border-radius: 4px;
 }
 
+table th, table td {
+  vertical-align: top;
+}
+
 table tr:hover {
   background-color: var(--color-grey-40);
   transition: background-color 0.2s ease;

docusaurus/src/pages/index.js

@@ -85,15 +85,15 @@ export default function Home() {
 
   const navLinks = [
     {
-      title: 'Platform',
+      title: 'Data replication platform',
       link: '/platform/',
-      description: 'Deploy Airbyte locally, to cloud providers, or use Airbyte Cloud. Create connections, build custom connectors, and start syncing data in minutes.',
+      description: 'Use Airbyte\'s data replication platform to create connections, build custom connectors, and start syncing data in minutes.',
       icon: PlatformIcon,
     },
     {
       title: 'Connectors',
       link: '/integrations/',
-      description: 'Browse Airbyte\'s catalog of over 600 sources and destinations, and learn to set them up in Airbyte.',
+      description: 'Browse Airbyte\'s catalog of over 600 sources and destinations, and learn to set them up in Airbyte\'s data replication platform.',
       icon: ConnectorsIcon,
     },
     {
@@ -103,9 +103,9 @@ export default function Home() {
       icon: ReleaseNotesIcon,
     },
     {
-      title: 'AI agents',
+      title: 'Agent engine',
       link: '/ai-agents/',
-      description: 'Explore AI Agent tools and capabilities for building intelligent data pipelines.',
+      description: 'Use Airbyte\'s Agent engine to build intelligent data pipelines, explore your data, and work with it with help from AI.',
       icon: AIAgentsIcon,
     },
     {
@@ -134,11 +134,10 @@ export default function Home() {
           <div className={styles.heroContainer}>
             <div className={styles.heroLeft}>
               <p className={styles.heroDescription}>
-                Airbyte is an open source data integration and activation platform. 
-                It helps you consolidate data from hundreds of sources into your data 
-                warehouses, data lakes, and databases. Then, it helps you move data 
-                from those locations into the operational tools where work happens, 
-                like CRMs, marketing platforms, and support systems.
+                Airbyte is an open source data integration, activation, and agentic data platform.
+                Use our data replication platform to consolidate data from hundreds of sources into your data warehouses, data lakes, and databases. 
+                Then, move data into the operational tools where work happens, like CRMs, marketing platforms, and support systems. 
+                Or, use our Agent engine to ask questions, explore, and update your data with AI agents.
               </p>
             </div>
             <div className={styles.heroRight}>

docusaurus/static/_taxonomy_of_data_movement.md

@@ -0,0 +1,67 @@
+People think about different types of data movement with a lot of nuance. At a high level, Airbyte thinks about them like the table below. Airbyte's data replication platform targets the first row in the table. Airbyte's agentic data platform targets the second row.
+
+While the agentic data platform exists to support AI use cases, it's incorrect to say data replication doesn't support AI. For example, data replication is a core ingredient in Retrieval-Augmented Generation (RAG). Think about your approach to data movement in terms of getting your data into the right shape at the right time. Don't think about the choice as binary. It's safe to assume AI is a stakeholder of some kind in virtually every data movement operation.
+
+<table>
+  <tr>
+    <th></th>
+    <th>In</th>
+    <th>Out (data activation)</th>
+  </tr>
+  <tr>
+    <th>Data replication</th>
+    <td>
+      <strong>ELT/ETL</strong><br /><br />
+      For when:
+      <ul>
+        <li>You need all the data</li>
+        <li>You need to join across datasets</li>
+        <li>You need more pipeline steps that are slow</li>
+      </ul>
+      Requires:
+      <ul>
+        <li>Storage</li>
+      </ul>
+    </td>
+    <td>
+      <strong>Reverse ETL</strong><br /><br />
+      For when:
+      <ul>
+        <li>You have a lot of data to update</li>
+        <li>You want to update content, not trigger side effects</li>
+      </ul>
+      Requires:
+      <ul>
+        <li>Good vendor APIs</li>
+      </ul>
+    </td>
+  </tr>
+  <tr>
+    <th>Operations</th>
+    <td>
+      <strong>Get</strong><br /><br />
+      For when:
+      <ul>
+        <li>You don't need all the data</li>
+        <li>You don't want storage</li>
+        <li>Freshness (latency) matters</li>
+      </ul>
+      Requires:
+      <ul>
+        <li>Good vendor APIs</li>
+      </ul>
+    </td>
+    <td>
+      <strong>Write</strong><br /><br />
+      For when:
+      <ul>
+        <li>You're updating a small amount of data</li>
+        <li>You want to trigger side effects, like sending an email or closing a ticket</li>
+      </ul>
+      Requires:
+      <ul>
+        <li>Good vendor APIs</li>
+      </ul>
+    </td>
+  </tr>
+</table>