Python: Improved telemetry setup (#421)

* test with stack and simplified names

* quick demo of agent decorator

* moved builder to protocol to enhance functionality

* undid chatclientAgent -> agent rename

* one more

* reverted AIAgent rename

* final reverts

* fixed foundry import

* revert changes

* streamlined otel and fcc decorators

* cleanup of telemetry

* further refinement

* lots of updates

* fixed typing

* fix for mypy

* added input and output atttributes

* fix import

* initial work on baking in otel

* major update to telemetry

* final fixes after rename

* fix

* fix test

* updated tests

* fix for tests

* fixes for tests

* updated based on comments

* removed agent decorator

* fix for Python: ServiceResponseException when using multiple tools
Fixes #649

* addressed comments

* fix tests

* fix tests

* fix tools tests

* fix for conversation_id in assistants client

* fix responses test

* fix tests and mypy

* updated test

* foundry fix

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

python/.env.example

@@ -1,8 +1,17 @@
+# Foundry
 FOUNDRY_PROJECT_ENDPOINT=""
 FOUNDRY_MODEL_DEPLOYMENT_NAME=""
+# OpenAI
 OPENAI_API_KEY=""
 OPENAI_CHAT_MODEL_ID=""
+OPENAI_RESPONSES_MODEL_ID=""
+# Azure OpenAI
 AZURE_OPENAI_ENDPOINT=""
 AZURE_OPENAI_CHAT_DEPLOYMENT_NAME=""
 AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME=""
-OPENAI_RESPONSES_MODEL_ID=""
+# Telemetry
+AGENT_FRAMEWORK_MONITOR_CONNECTION_STRING="..."
+AGENT_FRAMEWORK_OTLP_ENDPOINT="http://localhost:4317/"
+AGENT_FRAMEWORK_ENABLE_OTEL=true
+AGENT_FRAMEWORK_ENABLE_SENSITIVE_DATA=true
+AGENT_FRAMEWORK_WORKFLOW_ENABLE_OTEL=true