Skip to content

Commit 0f8c354

Browse files
authored
AI Foundry SDK - Persistent Agents Library (Azure#45266)
* Initial commit of Agents Library 1DP
1 parent 10e5854 commit 0f8c354

331 files changed

Lines changed: 57721 additions & 1 deletion

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/CODEOWNERS

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,9 +70,15 @@
7070
# ServiceLabel: %Advisor
7171
# ServiceOwners: @mojayara @Prasanna-Padmanabhan
7272

73+
# PRLabel: %AI
74+
/sdk/ai/ @dargilco @jhakulin
75+
7376
# PRLabel: %AI Model Inference
7477
/sdk/ai/azure-ai-inference/ @dargilco @jhakulin @glharper
7578

79+
# PRLabel: %AI Agents
80+
/sdk/ai/azure-ai-agents-persistent/ @dargilco @jhakulin @jayantjha
81+
7682
# ServiceLabel: %AKS
7783
# ServiceOwners: @Azure/aks-pm
7884

.vscode/cspell.json

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -199,7 +199,8 @@
199199
"sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/indexes/models/SnowballTokenFilterLanguage.java",
200200
"sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/indexes/models/TextTranslationSkillLanguage.java",
201201
"sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/indexes/models/TokenFilterName.java",
202-
"sdk/openai/azure-ai-openai-realtime/tsp-location.yaml"
202+
"sdk/openai/azure-ai-openai-realtime/tsp-location.yaml",
203+
".github/CODEOWNERS"
203204
],
204205
"words": [
205206
"adal",
@@ -1366,6 +1367,12 @@
13661367
"gcch",
13671368
"updation" // current typo in a swagger
13681369
]
1370+
},
1371+
{
1372+
"filename": "sdk/ai/azure-ai-agents-persistent/**",
1373+
"words": [
1374+
"AISEARCH"
1375+
]
13691376
}
13701377
],
13711378
"allowCompoundWords": true

eng/versioning/version_client.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@
3535

