Add conversational agent app project

CODEOWNERS

@@ -7,6 +7,7 @@
 # Specific owners are listed last. Please keep this list in the alphabetical order
 
 acceptance                 @nfx @alexott
+conversational-agent-app   @vivian-xie-db @yuanchaoma-db
 database-diagram-builder   @alexott
 downstreams                @nfx @alexott
 go-libs                    @nfx @alexott

conversational-agent-app/README.md

@@ -0,0 +1,85 @@
+---
+title: "Conversational Agent App"
+language: python
+author: "Vivian Xie"
+date: 2025-06-09
+---
+
+# Conversational Agent App
+
+
+![](./assets/genie_room0.png)
+![](./assets/genie-space.png)
+![](./assets/genie-space4.png)
+
+This repository demonstrates how to integrate Databricks' AI/BI Genie Conversation APIs into custom Databricks Apps applications, allowing users to interact with their structured data using natural language.
+
+You can also click the Generate insights button and generate deep analysis and trends of your data.
+![](./assets/insights1.png)
+![](./assets/insights2.png)
+
+
+
+## Overview
+
+This app is a Dash application featuring a chat interface powered by Databricks Genie Conversation APIs, built specifically to run as a Databricks App. This integration showcases how to leverage Databricks' platform capabilities to create interactive data applications with minimal infrastructure overhead.
+
+The Databricks Genie Conversation APIs (in Public Preview) enable you to embed AI/BI Genie capabilities into any application, allowing users to:
+- Ask questions about their data in natural language
+- Get SQL-powered insights without writing code
+- Follow up with contextual questions in a conversation thread
+
+## Key Features
+
+- **Powered by Databricks Apps**: Deploy and run directly from your Databricks workspace with built-in security and scaling
+- **Zero Infrastructure Management**: Leverage Databricks Apps to handle hosting, scaling, and security
+- **Workspace Integration**: Access your data assets and models directly from your Databricks workspace
+- **Natural Language Data Queries**: Ask questions about your data in plain English
+- **Stateful Conversations**: Maintain context for follow-up questions
+
+## Example Use Case
+
+This app shows how to create a simple interface that connects to the Genie API, allowing users to:
+1. Start a conversation with a question about their supply chain data
+2. View generated SQL and results
+3. Ask follow-up questions that maintain context
+
+## Deploying to Databricks apps
+
+The app can be installed through Databricks Marketplace. If you prefer to clone and deploy it manually, please refer to these instructions: 
+
+1. Clone the repository to your Databricks workspace using [Git Folder](https://docs.databricks.com/aws/en/repos/repos-setup):
+   - Navigate to the **Workspace** section in the sidebar.
+   - Click on the 'Create' button, select the 'Git Folder' option and follow the prompts to clone the repository.
+
+2. Create an app with a serving endpoint resource.
+   - Navigate to the **Compute** section in the sidebar.
+   - Go to the Apps tab and click the **Create app** button. Fill in the necessary fields and click **Next: Configuration**
+      - To reuse an existing app, click the link to your app in the **Name** column to go to the detail page of the app, then click **Edit**
+   - In the App resources section, click **+ Add resource** and select **Serving endpoint**. Choose a chat endpoint, grant **CAN_QUERY** permission and name it 'serving_endpoint'.
+
+For detailed instructions on configuring resources, refer to the [official Databricks documentation](https://docs.databricks.com/aws/en/dev-tools/databricks-apps/resources#configure-resources-for-your-app).
+
+3. Deploy the app using the Databricks Apps interface:
+   - Go to the detail page of the app.
+   - Click **Deploy** and select the folder 'conversational-agent-app' from the created Git folder.
+   - Click **Select**, then **Deploy**.
+   - Review the configuration and click **Deploy**.
+
+For more details, refer to the [official Databricks documentation](https://docs.databricks.com/aws/en/dev-tools/databricks-apps/deploy).
+
+## Troubleshooting
+
+For troubleshooting, navigate to the Monitoring page of the selected genie space and check if the query has been sent successfully to the genie room via the API. 
+
+![](./assets/troubleshooting1.png)
+
+Click open the query and check if there is any error or any permission issues.
+
+![](./assets/troubleshooting2.png)
+
+## Resources
+
+- [Databricks Genie Documentation](https://docs.databricks.com/aws/en/genie)
+- [Conversation APIs Documentation](https://docs.databricks.com/api/workspace/genie)
+- [Databricks Apps Documentation](https://docs.databricks.com/aws/en/dev-tools/databricks-apps/)