Skip to content

SDK User-Agent prefixes feel confusing / outdated #3752

@deyaaeldeen

Description

@deyaaeldeen

Some service teams (AI Projects in particular) are getting confused by our JS SDK UA strings, e.g.:

`azsdk-js-client azsdk-js-api azsdk-js-ai-projects/2.0.0-beta.4 core-rest-pipeline/1.22.2 Node/22.14.0 (...)`

The main questions coming up:

  • What do azsdk-js-client vs azsdk-js-api actually represent today?
  • Do those distinctions still make sense for newer SDKs that don’t really expose a REST/API layer anymore?
  • Are these prefixes still intentionally meaningful, or mostly legacy from older layering assumptions?

Totally understand that UA changes are risky (telemetry, pipelines, regexes, etc.), so this isn’t proposing a change outright. It just feels like:

  • The current UA is hard to interpret for downstream teams
  • The intent isn’t obvious without historical context
  • Docs may not be doing enough to explain what’s going on

Curious what others think:

  • Is this distinction still something we actively rely on?
  • Do other languages do something similar?
  • Would better docs alone be “good enough” here?

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions