Small readme tweaks

Author: aabmass

samples/langgraph-sql-agent/README.md

@@ -10,19 +10,23 @@ initially empty. It is built with the the LangGraph prebuilt [ReAct
 Agent](https://langchain-ai.github.io/langgraph/agents/agents/#basic-configuration#code) and the
 [SQLDatabaseToolkit](https://python.langchain.com/docs/integrations/tools/sql_database/).
 
-## Permissions
+## APIs and Permissions
+
+Enable the relevant Cloud Observability APIs if they aren't already enabled.
+```sh
+gcloud services enable telemetry.googleapis.com logging.googleapis.com monitoring.googleapis.com cloudtrace.googleapis.com
+```
 
 This sample writes to Cloud Logging, Cloud Monitoring, and Cloud Trace. Grant yourself the
 following roles to run the example:
 - `roles/logging.logWriter` – see https://cloud.google.com/logging/docs/access-control#permissions_and_roles
 - `roles/monitoring.metricWriter` – see https://cloud.google.com/monitoring/access-control#predefined_roles
-- `roles/cloudtrace.agent` – see https://cloud.google.com/trace/docs/iam#trace-roles
+- `roles/telemetry.writer` – see https://cloud.google.com/trace/docs/iam#telemetry-roles
 
 ## Running the example
 
 The sample can easily be run in Cloud Shell. You can also use
-[Application Default Credentials][ADC] locally.
-
+[Application Default Credentials][ADC] locally. Clone and set environment variables:
 ```sh
 git clone https://github.com/GoogleCloudPlatform/opentelemetry-operations-python.git
 cd opentelemetry-operations-python/samples/langgraph-sql-agent
@@ -31,13 +35,26 @@ cd opentelemetry-operations-python/samples/langgraph-sql-agent
 export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true
 # Capture application logs automatically
 export OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true
+```
+
+Create a virtual environment and run the sample:
+```sh
+python -m venv venv/
+source venv/bin/activate
+pip install -r requirements.txt
+python main.py
+```
+
+Alternatively if you have [`uv`](https://docs.astral.sh/uv/) installed:
+
+```sh
 uv run main.py
 ```
 
 ## Viewing the results
 
 To view the generated traces with [Generative AI
 events](https://cloud.google.com/trace/docs/finding-traces#view_generative_ai_events) in the
-GCP console, use the [Trace Explorer](https://cloud.google.com/trace/docs/finding-traces).
+GCP console, use the [Trace Explorer](https://cloud.google.com/trace/docs/finding-traces). Filter for spans named `invoke agent`.
 
 [ADC]: https://cloud.google.com/docs/authentication/application-default-credentials