ChatDeepSeek

这将帮助您开始使用 DeepSeek 的托管 chat models。有关所有 ChatDeepSeek 功能和配置的详细文档，请参阅 API reference。

tip

DeepSeek 的模型是开源的，也可以在本地运行（例如在 Ollama 中）或在其他推理提供商上运行（例如 Fireworks、Together）。

概述

集成详情

Class	Package	Local	Serializable	JS support	Package downloads	Package latest
ChatDeepSeek	langchain-deepseek	❌	beta	✅

模型特性

Tool calling	Structured output	JSON mode	Image input	Audio input	Video input	Token-level streaming	Native async	Token usage	Logprobs
✅	✅	❌	❌	❌	❌	✅	✅	✅	❌

note

DeepSeek-R1（通过 model="deepseek-reasoner" 指定）不支持工具调用或结构化输出。DeepSeek-V3（通过 model="deepseek-chat" 指定）支持 这些功能。

设置

要访问 DeepSeek 模型，您需要创建一个 DeepSeek 账户，获取 API 密钥，并安装 langchain-deepseek 集成包。

凭证

前往 DeepSeek's API Key page 来注册 DeepSeek 并生成 API 密钥。完成此操作后，设置 DEEPSEEK_API_KEY 环境变量：

import getpass
import os

if not os.getenv("DEEPSEEK_API_KEY"):
    os.environ["DEEPSEEK_API_KEY"] = getpass.getpass("Enter your DeepSeek API key: ")

为启用模型调用的自动追踪，请设置您的 LangSmith API 密钥：

# os.environ["LANGSMITH_TRACING"] = "true"
# os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")

安装

LangChain DeepSeek 集成位于 langchain-deepseek 包中：

%pip install -qU langchain-deepseek

实例化

现在我们可以实例化我们的模型对象并生成聊天补全：

from langchain_deepseek import ChatDeepSeek

llm = ChatDeepSeek(
    model="deepseek-chat",
    temperature=0,
    max_tokens=None,
    timeout=None,
    max_retries=2,
    # other params...
)

API Reference:ChatDeepSeek

调用

messages = [
    (
        "system",
        "You are a helpful assistant that translates English to French. Translate the user sentence.",
    ),
    ("human", "I love programming."),
]
ai_msg = llm.invoke(messages)
ai_msg.content

链式调用

我们可以按以下方式将模型与提示模板进行链式调用：

from langchain_core.prompts import ChatPromptTemplate

prompt = ChatPromptTemplate(
    [
        (
            "system",
            "You are a helpful assistant that translates {input_language} to {output_language}.",
        ),
        ("human", "{input}"),
    ]
)

chain = prompt | llm
chain.invoke(
    {
        "input_language": "English",
        "output_language": "German",
        "input": "I love programming.",
    }
)

API Reference:ChatPromptTemplate

API 参考

有关 ChatDeepSeek 的所有功能和配置的详细文档，请访问 API 参考。

Related

• Chat model conceptual guide
• Chat model how-to guides