Python: [BREAKING] Observability updates (#2782)

* fixes Python: Add env_file_path parameter to setup_observability() similar to AzureOpenAIChatClient
Fixes #2186

* WIP on updates using configure_azure_monitor

* improved setup and clarity

* fixed root .env.example

* revert changes

* updated files

* updated sample

* updated zero code

* test fixes and fixed links

* fix devui

* removed planning docs

* added enable method and updated readme and samples

* clarified docstring

* add return annotation

* updated naming

* update capatilized version

* updated readme and some fixes

* updated decorator name inline with the rest

* feedback from comments addressed

python/samples/getting_started/observability/agent_observability.py

@@ -5,7 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
-from agent_framework.observability import get_tracer, setup_observability
+from agent_framework.observability import configure_otel_providers, get_tracer
 from agent_framework.openai import OpenAIChatClient
 from opentelemetry.trace import SpanKind
 from opentelemetry.trace.span import format_trace_id
@@ -27,9 +27,10 @@ async def get_weather(
 
 
 async def main():
-    # This will enable tracing and create the necessary tracing, logging and metrics providers
-    # based on environment variables. See the .env.example file for the available configuration options.
-    setup_observability()
+    # calling `configure_otel_providers` will *enable* tracing and create the necessary tracing, logging
+    # and metrics providers based on environment variables.
+    # See the .env.example file for the available configuration options.
+    configure_otel_providers()
 
     questions = ["What's the weather in Amsterdam?", "and in Paris, and which is better?", "Why is the sky blue?"]
 
@@ -41,10 +42,11 @@ async def main():
             tools=get_weather,
             name="WeatherAgent",
             instructions="You are a weather assistant.",
+            id="weather-agent",
         )
         thread = agent.get_new_thread()
         for question in questions:
-            print(f"User: {question}")
+            print(f"\nUser: {question}")
             print(f"{agent.display_name}: ", end="")
             async for update in agent.run_stream(
                 question,