Add Falcon AI docs

src/lib/navigation.ts

@@ -136,6 +136,21 @@ export const tabNavigation: NavTab[] = [
           },
         ]
       },
+      {
+        group: 'Falcon AI',
+        icon: 'rocket',
+        items: [
+          { title: 'Overview', href: '/docs/falcon-ai' },
+          {
+            title: 'Features',
+            items: [
+              { title: 'Using Falcon AI', href: '/docs/falcon-ai/features/chat' },
+              { title: 'Skill Builder', href: '/docs/falcon-ai/features/skills' },
+              { title: 'MCP Connectors', href: '/docs/falcon-ai/features/mcp-connectors' },
+            ]
+          },
+        ]
+      },
       {
         group: 'Evaluation',
         icon: 'chart',

src/pages/docs/falcon-ai/features/chat.mdx

@@ -0,0 +1,150 @@
+---
+title: "Using Falcon AI"
+description: "Open Falcon AI from any page, ask questions, upload files, and get streaming responses with tool calls and completion cards."
+---
+
+## About
+
+Falcon AI runs as a chat interface inside the Future AGI dashboard. It can be opened as a sidebar from any page or as a full-page view for longer conversations. The sidebar stays open while you navigate between pages, so context is never lost. Conversations save automatically and can be resumed later.
+
+Falcon AI automatically detects what page you are on and uses it as context. Ask "why is this score low?" while viewing an evaluation, and it knows which evaluation you mean. It can also fetch content from URLs you paste, extract text from uploaded files, and stream responses with real-time tool execution.
+
+---
+
+## Opening Falcon AI
+
+<Tabs>
+  <Tab title="Sidebar">
+    Press `Cmd+K` (Mac) or `Ctrl+K` (Windows/Linux) to open a sidebar overlay on the right side of the dashboard. It stays open as you navigate between pages.
+
+    ![Open Falcon AI sidebar](/screenshot/product/falcon/1.png)
+  </Tab>
+  <Tab title="Full page">
+    Click **Falcon AI** in the navigation sidebar to open the full-page view at `/dashboard/falcon-ai`. A conversation history panel on the left lets you search, rename, and delete past conversations.
+
+    ![Open Falcon AI full page](/screenshot/product/falcon/2.png)
+  </Tab>
+</Tabs>
+
+---
+
+## Asking questions
+
+Type a question in the input area and press Enter. Falcon AI detects the domain of your request and loads the right tools automatically.
+
+![Ask a question](/screenshot/product/falcon/3.png)
+
+To reference a different page than the one you are on, either navigate there first or specify it in your message:
+
+> "On the evaluations page, which model had the highest faithfulness score?"
+
+---
+
+## Adding context
+
+Falcon AI detects page context automatically based on the current dashboard page. You can also attach entities manually by clicking **+ Add context** in the input area. Up to 5 entities can be attached at a time. Context chips appear above the input with an X to remove them.
+
+---
+
+## Quick actions and slash commands
+
+On a new conversation, quick action buttons appear above the input: **Analyze with compass**, **Create custom views**, **Build a dataset**, **Create an evaluation**, **Run simulation for my agent**. They disappear after the first message.
+
+![Quick action buttons](/screenshot/product/falcon/4.png)
+
+Type `/` at the start of a message to open the command picker. All active skills, both built-in and custom, appear as slash commands. Select one to run its workflow in the current conversation.
+
+---
+
+## File uploads
+
+Click the attachment button or drag files into the input area. Falcon AI extracts text content and uses it as context for your question.
+
+| File type | What happens |
+|-----------|-------------|
+| **PDF** | Text is extracted from all pages |
+| **Excel / CSV** | Spreadsheet data is converted to text |
+| **Word (.docx)** | Document text is extracted |
+| **Images (PNG, JPG)** | Image is encoded and sent to the model for visual understanding |
+| **Text / Markdown / JSON** | Content is included directly |
+
+<Note>
+  Maximum file size is 10 MB per upload.
+</Note>
+
+---
+
+## URL fetching
+
+Paste a URL in your message and Falcon AI automatically fetches its content. This works with:
+
+- **Web pages**: HTML is cleaned and converted to text
+- **JSON APIs**: Response is formatted as a code block
+- **GitHub raw files**: Content is included as a code block
+- **Jupyter notebooks**: Code and markdown cells are extracted
+
+Up to 3 URLs are fetched in parallel, with a maximum of 50 KB of content per URL.
+
+---
+
+## Following responses
+
+Responses stream token by token with Markdown formatting. When Falcon AI calls platform tools, collapsible cards show each step:
+
+- A **spinner** while the tool is running
+- A **checkmark** when it completes
+- A **warning icon** if it errors
+
+![Response with tool calls](/screenshot/product/falcon/5.png)
+
+When a tool creates or modifies a platform entity, a **completion card** appears with a direct link to the result.
+
+Falcon AI can call multiple tools in parallel when they are independent, and chains them sequentially when one depends on another. A single turn can run up to 50 tool-call iterations.
+
+---
+
+## Stopping a response
+
+Click the **Stop** button in the input area while Falcon AI is streaming. The current tool execution is cancelled and the response ends at whatever has been generated so far.
+
+---
+
+## Conversation history
+
+<Tabs>
+  <Tab title="Sidebar">
+    Click the **history** (clock) button at the top of the sidebar to see past conversations.
+  </Tab>
+  <Tab title="Full page">
+    The left panel shows all conversations with search. Right-click a conversation to rename or delete it.
+  </Tab>
+</Tabs>
+
+![Conversation history](/screenshot/product/falcon/6.png)
+
+Conversations persist across sessions. If you close the browser and come back, your full history is available.
+
+---
+
+## Reconnection
+
+If your connection drops mid-response, Falcon AI automatically replays missed events when you reconnect so you see the complete response.
+
+---
+
+## Rate limits
+
+Falcon AI allows 10 messages per 60 seconds per user. If you hit the limit, wait briefly before sending the next message.
+
+---
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Skills" icon="zap" href="/docs/falcon-ai/features/skills">
+    Use built-in workflows or create custom slash commands.
+  </Card>
+  <Card title="MCP Connectors" icon="plug" href="/docs/falcon-ai/features/mcp-connectors">
+    Connect external tools like Linear, Slack, and GitHub.
+  </Card>
+</CardGroup>

src/pages/docs/falcon-ai/features/mcp-connectors.mdx

@@ -0,0 +1,121 @@
+---
+title: "MCP Connectors"
+description: "Connect external MCP servers to Falcon AI to use tools from services like Linear, Slack, GitHub, Sentry, and custom APIs."
+---
+
+## About
+
+Falcon AI comes with built-in tools for the Future AGI platform, but many workflows involve external services: project trackers, communication tools, monitoring systems, and internal APIs. MCP Connectors extend Falcon AI by connecting it to any server that implements the [Model Context Protocol](https://modelcontextprotocol.io). Once connected, Falcon AI discovers the server's tools and can call them during conversations alongside built-in platform tools.
+
+This means tasks like "create a Linear ticket for this failing evaluation" or "post this cost report to Slack" happen inside Falcon AI without switching tools.
+
+---
+
+## Examples
+
+- **Project management**: Connect Linear, Jira, or Asana to create and update issues from evaluation or trace analysis.
+- **Communication**: Connect Slack or email to share reports and alerts directly.
+- **Monitoring**: Connect Sentry or PagerDuty to pull error context into debugging conversations.
+- **Internal APIs**: Connect custom MCP servers that expose your organization's tools.
+
+---
+
+## Adding a connector
+
+<Steps>
+  <Step title="Open connector settings">
+    Open Falcon AI settings and go to the **Connectors** section. Click **Add Connector**.
+
+    ![Add connector form](/screenshot/product/falcon/9.png)
+  </Step>
+
+  <Step title="Configure the connection">
+    Fill in the connector fields:
+
+    | Field | Required | Description |
+    |-------|----------|-------------|
+    | **Name** | Yes | Display name for the connector (e.g., "Linear", "Sentry") |
+    | **Server URL** | Yes | The MCP server endpoint URL |
+    | **Transport** | Yes | `streamable_http` (default, recommended) or `sse` (Server-Sent Events) |
+    | **Auth type** | Yes | How to authenticate with the server (see below) |
+  </Step>
+
+  <Step title="Configure authentication">
+    Choose the authentication method that your MCP server requires:
+
+    | Auth type | Fields | Description |
+    |-----------|--------|-------------|
+    | **None** | -- | No authentication required |
+    | **API Key** | Header name, Header value | Sends a custom header with each request (e.g., `X-API-Key: your-key`) |
+    | **Bearer Token** | Token | Sends `Authorization: Bearer <token>` with each request |
+    | **OAuth 2.1** | Client ID, Client secret, Auth URL, Token URL, Scopes | Full OAuth flow with automatic token refresh |
+
+    <Tip>
+      For OAuth connectors, Falcon AI handles the entire authorization flow. After saving the connector, click **Authenticate** to open the OAuth consent screen. Tokens are stored securely and refreshed automatically when they expire.
+    </Tip>
+  </Step>
+
+  <Step title="Test the connection">
+    Click **Test Connection** to verify that Falcon AI can reach the MCP server and authenticate successfully. If the test fails, the error message is displayed so you can debug the configuration.
+  </Step>
+
+  <Step title="Discover tools">
+    Click **Discover Tools** to query the MCP server for its available tools. Falcon AI reads the server's tool schema and displays the list with names, descriptions, and parameter definitions.
+
+    The discovery result is cached. Re-run discovery if the server adds new tools.
+  </Step>
+
+  <Step title="Enable tools">
+    Not all discovered tools need to be active. Select which tools Falcon AI should have access to from the discovered list. Only enabled tools appear in conversations.
+
+    This is useful when a server exposes many tools but you only need a subset, keeping Falcon AI's tool set focused and reducing context window usage.
+  </Step>
+</Steps>
+
+---
+
+## Using connector tools in chat
+
+Once enabled, connector tools appear in Falcon AI conversations alongside built-in platform tools. Falcon AI decides when to use them based on your request. Tool names from connectors are prefixed with the connector name to avoid collisions (e.g., `linear_create_issue`).
+
+**Examples:**
+
+> "Create a Linear ticket for the faithfulness regression we found in the last evaluation run."
+
+> "Post a summary of today's error spikes to the #ml-alerts Slack channel."
+
+> "Check Sentry for any new issues related to the summarization service."
+
+---
+
+## Transport options
+
+MCP Connectors support two transport protocols:
+
+| Transport | How it works | When to use |
+|-----------|-------------|-------------|
+| **Streamable HTTP** | Standard HTTP POST requests with JSON-RPC 2.0 payloads | Default. Works with most MCP servers. |
+| **SSE** (Server-Sent Events) | Long-lived HTTP connection with server-pushed events | Use when the server requires SSE transport or for streaming tool results. |
+
+Falcon AI automatically tries multiple endpoint paths (with and without `/mcp` suffix) to find the correct one for your server.
+
+---
+
+## Managing connectors
+
+- **Edit**: Update any connector field from the Connectors settings page. Re-test and re-discover after changes.
+- **Delete**: Remove a connector and all its cached tool schemas. Tools from deleted connectors are immediately unavailable in conversations.
+- **Re-authenticate**: For OAuth connectors, click **Authenticate** again if the authorization has been revoked or if scopes need to change.
+
+---
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Using Falcon AI" icon="message-circle" href="/docs/falcon-ai/features/chat">
+    Learn the basics of the chat interface.
+  </Card>
+  <Card title="Skills" icon="zap" href="/docs/falcon-ai/features/skills">
+    Create custom workflows that can use connector tools.
+  </Card>
+</CardGroup>