Databricks Lakehouse 平台将数据、分析和 AI 统一到一个平台上。本指南提供了 Databricks 聊天模型 快速入门概览。有关 ChatDatabricks 所有功能和配置的详细文档,请参阅 API 参考。
概览
ChatDatabricks 类封装了托管在 Databricks Model Serving 上的聊天模型端点。本示例 notebook 展示了如何封装您的服务端点并在 LangChain 应用中将其用作聊天模型。
集成详情
| 类 | 包 | 可序列化 | 下载量 | 版本 |
|---|---|---|---|---|
| ChatDatabricks | databricks-langchain | beta |
模型功能
支持的方法
ChatDatabricks 支持 ChatModel 的所有方法,包括异步 API。
端点要求
ChatDatabricks 封装的服务端点必须具有与 OpenAI 兼容的聊天输入/输出格式(参考)。只要输入格式兼容,ChatDatabricks 就可以用于托管在 Databricks Model Serving 上的任何类型的端点:
- 基础模型(Foundation Models)- 精选的最先进基础模型列表,如 DBRX、Llama3、Mixtral-8x7B 等。这些端点在您的 Databricks 工作区中无需任何设置即可使用。
- 自定义模型(Custom Models)- 您也可以通过 MLflow 使用自选框架(如 LangChain、Pytorch、Transformers 等)将自定义模型部署到服务端点。
- 外部模型(External Models)- Databricks 端点可以作为代理为托管在 Databricks 之外的模型提供服务,例如 OpenAI GPT4 等专有模型服务。
安装配置
要访问 Databricks 模型,您需要创建 Databricks 账户、设置凭据(仅在 Databricks 工作区之外时需要),并安装所需的包。凭据(仅在 Databricks 工作区之外时需要)
如果您在 Databricks 内部运行 LangChain 应用,可以跳过此步骤。 否则,您需要手动将 Databricks 工作区主机名和个人访问令牌分别设置到DATABRICKS_HOST 和 DATABRICKS_TOKEN 环境变量中。有关如何获取访问令牌,请参阅身份验证文档。
安装
LangChain Databricks 集成位于databricks-langchain 包中。
ChatDatabricks 查询托管为基础模型端点的 DBRX-instruct 模型。
对于其他类型的端点,端点本身的设置方式有所不同,但一旦端点就绪,使用 ChatDatabricks 进行查询的方式没有区别。请参阅本 notebook 底部的其他类型端点示例。
实例化
调用
链式调用
与其他聊天模型类似,ChatDatabricks 可以作为复杂链的一部分使用。
流式调用
异步调用
工具调用
ChatDatabricks 支持与 OpenAI 兼容的工具调用 API,该 API 允许您描述工具及其参数,并让模型返回包含要调用的工具及其输入的 JSON 对象。工具调用对于构建使用工具的链和代理以及从模型获取结构化输出非常有用。 使用ChatDatabricks.bind_tools,我们可以轻松地将 Pydantic 类、dict 模式、LangChain 工具甚至函数作为工具传递给模型。在底层,这些工具会被转换为 OpenAI 兼容的工具模式,格式如下:
封装自定义模型端点
前提条件:- 一个 LLM 已通过 MLflow 注册并部署到 Databricks 服务端点。该端点必须具有 OpenAI 兼容的聊天输入/输出格式(参考)
- 您对该端点具有”Can Query”权限。
封装外部模型
前提条件:创建代理端点 首先,创建一个新的 Databricks 服务端点,将请求代理到目标外部模型。代理外部模型的端点创建速度相当快。 这需要在 Databricks 密钥管理器中注册您的 OpenAI API 密钥,如下所示:Databricks 上的函数调用
Databricks 函数调用与 OpenAI 兼容,仅在作为 Foundation Model API 的一部分提供模型服务时可用。 有关支持的模型,请参阅 Databricks 函数调用介绍。API 参考
有关 ChatDatabricks 所有功能和配置的详细文档,请参阅 API 参考:api-docs.databricks.com/python/databricks-ai-bridge/latest/databricks_langchain.html#databricks_langchain.ChatDatabricks将这些文档连接 到 Claude、VSCode 等,通过 MCP 获取实时解答。

