Movatterモバイル変換


[0]ホーム

URL:


Skip to main content
OurBuilding Ambient Agents with LangGraph course is now available on LangChain Academy!
Open In ColabOpen on GitHub

ChatDatabricks

Databricks Lakehouse Platform unifies data, analytics, and AI on one platform.

This notebook provides a quick overview for getting started with Databrickschat models. For detailed documentation of all ChatDatabricks features and configurations head to theAPI reference.

Overview

ChatDatabricks class wraps a chat model endpoint hosted onDatabricks Model Serving. This example notebook shows how to wrap your serving endpoint and use it as a chat model in your LangChain application.

Integration details

ClassPackageLocalSerializablePackage downloadsPackage latest
ChatDatabricksdatabricks-langchainbetaPyPI - DownloadsPyPI - Version

Model features

Tool callingStructured outputJSON modeImage inputAudio inputVideo inputToken-level streamingNative asyncToken usageLogprobs

Supported Methods

ChatDatabricks supports all methods ofChatModel including async APIs.

Endpoint Requirement

The serving endpointChatDatabricks wraps must have OpenAI-compatible chat input/output format (reference). As long as the input format is compatible,ChatDatabricks can be used for any endpoint type hosted onDatabricks Model Serving:

  1. Foundation Models - Curated list of state-of-the-art foundation models such as DRBX, Llama3, Mixtral-8x7B, and etc. These endpoint are ready to use in your Databricks workspace without any set up.
  2. Custom Models - You can also deploy custom models to a serving endpoint via MLflow withyour choice of framework such as LangChain, Pytorch, Transformers, etc.
  3. External Models - Databricks endpoints can serve models that are hosted outside Databricks as a proxy, such as proprietary model service like OpenAI GPT4.

Setup

To access Databricks models you'll need to create a Databricks account, set up credentials (only if you are outside Databricks workspace), and install required packages.

Credentials (only if you are outside Databricks)

If you are running LangChain app inside Databricks, you can skip this step.

Otherwise, you need manually set the Databricks workspace hostname and personal access token toDATABRICKS_HOST andDATABRICKS_TOKEN environment variables, respectively. SeeAuthentication Documentation for how to get an access token.

import getpass
import os

os.environ["DATABRICKS_HOST"]="https://your-workspace.cloud.databricks.com"
if"DATABRICKS_TOKEN"notin os.environ:
os.environ["DATABRICKS_TOKEN"]= getpass.getpass(
"Enter your Databricks access token: "
)
Enter your Databricks access token:  ········

Installation

The LangChain Databricks integration lives in thedatabricks-langchain package.

%pip install-qU databricks-langchain

We first demonstrates how to query DBRX-instruct model hosted as Foundation Models endpoint withChatDatabricks.

For other type of endpoints, there are some difference in how to set up the endpoint itself, however, once the endpoint is ready, there is no difference in how to query it withChatDatabricks. Please refer to the bottom of this notebook for the examples with other type of endpoints.

Instantiation

from databricks_langchainimport ChatDatabricks

chat_model= ChatDatabricks(
endpoint="databricks-dbrx-instruct",
temperature=0.1,
max_tokens=256,
# See https://python.langchain.com/api_reference/community/chat_models/langchain_community.chat_models.databricks.ChatDatabricks.html for other supported parameters
)

Invocation

chat_model.invoke("What is MLflow?")
AIMessage(content='MLflow is an open-source platform for managing end-to-end machine learning workflows. It was introduced by Databricks in 2018. MLflow provides tools for tracking experiments, packaging and sharing code, and deploying models. It is designed to work with any machine learning library and can be used in a variety of environments, including local machines, virtual machines, and cloud-based clusters. MLflow aims to streamline the machine learning development lifecycle, making it easier for data scientists and engineers to collaborate and deploy models into production.', response_metadata={'prompt_tokens': 229, 'completion_tokens': 104, 'total_tokens': 333}, id='run-d3fb4d06-3e10-4471-83c9-c282cc62b74d-0')
# You can also pass a list of messages
messages=[
("system","You are a chatbot that can answer questions about Databricks."),
("user","What is Databricks Model Serving?"),
]
chat_model.invoke(messages)
AIMessage(content='Databricks Model Serving is a feature of the Databricks platform that allows data scientists and engineers to easily deploy machine learning models into production. With Model Serving, you can host, manage, and serve machine learning models as APIs, making it easy to integrate them into applications and business processes. It supports a variety of popular machine learning frameworks, including TensorFlow, PyTorch, and scikit-learn, and provides tools for monitoring and managing the performance of deployed models. Model Serving is designed to be scalable, secure, and easy to use, making it a great choice for organizations that want to quickly and efficiently deploy machine learning models into production.', response_metadata={'prompt_tokens': 35, 'completion_tokens': 130, 'total_tokens': 165}, id='run-b3feea21-223e-4105-8627-41d647d5ccab-0')

Chaining

Similar to other chat models,ChatDatabricks can be used as a part of a complex chain.

from langchain_core.promptsimport ChatPromptTemplate

prompt= ChatPromptTemplate.from_messages(
[
(
"system",
"You are a chatbot that can answer questions about {topic}.",
),
("user","{question}"),
]
)

