WatsonxLLM updates/enhancements (#14598)

- **Description:** updates/enhancements to IBM
[watsonx.ai](https://www.ibm.com/products/watsonx-ai) LLM provider
(prompt tuned models and prompt templates deployments support)
- **Dependencies:**
[ibm-watsonx-ai](https://pypi.org/project/ibm-watsonx-ai/),
  - **Tag maintainer:** : @hwchase17 , @eyurtsev , @baskaryan 
  - **Twitter handle:** details in comment below.

Please make sure your PR is passing linting and testing before
submitting. Run `make format`, `make lint` and `make test` to check this
locally. ✅

---------

Co-authored-by: Harrison Chase <hw.chase.17@gmail.com>

docs/docs/integrations/llms/watsonxllm.ipynb

@@ -5,9 +5,9 @@
    "id": "70996d8a",
    "metadata": {},
    "source": [
-    "# WatsonxLLM\n",
+    "# IBM watsonx.ai\n",
     "\n",
-    "[WatsonxLLM](https://ibm.github.io/watson-machine-learning-sdk/fm_extensions.html) is wrapper for IBM [watsonx.ai](https://www.ibm.com/products/watsonx-ai) foundation models.\n",
+    "[WatsonxLLM](https://ibm.github.io/watsonx-ai-python-sdk/fm_extensions.html#langchain) is a wrapper for IBM [watsonx.ai](https://www.ibm.com/products/watsonx-ai) foundation models.\n",
     "This example shows how to communicate with watsonx.ai models using LangChain."
    ]
   },
@@ -16,7 +16,7 @@
    "id": "ea35b2b7",
    "metadata": {},
    "source": [
-    "Install the package [`ibm_watson_machine_learning`](https://ibm.github.io/watson-machine-learning-sdk/install.html)."
+    "Install the package [`ibm-watsonx-ai`](https://ibm.github.io/watsonx-ai-python-sdk/install.html)."
    ]
   },
   {
@@ -26,7 +26,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%pip install ibm_watson_machine_learning"
+    "%pip install ibm-watsonx-ai"
    ]
   },
   {
@@ -60,7 +60,7 @@
    "metadata": {},
    "source": [
     "## Load the model\n",
-    "You might need to adjust model `parameters` for different models or tasks, to do so please refer to [documentation](https://ibm.github.io/watson-machine-learning-sdk/model.html#metanames.GenTextParamsMetaNames)."
+    "You might need to adjust model `parameters` for different models or tasks. For details, refer to [documentation](https://ibm.github.io/watsonx-ai-python-sdk/fm_model.html#metanames.GenTextParamsMetaNames)."
    ]
   },
   {
@@ -70,7 +70,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from ibm_watson_machine_learning.metanames import GenTextParamsMetaNames as GenParams\n",
+    "from ibm_watsonx_ai.metanames import GenTextParamsMetaNames as GenParams\n",
     "\n",
     "parameters = {\n",
     "    GenParams.DECODING_METHOD: \"sample\",\n",
@@ -87,7 +87,15 @@
    "id": "2b586538",
    "metadata": {},
    "source": [
-    "Initialize the `WatsonxLLM` class with previous set params."
+    "Initialize the `WatsonxLLM` class with previously set parameters.\n",
+    "\n",
+    "\n",
+    "**Note**: \n",
+    "\n",
+    "- To provide context for the API call, you must add `project_id` or `space_id`. For more information see [documentation](https://www.ibm.com/docs/en/watsonx-as-a-service?topic=projects).\n",
+    "- Depending on the region of your provisioned service instance, use one of the urls described [here](https://ibm.github.io/watsonx-ai-python-sdk/setup_cloud.html#authentication).\n",
+    "\n",
+    "In this example, we’ll use the `project_id` and Dallas url."
    ]
   },
   {
@@ -102,7 +110,7 @@
     "watsonx_llm = WatsonxLLM(\n",
     "    model_id=\"google/flan-ul2\",\n",
     "    url=\"https://us-south.ml.cloud.ibm.com\",\n",
-    "    project_id=\"***\",\n",
+    "    project_id=\"PASTE YOUR PROJECT_ID HERE\",\n",
     "    params=parameters,\n",
     ")"
    ]
@@ -112,19 +120,49 @@
    "id": "2202f4e0",
    "metadata": {},
    "source": [
-    "Alternatively you can use Cloud Pak for Data credentials. For details, see [documentation](https://ibm.github.io/watson-machine-learning-sdk/setup_cpd.html).\n",
-    "```\n",
+    "Alternatively you can use Cloud Pak for Data credentials. For details, see [documentation](https://ibm.github.io/watsonx-ai-python-sdk/setup_cpd.html).    "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "243ecccb",
+   "metadata": {},
+   "outputs": [],
+   "source": [
     "watsonx_llm = WatsonxLLM(\n",
-    "    model_id='google/flan-ul2',\n",
-    "    url=\"***\",\n",
-    "    username=\"***\",\n",
-    "    password=\"***\",\n",
+    "    model_id=\"google/flan-ul2\",\n",
+    "    url=\"PASTE YOUR URL HERE\",\n",
+    "    username=\"PASTE YOUR USERNAME HERE\",\n",
+    "    password=\"PASTE YOUR PASSWORD HERE\",\n",
     "    instance_id=\"openshift\",\n",
     "    version=\"4.8\",\n",
-    "    project_id='***',\n",
-    "    params=parameters\n",
-    ")\n",
-    "```        "
+    "    project_id=\"PASTE YOUR PROJECT_ID HERE\",\n",
+    "    params=parameters,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "96ed13d4",
+   "metadata": {},
+   "source": [
+    "Instead of `model_id`, you can also pass the `deployment_id` of the previously tuned model. The entire model tuning workflow is described [here](https://ibm.github.io/watsonx-ai-python-sdk/pt_working_with_class_and_prompt_tuner.html)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "08e66c88",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "watsonx_llm = WatsonxLLM(\n",
+    "    deployment_id=\"PASTE YOUR DEPLOYMENT_ID HERE\",\n",
+    "    url=\"https://us-south.ml.cloud.ibm.com\",\n",
+    "    project_id=\"PASTE YOUR PROJECT_ID HERE\",\n",
+    "    params=parameters,\n",
+    ")"
    ]
   },
   {
@@ -187,7 +225,7 @@
    "metadata": {},
    "source": [
     "## Calling the Model Directly\n",
-    "To obtain completions, you can can the model directly using string prompt."
+    "To obtain completions, you can call the model directly using a string prompt."
    ]
   },
   {