3636
com.azure:azure-sdk-parent;1.6.0;1.6.0
3737
com.azure:azure-client-sdk-parent;1.7.0;1.7.0
38+
com.azure:azure-ai-agents-persistent;1.0.0-beta.1;1.0.0-beta.1
3839
com.azure:azure-ai-anomalydetector;3.0.0-beta.5;3.0.0-beta.6
3940
com.azure:azure-ai-contentsafety;1.0.11;1.1.0-beta.1
4041
com.azure:azure-ai-documentintelligence;1.0.1;1.1.0-beta.1
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Release History
2+
3+
## 1.0.0-beta.1 (Unreleased)
4+
5+
- Azure Agents client library for Java. This package contains Microsoft Azure Agents client library.
6+
7+
### Features Added
8+
9+
### Breaking Changes
10+
11+
### Bugs Fixed
12+
13+
### Other Changes
Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# Azure Agents client library for Java
2+
3+
Azure Agents client library for Java.
4+
5+
This package contains Microsoft Azure Agents client library.
6+
7+
## Documentation
8+
9+
Various documentation is available to help you get started
10+
11+
- [API reference documentation][docs]
12+
- [Product documentation][product_documentation]
13+
14+
## Getting started
15+
16+
### Prerequisites
17+
18+
- [Java Development Kit (JDK)][jdk] with version 8 or above
19+
- [Azure Subscription][azure_subscription]
20+
21+
### Adding the package to your product
22+
23+
[//]: # ({x-version-update-start;com.azure:azure-ai-agents-persistent;current})
24+
```xml
25+
<dependency>
26+
<groupId>com.azure</groupId>
27+
<artifactId>azure-ai-agents-persistent</artifactId>
28+
<version>1.0.0-beta.1</version>
29+
</dependency>
30+
```
31+
[//]: # ({x-version-update-end})
32+
33+
### Authentication
34+
35+
[Azure Identity][azure_identity] package provides the default implementation for authenticating the client.
36+
37+
## Key concepts
38+
39+
## Examples
40+
41+
```java com.azure.ai.agents.persistent.readme
42+
```
43+
44+
### Service API versions
45+
46+
The client library targets the latest service API version by default.
47+
The service client builder accepts an optional service API version parameter to specify which API version to communicate.
48+
49+
#### Select a service API version
50+
51+
You have the flexibility to explicitly select a supported service API version when initializing a service client via the service client builder.
52+
This ensures that the client can communicate with services using the specified API version.
53+
54+
When selecting an API version, it is important to verify that there are no breaking changes compared to the latest API version.
55+
If there are significant differences, API calls may fail due to incompatibility.
56+
57+
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.
58+
59+
## Troubleshooting
60+
61+
## Next steps
62+
63+
## Contributing
64+
65+
For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
66+
67+
1. Fork it
68+
1. Create your feature branch (`git checkout -b my-new-feature`)
69+
1. Commit your changes (`git commit -am 'Add some feature'`)
70+
1. Push to the branch (`git push origin my-new-feature`)
71+
1. Create new Pull Request
72+
73+
<!-- LINKS -->
74+
[product_documentation]: https://azure.microsoft.com/services/
75+
[docs]: https://azure.github.io/azure-sdk-for-java/
76+
[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
77+
[azure_subscription]: https://azure.microsoft.com/free/
78+
[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"AssetsRepo": "Azure/azure-sdk-assets",
3+
"AssetsRepoPrefixPath": "java",
4+
"TagPrefix": "java/ai/azure-ai-agents-persistent",
5+
"Tag": "java/ai/azure-ai-agents-persistent_0e2d0e5b6f"
6+
}
Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
<!--
2+
~ Copyright (c) Microsoft Corporation. All rights reserved.
3+
Licensed under the MIT License.
4+
Code generated by Microsoft (R) TypeSpec Code Generator.
5+
-->
6+
<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">
7+
<modelVersion>4.0.0</modelVersion>
8+
<parent>
9+
<groupId>com.azure</groupId>
10+
<artifactId>azure-client-sdk-parent</artifactId>
11+
<version>1.7.0</version> <!-- {x-version-update;com.azure:azure-client-sdk-parent;current} -->
12+
<relativePath>../../parents/azure-client-sdk-parent</relativePath>
13+
</parent>
14+
15+
<groupId>com.azure</groupId>
16+
<artifactId>azure-ai-agents-persistent</artifactId>
17+
<version>1.0.0-beta.1</version> <!-- {x-version-update;com.azure:azure-ai-agents-persistent;current} -->
18+
<packaging>jar</packaging>
19+
20+
<name>Microsoft Azure SDK for Agents</name>
21+
<description>This package contains Microsoft Azure Agents client library.</description>
22+
<url>https://github.com/Azure/azure-sdk-for-java</url>
23+
24+
<licenses>
25+
<license>
26+
<name>The MIT License (MIT)</name>
27+
<url>http://opensource.org/licenses/MIT</url>
28+
<distribution>repo</distribution>
29+
</license>
30+
</licenses>
31+
32+
<scm>
33+
<url>https://github.com/Azure/azure-sdk-for-java</url>
34+
<connection>scm:git:git@github.com:Azure/azure-sdk-for-java.git</connection>
35+
<developerConnection>scm:git:git@github.com:Azure/azure-sdk-for-java.git</developerConnection>
36+
<tag>HEAD</tag>
37+
</scm>
38+
<developers>
39+
<developer>
40+
<id>microsoft</id>
41+
<name>Microsoft</name>
42+
</developer>
43+
</developers>
44+
<properties>
45+
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
46+
<jacoco.min.linecoverage>0.20</jacoco.min.linecoverage>
47+
<jacoco.min.branchcoverage>0.10</jacoco.min.branchcoverage>
48+
49+
<javaModulesSurefireArgLine>
50+
--add-exports com.azure.core/com.azure.core.implementation.util=ALL-UNNAMED
51+
--add-opens com.azure.core/com.azure.core.implementation.util=ALL-UNNAMED
52+
</javaModulesSurefireArgLine>
53+
</properties>
54+
<dependencies>
55+
<dependency>
56+
<groupId>com.azure</groupId>
57+
<artifactId>azure-core</artifactId>
58+
<version>1.55.3</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
59+
</dependency>
60+
<dependency>
61+
<groupId>com.azure</groupId>
62+
<artifactId>azure-core-http-netty</artifactId>
63+
<version>1.15.11</version> <!-- {x-version-update;com.azure:azure-core-http-netty;dependency} -->
64+
</dependency>
65+
<dependency>
66+
<groupId>com.azure</groupId>
67+
<artifactId>azure-core-test</artifactId>
68+
<version>1.27.0-beta.8</version> <!-- {x-version-update;com.azure:azure-core-test;dependency} -->
69+
<scope>test</scope>
70+
</dependency>
71+
<dependency>
72+
<groupId>com.azure</groupId>
73+
<artifactId>azure-identity</artifactId>
74+
<version>1.16.0</version> <!-- {x-version-update;com.azure:azure-identity;dependency} -->
75+
<scope>test</scope>
76+
</dependency>
77+
</dependencies>
78+
</project>
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
// Copyright (c) Microsoft Corporation. All rights reserved.
2+
// Licensed under the MIT License.
3+
// Code generated by Microsoft (R) TypeSpec Code Generator.
4+
5+
package com.azure.ai.agents.persistent;
6+
7+
import com.azure.core.util.ServiceVersion;
8+
9+
/**
10+
* Service version of AgentsClient.
11+
*/
12+
public enum AgentsServiceVersion implements ServiceVersion {
13+
/**
14+
* Enum value 2025-05-01.
15+
*/
16+
V2025_05_01("2025-05-01"),
17+
18+
/**
19+
* Enum value 2025-05-15-preview.
20+
*/
21+
V2025_05_15_PREVIEW("2025-05-15-preview"),
22+
23+
/**
24+
* Enum value v1.
25+
*/
26+
V1("v1");
27+
28+
private final String version;
29+
30+
AgentsServiceVersion(String version) {
31+
this.version = version;
32+
}
33+
34+
/**
35+
* {@inheritDoc}
36+
*/
37+
@Override
38+
public String getVersion() {
39+
return this.version;
40+
}
41+
42+
/**
43+
* Gets the latest service version supported by this client library.
44+
*
45+
* @return The latest {@link AgentsServiceVersion}.
46+
*/
47+
public static AgentsServiceVersion getLatest() {
48+
return V1;
49+
}
50+
}

0 commit comments

Comments
 (0)