Recipe: WatsonX Registration and Project Creation

[fayvor]

Document the WatsonX setup process.

• Get IBM id from IBM Cloud
• Create a user api key. This is for cloud process communication; you can't see it.
• Go to watsonx.ai and log in
• Create a project
• Get the project_id; set it in your env as WATSONX_PROJECT_ID
• Create an api key at https://cloud.ibm.com/iam/apikeys; set it in your env as WATSONX_APIKEY
• Note the cloud region
• Get the URL for your cloud region; set it in your env as WATSONX_URL

[fayvor]

Additional instructions may be found in this issue description.

1. Sign up for a new WatsonX Account with the free ("Lite") plan
2. Add WatsonX Machine Learning "Lite" plan
3. Create a User API Key
4. Add Watson Machine Learning service (Watsonx -> Projects -> Manage -> Services & Integrations -> Add Service (see https://youtu.be/3sav6vUG_XQ?t=278)
5. Create an Instance API Key and save the key (IBM Cloud > Manage (top bar) > Access(IAM) > Manage identities (left nav) > API keys
6. Create a Project and get its project id from the projects page > [Select Project] > Manage > General > Details
7. Add the following env vars to the utils and granite-code-cookbook repos: WATSONX_APIKEY: the api key (not the key id, which starts with ApiKey) WATSONX_URL: probably "https://us-south.ml.cloud.ibm.com/", the Dallas region WATSONX_PROJECT_ID: the project id

[fayvor]

This recipe has some good instructions: https://github.com/ibm-granite-community/granite-snack-cookbook/blob/c5d99aecd3d591dc0df5b81678e74bb87696c9ce/recipes/Function-Calling/Function_Calling.ipynb

@AnnaGutowska I removed some of your WatsonX instructions from the Function_Calling recipe, but it would be good to have them in the WatsonX recipe. This ticket captures that work.