From dd4d2c68fa264dab2b2f8f2d8fb3c6d3fc85ecfc Mon Sep 17 00:00:00 2001 From: TJ <63432918+tj-cycyota@users.noreply.github.com> Date: Sat, 25 May 2024 09:28:46 -0700 Subject: [PATCH] DBRX (Databricks LLM) example notebook (#2434) * Resolving test failures locally * Resolving test failures locally * Updates to website resources and docs, author * Adding image * Fixes to precommit and doc files for lfd * Fixing ruff exclusion of new notebook * Updates to support notebook rendering * Updates to support notebook rendering * Removing some results to try to fix docs render issue * pre-commit to standardize formatting --------- Co-authored-by: Eric Zhu --- .pre-commit-config.yaml | 1 + notebook/agentchat_databricks_dbrx.ipynb | 740 ++++++++++++++++++ website/docs/ecosystem/databricks.md | 10 + .../ecosystem/img/ecosystem-databricks.png | 3 + 4 files changed, 754 insertions(+) create mode 100644 notebook/agentchat_databricks_dbrx.ipynb create mode 100644 website/docs/ecosystem/databricks.md create mode 100644 website/docs/ecosystem/img/ecosystem-databricks.png diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index fcea09223c6..8f2521cbdb0 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -32,6 +32,7 @@ repos: - id: ruff types_or: [ python, pyi, jupyter ] args: ["--fix", "--ignore=E402"] + exclude: notebook/agentchat_databricks_dbrx.ipynb - repo: https://github.com/codespell-project/codespell rev: v2.2.6 hooks: diff --git a/notebook/agentchat_databricks_dbrx.ipynb b/notebook/agentchat_databricks_dbrx.ipynb new file mode 100644 index 00000000000..3b6707196f1 --- /dev/null +++ b/notebook/agentchat_databricks_dbrx.ipynb @@ -0,0 +1,740 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Use AutoGen in Databricks with DBRX\n", + "\n", + "![DBRX launch](https://www.databricks.com/en-blog-assets/static/2fe1a0af1ee0f6605024a810b604079c/dbrx-blog-header-optimized.png)\n", + "\n", + "In March 2024, Databricks released [DBRX](https://www.databricks.com/blog/introducing-dbrx-new-state-art-open-llm), a general-purpose LLM that sets a new standard for open LLMs. While available as an open-source model on Hugging Face ([databricks/dbrx-instruct](https://huggingface.co/databricks/dbrx-instruct/tree/main) and [databricks/dbrx-base](https://huggingface.co/databricks/dbrx-base) ), customers of Databricks can also tap into the [Foundation Model APIs](https://docs.databricks.com/en/machine-learning/model-serving/score-foundation-models.html#query-a-chat-completion-model), which make DBRX available through an OpenAI-compatible, autoscaling REST API.\n", + "\n", + "[Autogen](https://microsoft.github.io/autogen/docs/Use-Cases/agent_chat) is becoming a popular standard for agent creation. Built to support any \"LLM as a service\" that implements the OpenAI SDK, it can easily be extended to integrate with powerful open source models. \n", + "\n", + "This notebook will demonstrate a few basic examples of Autogen with DBRX, including the use of `AssistantAgent`, `UserProxyAgent`, and `ConversableAgent`. These demos are not intended to be exhaustive - feel free to use them as a base to build upon!\n", + "\n", + "## Requirements\n", + "AutoGen must be installed on your Databricks cluster, and requires `Python>=3.8`. This example includes the `%pip` magic command to install: `%pip install pyautogen`, as well as other necessary libraries. \n", + "\n", + "This code has been tested on: \n", + "* [Serverless Notebooks](https://docs.databricks.com/en/compute/serverless.html) (in public preview as of Apr 18, 2024)\n", + "* Databricks Runtime 14.3 LTS ML [docs](https://docs.databricks.com/en/release-notes/runtime/14.3lts-ml.html)\n", + "\n", + "This code can run in any Databricks workspace in a region where DBRX is available via pay-per-token APIs (or provisioned throughput). To check if your region is supported, see [Foundation Model Region Availability](https://docs.databricks.com/en/machine-learning/model-serving/model-serving-limits.html#foundation-model-apis-limits). If the above is true, the workspace must also be enabled by an admin for Foundation Model APIs [docs](https://docs.databricks.com/en/machine-learning/foundation-models/index.html#requirements).\n", + "\n", + "## Tips\n", + "* This notebook can be imported from github to a Databricks workspace and run directly. Use [sparse checkout mode with git](https://www.databricks.com/blog/2023/01/26/work-large-monorepos-sparse-checkout-support-databricks-repos.html) to import only this notebook or the examples directory. \n", + "\n", + "* Databricks recommends using [Secrets](https://docs.databricks.com/en/security/secrets/secrets.html) instead of storing tokens in plain text. \n", + "\n", + "## Contributor\n", + "\n", + "tj@databricks.com (Github: tj-cycyota)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "nteract": { + "transient": { + "deleting": false + } + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "" + ] + } + ], + "source": [ + "%pip install pyautogen==0.2.25 openai==1.21.2 typing_extensions==4.11.0 --upgrade" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "It is recommended to restart the Python kernel after installs - uncomment and run the below:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# dbutils.library.restartPython()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Setup DBRX config list\n", + "\n", + "See Autogen docs for more inforation on the use of `config_list`: [LLM Configuration](https://microsoft.github.io/autogen/docs/topics/llm_configuration#why-is-it-a-list)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import os\n", + "\n", + "# Set environment variables with your current workspace host and a personal access token\n", + "# To a secret you have already set up: dbutils.secrets.get('your_scope_name','databricks_host')\n", + "\n", + "# DATABRICKS_HOST format: \"https://{your workspace url}\" (no trailing slash)\n", + "## AWS Workspace example: \"https://my-databricks-workspace.cloud.databricks.com\"\n", + "## Azure Workspace example: \"https://adb-123456790123.12.azuredatabricks.net\"\n", + "os.environ[\"DATABRICKS_HOST\"] = \"\"\n", + "\n", + "# DATABRICKS_TOKEN format: \"dapi...\"\n", + "## Temp token: dbutils.notebook.entry_point.getDbutils().notebook().getContext().apiToken().get()\n", + "os.environ[\"DATABRICKS_TOKEN\"] = \"dapi....\"\n", + "\n", + "llm_config = {\n", + " \"config_list\": [\n", + " {\n", + " \"model\": \"databricks-dbrx-instruct\",\n", + " \"api_key\": str(os.environ[\"DATABRICKS_TOKEN\"]),\n", + " \"base_url\": str(os.getenv(\"DATABRICKS_HOST\")) + \"/serving-endpoints\",\n", + " }\n", + " ],\n", + "}" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Hello World Example\n", + "\n", + "Our first example will be with a simple `UserProxyAgent` asking a question to an `AssistantAgent`. This is based on the tutorial demo [here](https://microsoft.github.io/autogen/docs/tutorial/introduction).\n", + "\n", + "After sending the question and seeing a response, you can type `exit` to end the chat or continue to converse." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "\u001b[33muser\u001b[0m (to assistant):\n", + "\n", + "What is MLflow?\n", + "\n", + "--------------------------------------------------------------------------------\n", + "\u001b[33massistant\u001b[0m (to user):\n", + "\n", + "Sure, I'd be happy to explain MLflow to you. MLflow is an open-source platform for managing machine learning workflows. It was developed by Databricks and was open-sourced in 2018. MLflow provides a number of features to help data scientists and machine learning engineers manage the end-to-end machine learning lifecycle, including:\n", + "\n", + "1. **MLflow Tracking**: This is a logging API that allows you to record and query experiments, including code, data, config, and results.\n", + "2. **MLflow Projects**: This is a format for packaging reusable and reproducible data science code, which can be run on different platforms.\n", + "3. **MLflow Models**: This is a convention for packaging machine learning models in multiple formats, making it easy to deploy in different environments.\n", + "4. **MLflow Model Registry**: This is a central repository to store, manage, and serve machine learning models.\n", + "\n", + "Here is a Python code example of how you might use MLflow Tracking to log a simple experiment:\n", + "```python\n", + "# filename: mlflow_example.py\n", + "\n", + "import mlflow\n", + "import numpy as np\n", + "\n", + "# Log a parameter (e.g., number of trees in a random forest)\n", + "mlflow.log_param(\"num_trees\", 100)\n", + "\n", + "# Log a metric (e.g., accuracy of a model)\n", + "accuracy = np.random.rand()\n", + "mlflow.log_metric(\"accuracy\", accuracy)\n", + "\n", + "# Log the model\n", + "mlflow.sklearn.log_model(model, \"model\")\n", + "\n", + "# End the run\n", + "mlflow.end_run()\n", + "```\n", + "To run this code, you would need to have MLflow installed and running on your machine. You can install MLflow using pip:\n", + "```\n", + "pip install mlflow\n", + "```\n", + "Then, you can run the code using the following command:\n", + "```\n", + "python mlflow_example.py\n", + "```\n", + "This will create a new experiment in MLflow and log the parameters, metrics, and model. You can then view the experiment in the MLflow UI.\n", + "\n", + "I hope this helps! Let me know if you have any other questions.\n", + "\n", + "--------------------------------------------------------------------------------\n" + ] + }, + { + "data": { + "text/plain": [ + "Provide feedback to assistant. Press enter to skip and use auto-reply, or type 'exit' to end the conversation: exit" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "import autogen\n", + "\n", + "# Create Assistant and User\n", + "assistant = autogen.AssistantAgent(name=\"assistant\", llm_config=llm_config)\n", + "\n", + "user_proxy = autogen.UserProxyAgent(name=\"user\", code_execution_config=False)\n", + "\n", + "# Initiate chat from user_proxy side\n", + "chat_result = user_proxy.initiate_chat(assistant, message=\"What is MLflow?\")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple Coding Agent\n", + "\n", + "In this example, we will implement a \"coding agent\" that can execute code. You will see how this code is run alongside your notebook in your current workspace, taking advantage of the performance benefits of Databricks clusters. This is based off the demo [here](https://microsoft.github.io/autogen/docs/topics/non-openai-models/cloud-mistralai/).\n", + "\n", + "First, set up a directory: " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "coding\n" + ] + } + ], + "source": [ + "from pathlib import Path\n", + "\n", + "workdir = Path(\"coding\")\n", + "print(workdir)\n", + "workdir.mkdir(exist_ok=True)\n", + "\n", + "from autogen.coding import LocalCommandLineCodeExecutor\n", + "\n", + "code_executor = LocalCommandLineCodeExecutor(work_dir=workdir)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Next, setup our agents and initiate a coding problem. Notice how the `UserProxyAgent` will take advantage of our `code_executor`; after the code is shown on screen, type Return/Enter in the chatbox to have it execute locally on your cluster via the bot's auto-reply. \n", + "\n", + "**Note**: with generative AI coding assistants, you should **always** manually read and review the code before executing it yourself, as LLM results are non-deterministic and may lead to unintended consequences." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "\u001b[33mUser\u001b[0m (to DBRX Assistant):\n", + "\n", + "Count how many prime numbers from 1 to 10000.\n", + "\n", + "--------------------------------------------------------------------------------\n", + "\u001b[33mDBRX Assistant\u001b[0m (to User):\n", + "\n", + "Sure, I can help you with that. We can write a Python script to count the number of prime numbers from 1 to 10000. Here's the script:\n", + "\n", + "```python\n", + "# filename: count_primes.py\n", + "\n", + "def is_prime(n):\n", + " if n <= 1:\n", + " return False\n", + " if n <= 3:\n", + " return True\n", + " if n % 2 == 0 or n % 3 == 0:\n", + " return False\n", + " i = 5\n", + " while i * i <= n:\n", + " if n % i == 0 or n % (i + 2) == 0:\n", + " return False\n", + " i += 6\n", + " return True\n", + "\n", + "def count_primes(end):\n", + " count = 0\n", + " for num in range(1, end + 1):\n", + " if is_prime(num):\n", + " count += 1\n", + " return count\n", + "\n", + "print(count_primes(10000))\n", + "```\n", + "\n", + "This script first defines a helper function `is_prime(n)` to check if a number `n` is prime. Then, it defines the main function `count_primes(end)` to count the number of prime numbers up to `end`. Finally, it prints the number of prime numbers from 1 to 10000.\n", + "\n", + "To run the script, save it to a file named `count_primes.py`, and then execute it using the command `python count_primes.py` in a terminal or command prompt. The script will print the number of prime numbers from 1 to 10000.\n", + "\n", + "Let me know if you encounter any issues or errors when running the script.\n", + "\n", + "--------------------------------------------------------------------------------\n" + ] + }, + { + "data": { + "text/plain": [ + "Provide feedback to DBRX Assistant. Press enter to skip and use auto-reply, or type 'exit' to end the conversation: " + ] + }, + "metadata": {}, + "output_type": "display_data" + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + "\u001b[31m\n", + ">>>>>>>> NO HUMAN INPUT RECEIVED.\u001b[0m\n", + "\u001b[31m\n", + ">>>>>>>> USING AUTO REPLY...\u001b[0m\n", + "\u001b[31m\n", + ">>>>>>>> EXECUTING CODE BLOCK (inferred language is python)...\u001b[0m\n", + "\u001b[33mUser\u001b[0m (to DBRX Assistant):\n", + "\n", + "exitcode: 0 (execution succeeded)\n", + "Code output: 1229\n", + "\n", + "\n", + "--------------------------------------------------------------------------------\n", + "\u001b[33mDBRX Assistant\u001b[0m (to User):\n", + "\n", + "Great! The execution succeeded and the output is 1229, which is the number of prime numbers from 1 to 10000. This means that there are 1229 prime numbers in the range of 1 to 10000.\n", + "\n", + "To verify the result, we can manually check the prime numbers in the range of 1 to 10000. Here are the first few prime numbers:\n", + "\n", + "2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127, 131, 137, 139, 149, 151, 157, 163, 167, 169, 173, 179, 181, 191, 193, 197, 199,...\n", + "\n", + "We can see that there are indeed 1229 prime numbers in the range of 1 to 10000.\n", + "\n", + "Therefore, the output of the script is correct and the task is solved.\n", + "\n", + "TERMINATE\n", + "\n", + "--------------------------------------------------------------------------------\n" + ] + }, + { + "data": { + "text/plain": [ + "Provide feedback to DBRX Assistant. Press enter to skip and use auto-reply, or type 'exit' to end the conversation: exit" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from autogen import AssistantAgent, UserProxyAgent\n", + "\n", + "# Setting up the agents.\n", + "user_proxy_agent = UserProxyAgent(\n", + " name=\"User\",\n", + " code_execution_config={\"executor\": code_executor},\n", + " is_termination_msg=lambda msg: \"TERMINATE\" in msg.get(\"content\"),\n", + ")\n", + "\n", + "assistant_agent = AssistantAgent(\n", + " name=\"DBRX Assistant\",\n", + " llm_config=llm_config,\n", + ")\n", + "\n", + "chat_result = user_proxy_agent.initiate_chat(\n", + " assistant_agent,\n", + " message=\"Count how many prime numbers from 1 to 10000.\",\n", + ")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can see the python file that was created in our working directory:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "count_primes.py\n" + ] + } + ], + "source": [ + "%sh ls coding" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "# filename: count_primes.py\n", + "\n", + "def is_prime(n):\n", + " if n <= 1:\n", + " return False\n", + " if n <= 3:\n", + " return True\n", + " if n % 2 == 0 or n % 3 == 0:\n", + " return False\n", + " i = 5\n" + ] + } + ], + "source": [ + "%sh head coding/count_primes.py" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conversable Bots\n", + "\n", + "We can also implement the [two-agent chat pattern](https://microsoft.github.io/autogen/docs/tutorial/conversation-patterns/#two-agent-chat-and-chat-result) using DBRX to \"talk to itself\" in a teacher/student exchange:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "\u001b[33mStudent_Agent\u001b[0m (to Teacher_Agent):\n", + "\n", + "How does deep learning relate to artificial intelligence?\n", + "\n", + "--------------------------------------------------------------------------------\n", + "\u001b[31m\n", + ">>>>>>>> USING AUTO REPLY...\u001b[0m\n", + "\u001b[33mTeacher_Agent\u001b[0m (to Student_Agent):\n", + "\n", + "Hello there! I'm glad you asked about the relationship between deep learning and artificial intelligence (AI).\n", + "\n", + "Deep learning is actually a subset of AI, which is a broader field dedicated to creating algorithms and systems that can perform tasks that would normally require human intelligence. Other subsets of AI include rule-based systems, machine learning, natural language processing, and computer vision, among others.\n", + "\n", + "Deep learning, on the other hand, is a specific approach to building AI systems that is inspired by the structure and function of the human brain. In deep learning, we use artificial neural networks, which are composed of interconnected nodes or \"neurons,\" to learn patterns in data and make predictions or decisions without being explicitly programmed to do so.\n", + "\n", + "Deep learning has been particularly successful in recent years due to several factors, including the availability of large amounts of data, powerful computational resources, and advances in neural network architectures and training algorithms. As a result, deep learning has achieved state-of-the-art performance in a wide range of tasks, such as image and speech recognition, natural language processing, and game playing.\n", + "\n", + "So, in summary, deep learning is a specific approach to building AI systems that has gained a lot of attention in recent years due to its impressive performance on a variety of tasks. However, it is just one of many approaches to building AI systems, and it is important to understand the broader context of AI in order to fully appreciate the potential and limitations of deep learning.\n", + "\n", + "--------------------------------------------------------------------------------\n" + ] + } + ], + "source": [ + "from autogen import ConversableAgent\n", + "\n", + "# Setting up the agents.\n", + "student_agent = ConversableAgent(\n", + " name=\"Student_Agent\",\n", + " system_message=\"You are a student willing to learn.\",\n", + " llm_config=llm_config,\n", + ")\n", + "\n", + "teacher_agent = ConversableAgent(\n", + " name=\"Teacher_Agent\",\n", + " system_message=\"You are a computer science teacher.\",\n", + " llm_config=llm_config,\n", + ")\n", + "\n", + "# Initiate chat\n", + "chat_result = student_agent.initiate_chat(\n", + " teacher_agent,\n", + " message=\"How does deep learning relate to artificial intelligence?\",\n", + " summary_method=\"last_msg\",\n", + " max_turns=1, # Set to higher number to control back and forth\n", + ")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Implement Logging Display\n", + "\n", + "It can be useful to display chat logs to the notebook for debugging, and then persist those logs to a Delta table. The following section demonstrates how to extend the default AutoGen logging libraries.\n", + "\n", + "First, we will implement a Python `class` that extends the capabilities of `autogen.runtime_logging` [docs](https://microsoft.github.io/autogen/docs/notebooks/agentchat_logging):" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "class Databricks_AutoGenLogger:\n", + " def __init__(self):\n", + " from pyspark.sql import SparkSession\n", + " import autogen\n", + "\n", + " self.spark = SparkSession.builder.getOrCreate()\n", + " self.logger_config = {\"dbname\": \"logs.db\"}\n", + "\n", + " def start(self):\n", + " import autogen.runtime_logging\n", + "\n", + " self.logging_session_id = autogen.runtime_logging.start(config=self.logger_config)\n", + " print(\"Logging session ID: \" + str(self.logging_session_id))\n", + "\n", + " def stop(self):\n", + " import autogen.runtime_logging\n", + "\n", + " autogen.runtime_logging.stop()\n", + "\n", + " def _get_log(self, dbname=\"logs.db\", table=\"chat_completions\"):\n", + " import sqlite3\n", + "\n", + " con = sqlite3.connect(dbname)\n", + " query = f\"SELECT * from {table} WHERE session_id == '{self.logging_session_id}' ORDER BY end_time DESC\"\n", + " cursor = con.execute(query)\n", + " rows = cursor.fetchall()\n", + " column_names = [description[0] for description in cursor.description]\n", + " data = [dict(zip(column_names, row)) for row in rows]\n", + " con.close()\n", + " return data\n", + "\n", + " def display_session(self):\n", + " import pandas as pd\n", + "\n", + " return pd.DataFrame(self._get_log())\n", + "\n", + " def persist_results(self, target_delta_table: str, mode=\"append\"):\n", + " import pandas as pd\n", + "\n", + " # Convert to Spark DF\n", + " sdf = self.spark.createDataFrame(pd.DataFrame(self._get_log()))\n", + "\n", + " try:\n", + " sdf.write.format(\"delta\").mode(mode).saveAsTable(target_delta_table)\n", + " print(f\"Logs sucessfully written to table {target_delta_table} in {mode} mode\")\n", + " except Exception as e:\n", + " print(f\"An error occurred: {e}\")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let's use the class above on our simplest example. Note the addition of logging `.start()` and `.stop()`, as well as try/except for error handling. " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Logging session ID: 6c389f5f-3619-4762-8118-bc98dd414f90\n", + "\u001b[33muser\u001b[0m (to assistant):\n", + "\n", + "What is MLflow?\n", + "\n", + "--------------------------------------------------------------------------------\n", + "\u001b[33massistant\u001b[0m (to user):\n", + "\n", + "Sure, I'd be happy to explain MLflow to you. MLflow is an open-source platform for managing machine learning workflows. It was developed by Databricks and was open-sourced in 2018. MLflow provides a number of features to help data scientists and machine learning engineers manage the end-to-end machine learning lifecycle, including:\n", + "\n", + "1. **MLflow Tracking**: This is a logging API that allows you to record and query experiments, including code, data, config, and results.\n", + "2. **MLflow Projects**: This is a format for packaging reusable and reproducible data science code, which can be run on different platforms.\n", + "3. **MLflow Models**: This is a convention for packaging machine learning models in multiple formats, making it easy to deploy in different environments.\n", + "4. **MLflow Model Registry**: This is a central repository to store, manage, and serve machine learning models.\n", + "\n", + "Here is a Python code example of how you might use MLflow Tracking to log a simple experiment:\n", + "```python\n", + "# filename: mlflow_example.py\n", + "\n", + "import mlflow\n", + "import numpy as np\n", + "\n", + "# Log a parameter (e.g., number of trees in a random forest)\n", + "mlflow.log_param(\"num_trees\", 100)\n", + "\n", + "# Log a metric (e.g., accuracy of a model)\n", + "accuracy = np.random.rand()\n", + "mlflow.log_metric(\"accuracy\", accuracy)\n", + "\n", + "# Log the model\n", + "mlflow.sklearn.log_model(model, \"model\")\n", + "\n", + "# End the run\n", + "mlflow.end_run()\n", + "```\n", + "To run this code, you would need to have MLflow installed and running on your machine. You can install MLflow using pip:\n", + "```\n", + "pip install mlflow\n", + "```\n", + "Then, you can run the code using the following command:\n", + "```\n", + "python mlflow_example.py\n", + "```\n", + "This will create a new experiment in MLflow and log the parameters, metrics, and model. You can then view the experiment in the MLflow UI.\n", + "\n", + "I hope this helps! Let me know if you have any other questions.\n", + "\n", + "--------------------------------------------------------------------------------\n" + ] + }, + { + "data": { + "text/html": [] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "assistant = autogen.AssistantAgent(name=\"assistant\", llm_config=llm_config)\n", + "user_proxy = autogen.UserProxyAgent(name=\"user\", code_execution_config=False)\n", + "\n", + "# Before initiating chat, start logging:\n", + "logs = Databricks_AutoGenLogger()\n", + "logs.start()\n", + "try:\n", + " user_proxy.initiate_chat(assistant, message=\"What is MLflow?\", max_turns=1)\n", + "except Exception as e:\n", + " print(f\"An error occurred: {e}\")\n", + "logs.stop()\n", + "# Display logs\n", + "display(logs.display_session())" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "With this, we have a simple framework to review and persist logs from our chats! Notice that in the `request` field above, we can also see the system prompt for the LLM - this can be useful for prompt engineering as well as debugging.\n", + "\n", + "Note that when you deploy this to Databricks Model Serving, model responses are auto-logged using [Lakehouse Monitoring](https://docs.databricks.com/en/lakehouse-monitoring/index.html); but the above approach provides a simple mechanism to log chats from the **client side**.\n", + "\n", + "Let's now persist these results to a Delta table in [Unity Catalog](https://docs.databricks.com/en/data-governance/unity-catalog/index.html):" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Logs sucessfully written to table shared.tjc.autogent_logs in append mode\n" + ] + }, + { + "data": { + "text/html": [] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from pyspark.sql import SparkSession\n", + "\n", + "spark = SparkSession.builder.getOrCreate() # Not needed in Databricks; session pre-provisioned in notebooks\n", + "\n", + "# Use 3-layer namespace: catalog.schema.table. The table will be created if it does not exist.\n", + "target_delta_table = \"your_catalog.your_schema.autogen_logs\"\n", + "logs.persist_results(target_delta_table=target_delta_table, mode=\"append\")\n", + "\n", + "# Display current rows in table\n", + "display(spark.table(target_delta_table))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Closing Thoughts\n", + "This notebook provides a few basic examples of using Autogen with DBRX, and we're excited to see how you can use this framework alongside leading open-source LLMs!\n", + "\n", + "### Limitations\n", + "* Databricks Foundation Model API supports other open-source LLMs (Mixtral, Llama2, etc.), but the above code has not been tested on those.\n", + "\n", + "* As of April 2024, DBRX does not yet support tool/function calling abilities. To discuss this capability further, please reach out to your Databricks representative." + ] + } + ], + "metadata": { + "front_matter": { + "description": "Use Databricks DBRX and Foundation Model APIs to build AutoGen applications backed by open-source LLMs.", + "tags": [ + "code generation", + "dbrx", + "databricks", + "open source", + "lakehouse", + "data intelligence" + ] + }, + "language_info": { + "name": "python" + }, + "notebook_environment": {}, + "nteract": { + "version": "nteract-front-end@1.0.0" + }, + "save_output": true, + "skip_test": "Invalid environment: will only run in Databricks workspace after replacing variables", + "spark_compute": { + "compute_id": "/default", + "session_options": { + "conf": {}, + "enableDebugMode": false + } + } + }, + "nbformat": 4, + "nbformat_minor": 0 +} diff --git a/website/docs/ecosystem/databricks.md b/website/docs/ecosystem/databricks.md new file mode 100644 index 00000000000..a41d20116f8 --- /dev/null +++ b/website/docs/ecosystem/databricks.md @@ -0,0 +1,10 @@ +# Databricks + +![Databricks Data Intelligence Platform](img/ecosystem-databricks.png) + +The [Databricks Data Intelligence Platform ](https://www.databricks.com/product/data-intelligence-platform) allows your entire organization to use data and AI. It’s built on a lakehouse to provide an open, unified foundation for all data and governance, and is powered by a Data Intelligence Engine that understands the uniqueness of your data. + + +This example demonstrates how to use AutoGen alongside Databricks Foundation Model APIs and open-source LLM DBRX. + +- [Databricks + AutoGen Code Examples](https://microsoft.autogen.io/docs/notebooks/agentchat_databricks_dbrx) diff --git a/website/docs/ecosystem/img/ecosystem-databricks.png b/website/docs/ecosystem/img/ecosystem-databricks.png new file mode 100644 index 00000000000..150c344c666 --- /dev/null +++ b/website/docs/ecosystem/img/ecosystem-databricks.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:19ac6d3ddc8dc8552d27dea0f055add9bc4abe5671a28c883940ec728d2aff0f +size 203365