azure-ai-foundry · e-straight · Jul 21, 2025
diff --git a/samples/microsoft/java/getting-started-agents/CHANGELOG.md b/samples/microsoft/java/getting-started-agents/CHANGELOG.md
@@ -0,0 +1,37 @@
+# Release History
+
+## 1.0.0-beta.3 (Unreleased)
+
+### Features Added
+
+### Breaking Changes
+
+### Bugs Fixed
+
+### Other Changes
+
+## 1.0.0-beta.2 (2025-06-17)
+
+### Breaking Changes
+
+- Merges `RunsClient` and `RunStepsClient` into `RunsClient`
+- Merges `VectorStoresClient`, `VectorStoreFilesClient`, `VectoreStoreFileBatchesClient` into one `VectoreStoresClient`
+- `PersistentAgentsAdministrationClientBuilder` is replace with `PersistentAgentsClientBuilder` and administration related operations are separated out into `PersistentAgentsAdministrationClient`
+- Introduced `PersistentAgentsClient` and other clients have been made sub-clients of `PersistentAgentsClient`
+- `AgentsServiceVersion` is renamed to `PersistentAgentsServiceVersion`
+
+### Bugs Fixed
+
+- Fixed [issue in FilesClient::uploadFile](https://github.com/Azure/azure-sdk-for-java/issues/45549)
+
+### Other Changes
+
+- Deletion operations in service clients will not return any content. Exception will be raised if deletion fails.
+
+## 1.0.0-beta.1 (2025-05-15)
+
+- Initial release of Azure AI Agents Persistent client library for Java.
+
+### Features Added
+
+- Added support for Azure AI Agents Persistent client library for Java.
diff --git a/samples/microsoft/java/getting-started-agents/README.md b/samples/microsoft/java/getting-started-agents/README.md
@@ -0,0 +1,77 @@
+# Azure Agents client library for Java
+
+Azure Agents client library for Java.
+
+This package contains Microsoft Azure Agents client library.
+
+## Documentation
+
+Various documentation is available to help you get started
+
+- [API reference documentation][docs]
+
+## Getting started
+
+### Prerequisites
+
+- [Java Development Kit (JDK)][jdk] with version 8 or above
+- [Azure Subscription][azure_subscription]
+
+### Adding the package to your product
+
+[//]: # ({x-version-update-start;com.azure:azure-ai-agents-persistent;current})
+```xml
+<dependency>
+    <groupId>com.azure</groupId>
+    <artifactId>azure-ai-agents-persistent</artifactId>
+    <version>1.0.0-beta.1</version>
+</dependency>
+```
+[//]: # ({x-version-update-end})
+
+### Authentication
+
+[Azure Identity][azure_identity] package provides the default implementation for authenticating the client.
+
+## Key concepts
+
+## Examples
+
+```java com.azure.ai.agents.persistent.readme
+```
+
+### Service API versions
+
+The client library targets the latest service API version by default.
+The service client builder accepts an optional service API version parameter to specify which API version to communicate.
+
+#### Select a service API version
+
+You have the flexibility to explicitly select a supported service API version when initializing a service client via the service client builder.
+This ensures that the client can communicate with services using the specified API version.
+
+When selecting an API version, it is important to verify that there are no breaking changes compared to the latest API version.
+If there are significant differences, API calls may fail due to incompatibility.
+
+Always ensure that the chosen API version is fully supported and operational for your specific use case and that it aligns with the service's versioning policy.
+
+## Troubleshooting
+
+## Next steps
+
+## Contributing
+
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
+
+1. Fork it
+1. Create your feature branch (`git checkout -b my-new-feature`)
+1. Commit your changes (`git commit -am 'Add some feature'`)
+1. Push to the branch (`git push origin my-new-feature`)
+1. Create new Pull Request
+
+<!-- LINKS -->
+[product_documentation]: https://azure.microsoft.com/services/
+[docs]: https://azure.github.io/azure-sdk-for-java/
+[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
+[azure_subscription]: https://azure.microsoft.com/free/
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
diff --git a/samples/microsoft/java/getting-started-agents/assets.json b/samples/microsoft/java/getting-started-agents/assets.json
@@ -0,0 +1,6 @@
+{
+  "AssetsRepo": "Azure/azure-sdk-assets",
+  "AssetsRepoPrefixPath": "java",
+  "TagPrefix": "java/ai/azure-ai-agents-persistent",
+  "Tag": "java/ai/azure-ai-agents-persistent_ddca46c6a2"
+}
diff --git a/samples/microsoft/java/getting-started-agents/checkstyle-suppressions.xml b/samples/microsoft/java/getting-started-agents/checkstyle-suppressions.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE suppressions PUBLIC "-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN" "https://checkstyle.org/dtds/suppressions_1_2.dtd">
+<!-- This file is generated by the /eng/scripts/linting_suppression_generator.py script. -->
+
+<suppressions>
+  <suppress files="com.azure.ai.agents.persistent.implementation.FilesImpl.java" checks="MissingJavadocMethodCheck" />
+  <suppress files="com.azure.ai.agents.persistent.implementation.MessagesImpl.java" checks="MissingJavadocMethodCheck" />
+  <suppress files="com.azure.ai.agents.persistent.implementation.PersistentAgentsAdministrationImpl.java" checks="MissingJavadocMethodCheck" />
+  <suppress files="com.azure.ai.agents.persistent.implementation.RunsImpl.java" checks="MissingJavadocMethodCheck" />
+  <suppress files="com.azure.ai.agents.persistent.implementation.ThreadsImpl.java" checks="MissingJavadocMethodCheck" />
+  <suppress files="com.azure.ai.agents.persistent.implementation.VectorStoresImpl.java" checks="MissingJavadocMethodCheck" />
+  <suppress files="com.azure.ai.agents.persistent.implementation.MultipartFormDataHelper.java" checks="MissingJavadocTypeCheck" />
+  <suppress files="com.azure.ai.agents.persistent.implementation.MultipartFormDataHelper.java" checks="com.azure.tools.checkstyle.checks.EnforceFinalFieldsCheck" />
+  <suppress files="com.azure.ai.agents.persistent.FilesAsyncClient.java" checks="com.azure.tools.checkstyle.checks.ServiceClientCheck" />
+  <suppress files="com.azure.ai.agents.persistent.FilesClient.java" checks="com.azure.tools.checkstyle.checks.ServiceClientCheck" />
+  <suppress files="com.azure.ai.agents.persistent.RunsAsyncClient.java" checks="com.azure.tools.checkstyle.checks.ServiceClientCheck" />
+</suppressions>
diff --git a/samples/microsoft/java/getting-started-agents/pom.xml b/samples/microsoft/java/getting-started-agents/pom.xml
@@ -0,0 +1,78 @@
+<!--
+ ~ Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+Code generated by Microsoft (R) TypeSpec Code Generator.
+ -->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.azure</groupId>
+    <artifactId>azure-client-sdk-parent</artifactId>
+    <version>1.7.0</version> <!-- {x-version-update;com.azure:azure-client-sdk-parent;current} -->
+    <relativePath>../../parents/azure-client-sdk-parent</relativePath>
+  </parent>
+
+  <groupId>com.azure</groupId>
+  <artifactId>azure-ai-agents-persistent</artifactId>
+  <version>1.0.0-beta.3</version> <!-- {x-version-update;com.azure:azure-ai-agents-persistent;current} -->
+  <packaging>jar</packaging>
+
+  <name>Microsoft Azure SDK for Agents</name>
+  <description>This package contains Microsoft Azure Agents client library.</description>
+  <url>https://github.com/Azure/azure-sdk-for-java</url>
+
+  <licenses>
+    <license>
+      <name>The MIT License (MIT)</name>
+      <url>http://opensource.org/licenses/MIT</url>
+      <distribution>repo</distribution>
+    </license>
+  </licenses>
+
+  <scm>
+    <url>https://github.com/Azure/azure-sdk-for-java</url>
+    <connection>scm:git:[email protected]:Azure/azure-sdk-for-java.git</connection>
+    <developerConnection>scm:git:[email protected]:Azure/azure-sdk-for-java.git</developerConnection>
+    <tag>HEAD</tag>
+  </scm>
+  <developers>
+    <developer>
+      <id>microsoft</id>
+      <name>Microsoft</name>
+    </developer>
+  </developers>
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <jacoco.min.linecoverage>0.20</jacoco.min.linecoverage>
+    <jacoco.min.branchcoverage>0.10</jacoco.min.branchcoverage>
+    <checkstyle.suppressionsLocation>checkstyle-suppressions.xml</checkstyle.suppressionsLocation>
+    <javaModulesSurefireArgLine>
+      --add-exports com.azure.core/com.azure.core.implementation.util=ALL-UNNAMED
+      --add-opens com.azure.core/com.azure.core.implementation.util=ALL-UNNAMED
+    </javaModulesSurefireArgLine>
+  </properties>
+  <dependencies>
+    <dependency>
+      <groupId>com.azure</groupId>
+      <artifactId>azure-core</artifactId>
+      <version>1.55.5</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
+    </dependency>
+    <dependency>
+      <groupId>com.azure</groupId>
+      <artifactId>azure-core-http-netty</artifactId>
+      <version>1.15.13</version> <!-- {x-version-update;com.azure:azure-core-http-netty;dependency} -->
+    </dependency>
+    <dependency>
+      <groupId>com.azure</groupId>
+      <artifactId>azure-core-test</artifactId>
+      <version>1.27.0-beta.10</version> <!-- {x-version-update;com.azure:azure-core-test;dependency} -->
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.azure</groupId>
+      <artifactId>azure-identity</artifactId>
+      <version>1.16.2</version> <!-- {x-version-update;com.azure:azure-identity;dependency} -->
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>