Road to GA `azure-ai-agents` and `azure-ai-projects`

[jpalvarezl]

Must do's (or as much as possible)

List sorted in decreasing order of importance:

• Address all the APIView feedback:
  • com.azure:azure-ai-agents
  • com.azure:azure-ai-projects
• Sample coverage and quality of sample control (exercise against live service and have samples more interesting than CRUD ops)
• We should show case streaming in our samples.
• We should show case streaming for an Azure only tool: this will inform what deserialization convenience methods we should add to ResponsesClient/ResponsesAsyncClient
• (strongly recommend using relevant SKILL.md for this) We should completely de-duplicate classes from the openai:openai-java package
• (strongly recommend using relevant SKILL.md for this) We should add custom getters and setters wrapping types that are ModelA | ModelB in TSP:
  • I believe Vincent was working on this for C# and Java, so I would recommend reaching out
  • Union types are surfaced as private BinaryData field. We should have a typed public surface
  • Double check that wherever BinaryData is exposed to users, it's because we are using unknown in TSP
• Enrich the READMEs with hero scenario driven code snippets.

Nice to-have's

• Finish all the items in this issue: azure-ai-agents and azure-ai-projects HTTPClient integration with OpenAI library #47540
  • That issue tracks integration issues with the Stainless client. Currently, it's mostly about QoL improvments
  • All that code is private from the perspective of the user.
• Test coverage. Currently Jacoco is disabled, but the minimum coverage required by guidelines is 15% (AFAIK, we should check this)
• Better sample coverage.

Completely optional, but I think it might be a good idea... probably

• Integrate with other languages client.tsp files so we consume updates applied to other languages that we might otherwise miss.