概述
集成详情
| 类 | 包 | 可序列化 | 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 对象。这对于构建使用工具的链和 Agent,以及从模型中获取结构化输出非常有用。 注意:在 CLOVA Studio 中使用工具调用功能时,应将max_tokens 设置为大于 1024 的值。
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 以 ft:{task_id} 的格式传递给 model 参数来调用微调模型。
您可以从相应测试应用或服务应用的详情中查看 task_id。
API 参考
有关 ChatClovaX 所有功能和配置的详细文档,请参阅 API 参考通过 MCP 将这些文档连接 到 Claude、VSCode 等,以获取实时答案。

