[discovery] Add azure-ai-discovery 1.0.0 (GA) - #49932
Conversation
Initial GA release of the Discovery data-plane SDK, generated from the merged public GA spec (specification/discovery/Discovery.Combined @ fbe3c49, PR Azure/azure-rest-api-specs#42884), api-version 2026-06-01. Recordings externalized to Azure/azure-sdk-assets (tag java/discovery/azure-ai-discovery_2380bf9632).
github-actions
Bot
added
the
common
|
Azure Pipelines: Successfully started running 1 pipeline(s). 34 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run. |
|
Azure Pipelines: Successfully started running 1 pipeline(s). 34 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run. |
| ```java com.azure.ai.discovery.readme | ||
| ``` |
There was a problem hiding this comment.
We should have at least one sample to get user started. Put it in ReadmeSamples.java, and it should sync here.
|
|
||
| ### Features Added | ||
|
|
||
| - `WorkspaceClient` and `WorkspaceAsyncClient` for working with Discovery workspaces, including conversations, investigations, tasks, and tools. |
There was a problem hiding this comment.
There is no WorkspaceClient in code.
| */ | ||
| @Generated | ||
| @ServiceMethod(returns = ReturnType.SINGLE) | ||
| public PagedOperation getOperations(String projectName, Integer top, Integer skip, Integer maxPageSize) { |
There was a problem hiding this comment.
There is something wrong in the TypeSpec.
https://github.com/Azure/azure-rest-api-specs/blob/main/specification/discovery/Discovery.Workspace/_tool.tsp#L550-L559
This should be a paged operation, aka PagedIterable<Operation>.
There was a problem hiding this comment.
There could be more.
Basically, if the response is CustomPage<Something>, the operation should be a @list
weidongxu-microsoft
left a comment
weidongxu-microsoft
left a comment
There was a problem hiding this comment.
Additional GA API-surface findings.
| */ | ||
| @Generated | ||
| @ServiceMethod(returns = ReturnType.SINGLE) | ||
| public Conversation stableUpdate(String conversationName, Conversation resource) { |
There was a problem hiding this comment.
stableUpdate is an internal TypeSpec version-split name, but it is leaking into the initial GA Java API (and the same happens for Tasks). This will permanently expose stableUpdate/stableUpdateWithResponse instead of the expected update methods. Please apply a Java client name override in TypeSpec (for both Conversations and Tasks) and regenerate before 1.0.0.
There was a problem hiding this comment.
This should be just update in client
| */ | ||
| @Generated | ||
| @ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION) | ||
| public SyncPoller<PollOperationDetails, RunResult> beginCancelRunLro(String projectName, String operationId) { |
There was a problem hiding this comment.
Likewise, cancelRunLro exposes an implementation/versioning suffix in the public GA API. The customer-facing method should be beginCancelRun (with the protocol method named consistently), using a client-name override if the TypeSpec operation must retain cancelRunLro internally.
Adds PRLabel/ServiceLabel %Discovery and AzureSdkOwners/ServiceOwners for /sdk/discovery/, matching the Python data-plane PR.
Initial GA (1.0.0) release of the Microsoft Discovery data-plane SDK,
com.azure:azure-ai-discovery. Tracked by data-plane release plan 2205 (GA – Microsoft Discovery).Generated from the merged, public GA spec:
specification/discovery/Discovery.Combined(+Discovery.Common/Workspace/Bookshelf)fbe3c49c541a2932f4a4cb348fb0798988f4aca4(merge of PR [Microsoft Discovery] Add data-plane Discovery new GA version 2026-06-01 and 2026-02-01-preview non-breaking updates azure-rest-api-specs#42884)2026-06-01(GA)@azure-tools/typespec-java@0.45.10(matchesmain)What's included
sdk/discovery/azure-ai-discovery/(WorkspaceClient/BookshelfClient+ async, generated).sdk/discovery/pom.xml(aggregator) andsdk/discovery/ci.yml(artifactazure-ai-discovery).pom.xmlreactor entrysdk/discovery;eng/versioning/version_client.txtentry;.vscode/cspell.jsonscoped override (milli,invst).Release Plan Details