chain= prompt| chat_model
chain.invoke(
{
"topic":"Databricks",
"question":"What is Unity Catalog?",
}
)
API Reference:ChatPromptTemplate
AIMessage(content="Unity Catalog is a new data catalog feature in Databricks that allows you to discover, manage, and govern all your data assets across your data landscape, including data lakes, data warehouses, and data marts. It provides a centralized repository for storing and managing metadata, data lineage, and access controls for all your data assets. Unity Catalog enables data teams to easily discover and access the data they need, while ensuring compliance with data privacy and security regulations. It is designed to work seamlessly with Databricks' Lakehouse platform, providing a unified experience for managing and analyzing all your data.", response_metadata={'prompt_tokens': 32, 'completion_tokens': 118, 'total_tokens': 150}, id='run-82d72624-f8df-4c0d-a976-919feec09a55-0')

Invocation (streaming)

for chunkin chat_model.stream("How are you?"):
print(chunk.content, end="|")
I|'m| an| AI| and| don|'t| have| feelings|,| but| I|'m| here| and| ready| to| assist| you|.| How| can| I| help| you| today|?||

Async Invocation

import asyncio

country=["Japan","Italy","Australia"]
futures=[chat_model.ainvoke(f"Where is the capital of{c}?")for cin country]
await asyncio.gather(*futures)

Tool calling

ChatDatabricks supports OpenAI-compatible tool calling API that lets you describe tools and their arguments, and have the model return a JSON object with a tool to invoke and the inputs to that tool. tool-calling is extremely useful for building tool-using chains and agents, and for getting structured outputs from models more generally.

WithChatDatabricks.bind_tools, we can easily pass in Pydantic classes, dict schemas, LangChain tools, or even functions as tools to the model. Under the hood these are converted to the OpenAI-compatible tool schemas, which looks like:

{
"name": "...",
"description": "...",
"parameters": {...} # JSONSchema
}

and passed in every model invocation.

from pydanticimport BaseModel, Field


classGetWeather(BaseModel):
"""Get the current weather in a given location"""

location:str= Field(..., description="The city and state, e.g. San Francisco, CA")


classGetPopulation(BaseModel):
"""Get the current population in a given location"""

location:str= Field(..., description="The city and state, e.g. San Francisco, CA")


llm_with_tools= chat_model.bind_tools([GetWeather, GetPopulation])
ai_msg= llm_with_tools.invoke(
"Which city is hotter today and which is bigger: LA or NY?"
)
print(ai_msg.tool_calls)

Wrapping Custom Model Endpoint

Prerequisites:

Once the endpoint is ready, the usage pattern is identical to that of Foundation Models.

chat_model_custom= ChatDatabricks(
endpoint="YOUR_ENDPOINT_NAME",
temperature=0.1,
max_tokens=256,
)

chat_model_custom.invoke("How are you?")

Wrapping External Models

Prerequisite: Create Proxy Endpoint

First, create a new Databricks serving endpoint that proxies requests to the target external model. The endpoint creation should be fairy quick for proxying external models.

This requires registering your OpenAI API Key within the Databricks secret manager as follows:

# Replace `<scope>` with your scope
databricks secrets create-scope <scope>
databricks secrets put-secret <scope> openai-api-key --string-value $OPENAI_API_KEY

For how to set up Databricks CLI and manage secrets, please refer tohttps://docs.databricks.com/en/security/secrets/secrets.html

from mlflow.deploymentsimport get_deploy_client

client= get_deploy_client("databricks")

secret="secrets/<scope>/openai-api-key"# replace `<scope>` with your scope
endpoint_name="my-chat"# rename this if my-chat already exists
client.create_endpoint(
name=endpoint_name,
config={
"served_entities":[
{
"name":"my-chat",
"external_model":{
"name":"gpt-3.5-turbo",
"provider":"openai",
"task":"llm/v1/chat",
"openai_config":{
"openai_api_key":"{{"+ secret+"}}",
},
},
}
],
},
)

Once the endpoint status has become "Ready", you can query the endpoint in the same way as other types of endpoints.

chat_model_external= ChatDatabricks(
endpoint=endpoint_name,
temperature=0.1,
max_tokens=256,
)
chat_model_external.invoke("How to use Databricks?")

Function calling on Databricks

Databricks Function Calling is OpenAI-compatible and is only available during model serving as part of Foundation Model APIs.

SeeDatabricks function calling introduction for supported models.

llm= ChatDatabricks(endpoint="databricks-meta-llama-3-70b-instruct")
tools=[
{
"type":"function",
"function":{
"name":"get_current_weather",
"description":"Get the current weather in a given location",
"parameters":{
"type":"object",
"properties":{
"location":{
"type":"string",
"description":"The city and state, e.g. San Francisco, CA",
},
"unit":{"type":"string","enum":["celsius","fahrenheit"]},
},
},
},
}
]

# supported tool_choice values: "auto", "required", "none", function name in string format,
# or a dictionary as {"type": "function", "function": {"name": <<tool_name>>}}
model= llm.bind_tools(tools, tool_choice="auto")

messages=[{"role":"user","content":"What is the current temperature of Chicago?"}]
print(model.invoke(messages))

SeeDatabricks Unity Catalog about how to use UC functions in chains.

API reference

For detailed documentation of all ChatDatabricks features and configurations head to the API reference:https://api-docs.databricks.com/python/databricks-ai-bridge/latest/databricks_langchain.html#databricks_langchain.ChatDatabricks

Related


[8]ページ先頭

©2009-2025 Movatter.jp