chore; cleanup

Author: ddebrunner

ai/README.md

@@ -13,3 +13,4 @@ Articles:
 Snippets:
 
 - [Prescribed tools](../executable/prescribed/) - Demonstrates creation of MCP tools from persisted GraphQL operations.
+- [watsonx.AI generation](watsonxai-generation/) - Demonstrates invoking an LLM through watsonx.AI

ai/watsonxai-generation/README.md

@@ -1,20 +1,30 @@
-# Watsonx.AI generation.
+# watsonx.ai generation.
 
 ## Overview
 
-Creates a field `Query.wxai_generation` that invokes a Watsonx.AI generation endpoint to infer the next text from an input.
+Creates a field `Query.wxai_generation` that invokes a watsonx.ai generation endpoint to infer the next text from an input.
 
 This provides a simple example of calling an LLM from a GraphQL endpoint.
 
 An IBM Cloud IAM token is used for authorization, taken from the [ibm-iam snippet](../../rest/ibm-iam/).
 
 ## Try it out
 
-Deploy the schema with this values set in `.env` for your Watsonx.AI project.
+### Deploying
 
+Deploy the schema with this values set in `.env` for your watsonx.ai project.
+
+```
 STEPZEN_IBM_IAM_APIKEY=
 STEPZEN_WATSONXAI_URL=
 STEPZEN_WATSONXAI_PROJECTID=
+```
+
+These can be obtained from the watsonx dashboard:
+
+<img width="362" height="452" alt="image" src="https://github.com/user-attachments/assets/1eaa1671-2e2c-4a34-8ae7-1fd42ce9887e" />
+
+### Sample request
 
 Then you can use `stepzen request` and the provided operation to ask simple questions:
 

ai/watsonxai-generation/watsonx-ai.graphql

@@ -78,7 +78,7 @@ input WXAI_GenerationParameters {
 }
 
 """
-Response of IBM Generative AI watsonx.ai `generation` endpoint
+Response of IBM watsonx.ai `generation` endpoint
 """
 type WXAI_GenerationResponse {
   created_at: DateTime
@@ -88,7 +88,7 @@ type WXAI_GenerationResponse {
 }
 
 """
-A result in the response of IBM Generative AI watsonx.ai `generation` endpoint
+A result in the response of IBM watsonx.ai `generation` endpoint
 """
 type WXAI_GenerationResult {
   generated_text: String