> ## Documentation Index > Fetch the complete documentation index at: https://docs.langchain.com/llms.txt > Use this file to discover all available pages before exploring further. # WatsonxToolkit integration > Integrate with the WatsonxToolkit tool using LangChain JavaScript. This will help you getting started with `WatsonxToolkit` [toolkits](/oss/javascript/concepts/#toolkits). For detailed documentation of all `WatsonxToolkit` features and configurations head to the [API reference](https://reference.langchain.com/javascript/langchain-ibm/WatsonxToolkit). The toolkit contains following tools: | Name | Description | | -------------- | ------------------------------------------------------------------------------------------ | | `GoogleSearch` | Search for online trends, news, current events, real-time information, or research topics. | | `WebCrawler` | Useful for when you need to summarize a webpage. Do not use for Web search. | | `SDXLTurbo` | Generate an image from text using Stability.ai | | `Weather` | Find the weather for a city. | | `RAGQuery` | Search the documents in a vector index. | ### Integration details | Class | Package | [PY support](https://python.langchain.com/docs/integrations/tools/ibm_watsonx/) | Version | | :------------------------------------------------------------------------------------------ | :--------------------------------------------------------------- | :-----------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------: | | [`WatsonxToolkit`](https://reference.langchain.com/javascript/langchain-ibm/WatsonxToolkit) | [`@langchain/ibm`](https://www.npmjs.com/package/@langchain/ibm) | ✅ | ![NPM - Version](https://img.shields.io/npm/v/@langchain/ibm?style=flat-square\&label=%20&) | ## Setup If you want to get automated tracing from runs of individual tools, set your [LangSmith](/langsmith/observability) API key: ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} export LANGSMITH_TRACING="true" export LANGSMITH_API_KEY="your-api-key" ``` ### Installation This toolkit lives in the `@langchain/ibm` package: See [this section for general instructions on installing LangChain packages](/oss/javascript/langchain/install). ```bash npm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} npm install @langchain/ibm @langchain/core ``` ```bash yarn theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} yarn add @langchain/ibm @langchain/core ``` ```bash pnpm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} pnpm add @langchain/ibm @langchain/core ``` ## Instantiation Now we can instantiate our toolkit: ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} import { WatsonxToolkit } from "@langchain/ibm"; import "dotenv/config" const toolkit = await WatsonxToolkit.init({ version: '2024-05-31', serviceUrl: process.env.WATSONX_AI_SERVICE_URL }); ``` ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} [Module: null prototype] { default: {} } ``` ## Tools View available tools: ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} const tools = toolkit.getTools(); console.log(tools.map((tool) => ({ name: tool.name, description: tool.description, }))) ``` ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} [ { name: "GoogleSearch", description: "Search for online trends, news, current events, real-time information, or research topics." }, { name: "WebCrawler", description: "Useful for when you need to summarize a webpage. Do not use for Web search." }, { name: "SDXLTurbo", description: "Generate an image from text using Stability.ai" }, { name: "Weather", description: "Find the weather for a city." }, { name: "RAGQuery", description: "Search the documents in a vector index." } ] ``` For detailed info about tools please visit [watsonx.ai API docs](https://cloud.ibm.com/apidocs/watsonx-ai#get-utility-agent-tools) ## Use within an agent Install the `langchain` package to use `createAgent`: ```bash npm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} npm install langchain @langchain/ibm @langchain/core ``` ```bash yarn theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} yarn add langchain @langchain/ibm @langchain/core ``` ```bash pnpm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} pnpm add langchain @langchain/ibm @langchain/core ``` Then, instantiate your LLM to be used in the agent: ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} import { ChatWatsonx } from "@langchain/ibm"; const llm = new ChatWatsonx({ version: '2024-05-31', serviceUrl: process.env.WATSONX_AI_SERVICE_URL, model: 'ibm/granite-3-8b-instruct', projectId: process.env.WATSONX_AI_PROJECT_ID }); ``` ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} import { createAgent } from "langchain"; const agent = createAgent({ model: llm, tools }); ``` ```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} const exampleQuery = "Who won F1 championship in 2022?" const stream = await agent.streamEvents( { messages: [{ role: "user", content: exampleQuery }] }, { version: "v3" }, ); for await (const snapshot of stream.values) { const lastMsg = snapshot.messages[snapshot.messages.length - 1]; if (lastMsg.tool_calls?.length) { console.dir(lastMsg.tool_calls, { depth: null }); } else if (lastMsg.content) { console.log(lastMsg.content); } } ``` ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} Who won F1 championship in 2022? [ { name: "GoogleSearch", args: { input: "F1 championship 2022" }, type: "tool_call", id: "chatcmpl-tool-9da3456b9bbc475fb822296fdb8353a8" } ] [{"title":"2022 DRIVER STANDINGS","description":"Official F1® Race Programme · Modern Slavery Statement; Do Not Sell or Share My Personal Information. Formula 1. © 2003-2025 Formula One World Championship ...","url":"https://www.formula1.com/en/results/2022/drivers"},{"title":"2022 Formula One World Championship - Wikipedia","description":"2022 Formula One World Championship · Max Verstappen won his second consecutive World Drivers' Championship driving for Red Bull Racing. · Charles Leclerc ...","url":"https://en.wikipedia.org/wiki/2022_Formula_One_World_Championship"},{"title":"2022 Formula One World Championship - Simple English Wikipedia ...","description":"Max Verstappen, who was the reigning Drivers' Champion, claimed his second title at the Japanese Grand Prix, while his team, Red Bull Racing, achieved their ...","url":"https://simple.wikipedia.org/wiki/2022_Formula_One_World_Championship"},{"title":"Max Verstappen wins the 2022 F1 Drivers World Championship : r ...","description":"Oct 9, 2022 ... One day this guy will win a championship just by finishing the race and celebrating with a world championship lap on the day he won.","url":"https://www.reddit.com/r/sports/comments/xzg8pf/max_verstappen_wins_the_2022_f1_drivers_world/"},{"title":"Red Bull Simulator Championship Edition | F1 Authentics","description":"Based on the livery of the 2022 Oracle Red Bull Racing Championship-winning RB18, this F1 simulator has been expertly engineered and manufactured by Memento ...","url":"https://www.f1authentics.com/products/red-bull-simulator-championship-edition"},{"title":"F1 2022 Drivers Championship without Max Verstappen : r/formula1","description":"Nov 26, 2022 ... 1.1K votes, 65 comments. 5.2M subscribers in the formula1 community. Welcome to r/Formula1, the best independent online Formula 1 community!","url":"https://www.reddit.com/r/formula1/comments/z5cwl7/f1_2022_drivers_championship_without_max/"},{"title":"F1® Sim Racing World Championship 2022","description":"World Championship 2022 Bahrain International Circuit Bahrain International Circuit Race Distance: 29 laps Track Length: 5.412 km","url":"https://f1esports.com/world/results/2022"},{"title":"Our personal F1 2022 Predictions Championship : r/formula1","description":"May 5, 2022 ... F1 2025 Driver Predictions from mathematical model. Leclerc and Sainz predicted to beat Hamilton and Albon. r/formula1 - F1 2025 Driver ...","url":"https://www.reddit.com/r/formula1/comments/uitbbu/our_personal_f1_2022_predictions_championship/"},{"title":"Haas F1 Team Esports announces roster for 2022 F1 Esports Series ...","description":"Sep 13, 2022 ... Haas F1 Team is ready to commence battle in the 2022 F1 Esports Series Pro Championship featuring an updated line-up for this season.","url":"https://www.haasf1team.com/news/haas-f1-team-esports-announces-roster-2022-f1-esports-series-pro-championship"},{"title":"2022 F1 Deconstructors Championship : r/formula1","description":"Nov 22, 2022 ... Congratulations to our 2022 champion Carlos Sainz. Alonso put in a late surge but had to settle for second place. Alfa put in the best effort ...","url":"https://www.reddit.com/r/formula1/comments/z1pkkx/2022_f1_deconstructors_championship/"}] Max Verstappen won the 2022 F1 Championship, driving for Red Bull Racing. He claimed his second title at the Japanese Grand Prix. ``` *** ## API reference For detailed documentation of all `WatsonxToolkit` features and configurations head to the [API reference](https://reference.langchain.com/javascript/langchain-ibm/WatsonxToolkit). ***
[Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers. [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/oss/javascript/integrations/tools/ibm.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).