From c2f95447636087791adf2e8713d205884240c68b Mon Sep 17 00:00:00 2001 From: Eduard van Valkenburg Date: Tue, 19 May 2026 11:28:15 +0200 Subject: [PATCH] docs: soften disable_instrumentation() overclaim about telemetry guarantees Replace 'no telemetry will be emitted no matter what' (which is too strong, since callers can still pass force=True or mutate private attributes) with language framing the disable as a user-intent contract that library and framework code is expected to honor: the framework actively short-circuits the public enable paths, force=True and private-attribute writes are acknowledged as out-of-contract escape hatches that integrations should not use on the user's behalf. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- python/samples/02-agents/observability/README.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/python/samples/02-agents/observability/README.md b/python/samples/02-agents/observability/README.md index 383ff44e2d..c27cf9bc14 100644 --- a/python/samples/02-agents/observability/README.md +++ b/python/samples/02-agents/observability/README.md @@ -216,8 +216,15 @@ Framework integrations and third-party libraries can call `enable_instrumentatio ```python from agent_framework.observability import disable_instrumentation -# After this call, no Agent Framework telemetry will be emitted no matter what -# downstream library / framework code tries to do. +# After this call, Agent Framework expresses your intent to opt out of telemetry. +# Library and framework code is expected to honor that intent and not flip +# instrumentation back on (e.g. by calling `enable_instrumentation()`, +# `enable_sensitive_telemetry()`, or writing to public attributes on +# `OBSERVABILITY_SETTINGS`). The framework actively short-circuits the public +# enable paths so the user's intent stays leading. A determined caller can still +# pass `force=True` or mutate private (`_`-prefixed) attributes to bypass it, +# but those are out-of-contract escape hatches that should not be used by +# integrations on the user's behalf. disable_instrumentation() ```