概览
集成详情
| 类别 | 包 | 本地 | 可序列化 | JS 支持 | 下载量 | 版本 |
|---|---|---|---|---|---|---|
| ChatClovaX | langchain-naver | ❌ | ❌ | ❌ |
模型功能
设置
在使用聊天模型之前,您必须完成以下四个步骤。- 创建 NAVER Cloud Platform 账户
- 申请使用 CLOVA Studio
- 创建一个 CLOVA Studio 测试应用或要使用的模型的服务应用(请参阅此处)。
- 颁发测试或服务 API 密钥(请参阅此处)。
凭据
使用您的 API 密钥设置CLOVASTUDIO_API_KEY 环境变量。 您可以将它们添加到您的环境变量中,如下所示:安装
LangChain Naver 集成位于langchain-naver 包中
实例化
现在我们可以实例化我们的模型对象并生成聊天完成调用
除了下面的invoke,ChatClovaX 还支持批处理、流处理及其异步功能。
流式处理
工具调用
CLOVA Studio 支持工具调用(也称为“函数调用”),它允许您描述工具及其参数,并让模型返回一个 JSON 对象,其中包含要调用的工具和该工具的输入。它对于构建使用工具的链和代理,以及更普遍地从模型获取结构化输出非常有用。 注意:您应该将max_tokens 设置为大于 1024,以利用 CLOVA Studio 中的工具调用功能。ChatClovaX.bind_tools()
通过ChatClovaX.bind_tools,我们可以轻松地将 Pydantic 类、字典模式、LangChain 工具甚至函数作为工具传递给模型。在底层,这些被转换为 OpenAI 兼容的工具模式,其形式如下:
AIMessage.tool_calls
请注意,AIMessage 具有tool_calls 属性。它以与模型提供商无关的标准化 ToolCall 格式包含此属性。
结构化输出
对于支持的模型,您可以使用结构化输出功能强制模型以特定结构(例如 Pydantic 模型、TypedDict 或 JSON)生成响应。 注意:结构化输出需要禁用思维模式。将thinking.effort 设置为 none。method 设置为 json_schema。
思维过程
对于支持的模型,当思维功能启用时(默认情况下),它将输出导致最终答案的逐步推理过程。 指定thinking 参数以控制该功能——启用或禁用思维过程并配置其深度。访问思维过程
当思维模式启用时,您可以通过AIMessage.additional_kwargs 中的 thinking_content 属性访问思维过程。
附加功能
使用微调模型
您可以通过将task_id 传递给 model 参数来调用微调模型,形式为:ft:{task_id}。 您可以从相应的测试应用或服务应用详细信息中查看 task_id。API 参考
有关所有 ChatClovaX 功能和配置的详细文档,请参阅 API 参考以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。