> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-docs-zh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# (MODULE_NAME) 集成

> 集成 (MODULE_NAME) 工具，使用 LangChain Python。

***

如何使用此Python工具模板：

* [ ] 将 (MODULE\_NAME) 替换为工具名称（`command + F` 是你的好帮手）
* [ ] 更新链接指向正确工具
* [ ] 在详细信息和功能表格下，更新 ✅/❌ 以反映工具的实际功能
* [ ] 如需，更新PyPI/注册表包名
* [ ] 如需，更新API密钥环境变量名称

模板从本行下方开始...

本指南为快速入门提供了 (MODULE\_NAME) [工具](https://langchain-docs-zh.mintlify.site/langchain/oss/langchain/tools.md) 的概述。要查看所有 (MODULE\_NAME) 功能、参数和配置的详细列表，请访问 [(MODULE\_NAME) API参考](LINK)。

## 概述

### 细节

\| 类别 | 包 | 可序列化 | [JS支持](https://langchain-docs-zh.mintlify.site/langchain/oss/javascript/integrations/chat/anthropic.md) | 下载量 | 版本 |
\| :--- | :--- | :---: | :---: |  :---: | :---: | :---: |
\| [(MODULE\_NAME)](LINK) | [langchain-(MODULE\_NAME)](LINK) | beta/❌ | ✅/❌ | ![PyPI - 下载量](https://img.shields.io/pypi/dm/langchain-\(MODULE_NAME\)?style=flat-square\&label=%20) | ![PyPI - 版本](https://img.shields.io/pypi/v/langchain-\(MODULE_NAME\)?style=flat-square\&label=%20) |

### 功能

* 列出功能。如需添加图标，请自行添加！

***

## 设置

要访问 (MODULE\_NAME) 工具，你需要创建一个/an (MODULE\_NAME) 账户，获取API密钥，并安装 `langchain-(MODULE_NAME)` 集成包。

### 凭据

```python Set API key icon="key" theme={null}
import getpass
import os

if "(MODULE_NAME)_API_KEY" not in os.environ:
    os.environ["(MODULE_NAME)_API_KEY"] = getpass.getpass("Enter your (MODULE_NAME) API key: ")
```

为获得最佳观测/追踪 (Log each step of a model's execution to debug and improve it)效果，建议（但非必需）配置LangSmith。要启用自动追踪，设置 [LangSmith](https://docs.langchain.com/langsmith/observability) API密钥：

```python Enable tracing icon="flask" theme={null}
os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")
os.environ["LANGSMITH_TRACING"] = "true"
```

### 安装

该 (MODULE\_NAME) 工具位于 `langchain-(MODULE_NAME)` 包中：

```python pip theme={null}
pip install -U langchain-(MODULE_NAME)
```

```python uv theme={null}
uv add langchain-(MODULE_NAME)
```

***

## 实例化

现在可以使用以下方式实例化 (MODULE\_NAME) 工具：

```python Initialize tool instance icon="robot" theme={null}
from langchain_(MODULE_NAME) import (MODULE_NAME)

tool = (MODULE_NAME)(...)
```

***

## 调用

### 直接调用

TODO: 描述工具参数并填充内容

```python Call tool icon="rocket" theme={null}
tool.invoke({...})
```

### 作为ToolCall

我们也可以通过模型生成的 `ToolCall` 调用工具，此时会返回 @@\[`ToolMessage`]：

```python ToolCall icon="briefcase" theme={null}
# This is usually generated by a model, but we'll create a tool call directly for demo purposes.
model_generated_tool_call = {
    "args": {...},  # TODO: FILL IN
    "id": "1",
    "name": tool.name,
    "type": "tool_call",
}
tool.invoke(model_generated_tool_call)
```

### 在智能体中

我们可以在智能体中使用该工具。为此需要具备工具调用能力的模型。

```python Agent with tool icon="robot" theme={null}
# pip install -qU "langchain[anthropic]" to call the model
from langchain.agents import create_agent

tools = [tool]
agent = create_agent(
    model="claude-sonnet-4-6",
    tools=tools,
)

# Run the agent
agent.invoke(
    {"messages": [{"role": "user", "content": "INSERT QUERY"}]}
)
```

***

## TODO: 工具特定功能

如不相关则删除。

参考现有工具文档示例，例如：

* [MCP工具箱](https://langchain-docs-zh.mintlify.site/langchain/oss/python/integrations/tools/mcp_toolbox.md)
* [Discord](https://langchain-docs-zh.mintlify.site/langchain/oss/python/integrations/tools/discord.md)
*

***

## API参考

要查看 (MODULE\_NAME) 所有功能及配置的详细文档，请访问 [API参考](LINK)。

***

> 官方原文：[src/oss/python/integrations/tools/TEMPLATE.mdx](https://github.com/langchain-ai/docs/blob/main/src/oss/python/integrations/tools/TEMPLATE.mdx) · 非官方翻译，译文由 AI 生成，以英文原文为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.