The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
community[tool]: Integrate a tool for the naver_search (#30392)
Changyong Ume2d9fe766f5e
diff --git a/docs/docs/integrations/providers/naver.mdx b/docs/docs/integrations/providers/naver.mdxindex b9f6a1ca7f..a64b41734a 100644--- a/docs/docs/integrations/providers/naver.mdx+++ b/docs/docs/integrations/providers/naver.mdx@@ -12,10 +12,15 @@ Please refer to [NCP User Guide](https://guide.ncloud-docs.com/docs/clovastudio-- Get a CLOVA Studio API Key by [issuing it](https://api.ncloud-docs.com/docs/ai-naver-clovastudio-summary#API%ED%82%A4) and set it as an environment variable (`NCP_CLOVASTUDIO_API_KEY`).- If you are using a legacy API Key (that doesn't start with `nv-*` prefix), you might need to get an additional API Key by [creating your app](https://guide.ncloud-docs.com/docs/en/clovastudio-playground01#create-test-app) and set it as `NCP_APIGW_API_KEY`.-- Install the integration Python package with:++Naver integrations live in two packages:++- `langchain-naver-community`: a dedicated integration package for Naver. It is a community-maintained package and is not officially maintained by Naver or LangChain.+- `langchain-community`: a collection of [third-party integrations](https://python.langchain.com/docs/concepts/architecture/#langchain-community),+including Naver. **New features should be implemented in the dedicated `langchain-naver-community` package**.```bash-pip install -U langchain-community+pip install -U langchain-community langchain-naver-community```## Chat models@@ -36,4 +41,42 @@ See a [usage example](/docs/integrations/text_embedding/naver).```pythonfrom langchain_community.embeddings import ClovaXEmbeddings-```\ No newline at end of file+```++## Tools++### Naver Search++The Naver Search integration allows your LangChain applications to retrieve information from Naver's search engine. This is particularly useful for Korean language queries and getting up-to-date information about Korean topics.++To use the Naver Search tools, you need to:++1. Sign in to the [Naver Developers portal](https://developers.naver.com/main/)+2. Create a new application and enable the Search API+3. Obtain your **NAVER_CLIENT_ID** and **NAVER_CLIENT_SECRET** from the "Application List" section+4. Set these as environment variables in your application++```python+from langchain_naver_community.tool import NaverSearchResults+from langchain_naver_community.utils import NaverSearchAPIWrapper++# Set up the search wrapper+search = NaverSearchAPIWrapper()++# Create a tool+tool = NaverSearchResults(api_wrapper=search)+```++See a [usage example](/docs/integrations/tools/naver_search) for more details.++### Specialized Search Tools++The package also provides specialized search tools for different types of content:++```python+from langchain_naver_community.tool import NaverNewsSearch # For news articles+from langchain_naver_community.tool import NaverBlogSearch # For blog posts+from langchain_naver_community.tool import NaverImageSearch # For images+```++Each of these can be used within LangChain agents to provide more targeted search capabilities.diff --git a/docs/docs/integrations/tools/naver_search.ipynb b/docs/docs/integrations/tools/naver_search.ipynbnew file mode 100644index 0000000000..969a6c2854--- /dev/null+++ b/docs/docs/integrations/tools/naver_search.ipynb@@ -0,0 +1,262 @@+{+ "cells": [+ {+ "cell_type": "markdown",+ "id": "245a954a",+ "metadata": {},+ "source": [+ "# Naver Search\n",+ "\n",+ "## Overview\n",+ "\n",+ "### Integration details\n",+ "\n",+ "| Class | Package | Serializable | JS support | Package latest |\n",+ "| :--- | :--- | :---: | :---: | :---: |\n",+ "| NaverSearchResults | [langchain-naver-community](https://pypi.org/project/langchain-naver-community/) | ❌ | ❌ |  |\n",+ "\n",+ "### Tool features\n",+ "\n",+ "**Search** : The Naver Search Tool provides a simple interface to search Naver and get results.\n",+ "\n",+ "## Setup\n",+ "### Setting Up API Credentials\n",+ "To use Naver Search, you need to obtain API credentials. Follow these steps:\n",+ "\n",+ "Sign in to the [Naver Developers portal](https://developers.naver.com/main/).\n",+ "Create a new application and enable the Search API.\n",+ "Obtain your **NAVER_CLIENT_ID** and **NAVER_CLIENT_SECRET** from the \"Application List\" section.\n",+ "\n",+ "### Setting Up Environment Variables\n",+ "After obtaining the credentials, set them as environment variables in your script:"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "a2998f9c",+ "metadata": {},+ "outputs": [],+ "source": [+ "%pip install --upgrade --quiet langchain-naver-community"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 2,+ "id": "30692b20",+ "metadata": {},+ "outputs": [],+ "source": [+ "import getpass\n",+ "import os\n",+ "\n",+ "if not os.environ.get(\"NAVER_CLIENT_ID\"):\n",+ " os.environ[\"NAVER_CLIENT_ID\"] = getpass.getpass(\"Enter your Naver Client ID:\\n\")\n",+ "\n",+ "if not os.environ.get(\"NAVER_CLIENT_SECRET\"):\n",+ " os.environ[\"NAVER_CLIENT_SECRET\"] = getpass.getpass(\n",+ " \"Enter your Naver Client Secret:\\n\"\n",+ " )"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "c43917d5",+ "metadata": {},+ "source": [+ "## Instantiation"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "3d2be578",+ "metadata": {},+ "outputs": [],+ "source": [+ "from langchain_naver_community.utils import NaverSearchAPIWrapper\n",+ "\n",+ "search = NaverSearchAPIWrapper()"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "c97b3f7a",+ "metadata": {},+ "source": [+ "## Invocation"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 5,+ "id": "ac4910f8",+ "metadata": {},+ "outputs": [+ {+ "data": {+ "text/plain": [+ "[{'title': 'Seoul shares rise for 4th day on tech gains; won at 2-week low',\n",+ " 'link': 'https://n.news.naver.com/mnews/article/001/0015277717?sid=104',\n",+ " 'description': 'stocks-summary Seoul shares rise for 4th day on tech gains; won at 2-week low SEOUL, March 20 (Yonhap) -- Seoul shares extended their winning streak to a fourth day Thursday on the back of gains... ',\n",+ " 'pubDate': 'Thu, 20 Mar 2025 16:09:00 +0900'},\n",+ " {'title': \"Seoul Mayor Oh's residence, office raided over alleged ties to shadowy po...\",\n",+ " 'link': 'https://n.news.naver.com/mnews/article/640/0000067073?sid=100',\n",+ " 'description': 'Prosecutors on Thursday raided Seoul Mayor Oh Se-hoon’s official residence and the City Hall... The raid came as part of the Seoul Central District Prosecutors’ Office’s probe into... ',\n",+ " 'pubDate': 'Thu, 20 Mar 2025 19:12:00 +0900'},\n",+ " {'title': 'Education can heal divides: Seoul schools chief',\n",+ " 'link': 'https://n.news.naver.com/mnews/article/044/0000267866?sid=104',\n",+ " 'description': 'Jung Keun-sik, Superintendent of Seoul Metropolitan Office of Education speaks during an interview with The Korea Herald at his office on March 13. (Lim Se-jun/ The Korea Herald) Seoul education... ',\n",+ " 'pubDate': 'Thu, 20 Mar 2025 14:35:00 +0900'}]"+ ]+ },+ "execution_count": 5,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "search.results(\"Seoul\")[:3]"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "2511982a",+ "metadata": {},+ "source": [+ "## Tool Usage"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 19,+ "id": "e17126e7",+ "metadata": {},+ "outputs": [+ {+ "data": {+ "text/plain": [+ "[{'title': \"2025 is here. Here's what to watch out for\",\n",+ " 'link': 'https://n.news.naver.com/mnews/article/044/0000265707?sid=104',\n",+ " 'description': 'The trend was predicted in "Trend Korea 2025," written by Kim Ran-do, a professor of consumer science at Seoul National University, and his team. The annually published book also predicts that... ',\n",+ " 'pubDate': 'Sat, 18 Jan 2025 16:01:00 +0900'},\n",+ " {'title': '[INTERVIEW] Korea to overhaul weather prediction model against climate ch...',\n",+ " 'link': 'https://www.koreatimes.co.kr/www/nation/2023/06/371_353628.html?utm_source=na',\n",+ " 'description': 'western Seoul to protest its confusing weather predictions, false forecasting is hardly accepted compared to what Yoo saw in Oklahoma. The administrator hopes the Korean public would understand... ',\n",+ " 'pubDate': 'Sun, 25 Jun 2023 17:22:00 +0900'}]"+ ]+ },+ "execution_count": 19,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "from langchain_naver_community.tool import NaverSearchResults\n",+ "from langchain_naver_community.utils import NaverSearchAPIWrapper\n",+ "\n",+ "search = NaverSearchAPIWrapper()\n",+ "\n",+ "tool = NaverSearchResults(api_wrapper=search)\n",+ "\n",+ "tool.invoke(\"what is the weather in seoul?\")[3:5]"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "74295cb5",+ "metadata": {},+ "source": [+ "## Use within an agent\n",+ "\n",+ "The Naver Search tool can be integrated into LangChain agents for more complex tasks. Below we demonstrate how to set up an agent that can search Naver for current information.\n"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "386e19b0",+ "metadata": {},+ "outputs": [],+ "source": [+ "from langchain_openai import ChatOpenAI\n",+ "\n",+ "llm = ChatOpenAI(model=\"gpt-4o-mini\")\n",+ "\n",+ "system_prompt = \"\"\"\n",+ "You are a helpful assistant that can search the web for information.\n",+ "\"\"\""+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "70da8682",+ "metadata": {},+ "outputs": [],+ "source": [+ "from langchain_naver_community.tool import NaverNewsSearch\n",+ "from langgraph.prebuilt import create_react_agent\n",+ "\n",+ "tools = [NaverNewsSearch()]\n",+ "\n",+ "agent_executor = create_react_agent(\n",+ " llm,\n",+ " tools,\n",+ " prompt=system_prompt,\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "4b73dbaf",+ "metadata": {},+ "source": [+ "Now we can run the agent with a query."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "726e575a",+ "metadata": {},+ "outputs": [],+ "source": [+ "query = \"What is the weather in Seoul?\"\n",+ "result = agent_executor.invoke({\"messages\": [(\"human\", query)]})\n",+ "result[\"messages\"][-1].content"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "d566a4c0",+ "metadata": {},+ "source": [+ "## API reference\n",+ "\n"+ ]+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": "Python 3",+ "language": "python",+ "name": "python3"+ },+ "language_info": {+ "codemirror_mode": {+ "name": "ipython",+ "version": 3+ },+ "file_extension": ".py",+ "mimetype": "text/x-python",+ "name": "python",+ "nbconvert_exporter": "python",+ "pygments_lexer": "ipython3",+ "version": "3.11.10"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 5+}diff --git a/libs/packages.yml b/libs/packages.ymlindex 1e597e938b..b3d79811c2 100644--- a/libs/packages.yml+++ b/libs/packages.yml@@ -546,3 +546,8 @@ packages:provider_page: zoterodownloads: 153downloads_updated_at: '2025-03-22T21:59:15.663971+00:00'+- name: langchain-naver-community+ name_title: Naver+ provider_page: naver+ path: .+ repo: e7217/langchain-naver-community