Skip to content

Commit 7a8c3cf

Browse files
authored
Merge pull request #5075 from aahill/removal
removing quickstart
2 parents a78c3dd + 257c1bb commit 7a8c3cf

File tree

10 files changed

+26
-1559
lines changed

10 files changed

+26
-1559
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,11 @@
120120
"redirect_url": "/azure/ai-services/agents/overview",
121121
"redirect_document_id": false
122122
},
123+
{
124+
"source_path_from_root": "/articles/ai-services/openai/assistants-quickstart.md",
125+
"redirect_url": "/azure/ai-services/agents/quickstart",
126+
"redirect_document_id": true
127+
},
123128
{
124129
"source_path_from_root": "/articles/ai-services/openai/how-to/use-your-data-securely.md",
125130
"redirect_url": "/azure/ai-services/openai/how-to/on-your-data-configuration",

articles/ai-services/openai/assistants-quickstart.md

Lines changed: 0 additions & 55 deletions
This file was deleted.

articles/ai-services/openai/concepts/assistants.md

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure OpenAI in Azure AI Foundry Models Assistants API concepts
33
titleSuffix: Azure OpenAI
44
description: Learn about the concepts behind the Azure OpenAI Assistants API.
55
ms.topic: conceptual
6-
ms.date: 02/04/2025
6+
ms.date: 05/20/2025
77
ms.service: azure-ai-openai
88
manager: nitinme
99
author: aahill
@@ -13,19 +13,22 @@ recommendations: false
1313

1414
# Azure OpenAI Assistants API (Preview)
1515

16+
> [!NOTE]
17+
> The [Azure AI Foundry Agent Service](../../agents/overview.md) is now Generally Available, which provides more tools and better enterprise features. We recommend using the new service for the latest feature updates and improvements.
18+
1619
Assistants, a feature of Azure OpenAI in Azure AI Foundry Models, is available in public preview starting in the `2024-02-15-preview` API version. Assistants API makes it easier for developers to create applications with sophisticated copilot-like experiences that can sift through data, suggest solutions, and automate tasks.
1720

1821
* Assistants can call Azure OpenAI’s [models](../concepts/models.md) with specific instructions to tune their personality and capabilities.
1922
* Assistants can access **multiple tools in parallel**. These can be both Azure OpenAI-hosted tools like [code interpreter](../how-to/code-interpreter.md) and [file search](../how-to/file-search.md), or tools you build, host, and access through [function calling](../how-to/function-calling.md).
20-
* Assistants can access **persistent Threads**. Threads simplify AI application development by storing message history and truncating it when the conversation gets too long for the model's context length. You create a Thread once, and simply append Messages to it as your users reply.
23+
* Assistants can access **persistent Threads**. Threads simplify AI application development by storing message history and truncating it when the conversation gets too long for the model's context length. You create a Thread once, and append Messages to it as your users reply.
2124
* Assistants can access files in several formats. Either as part of their creation or as part of Threads between Assistants and users. When using tools, Assistants can also create files (such as images or spreadsheets) and cite files they reference in the Messages they create.
2225

2326
## Overview
2427

2528
Previously, building custom AI assistants needed heavy lifting even for experienced developers. While the chat completions API is lightweight and powerful, it's inherently stateless, which means that developers had to manage conversation state and chat threads, tool integrations, retrieval documents and indexes, and execute code manually.
2629

2730
The Assistants API, as the stateful evolution of the chat completion API, provides a solution for these challenges.
28-
Assistants API supports persistent automatically managed threads. This means that as a developer you no longer need to develop conversation state management systems and work around a model’s context window constraints. The Assistants API will automatically handle the optimizations to keep the thread below the max context window of your chosen model. Once you create a Thread, you can simply append new messages to it as users respond. Assistants can also access multiple tools in parallel, if needed. These tools include:
31+
Assistants API supports persistent automatically managed threads. This means that as a developer you no longer need to develop conversation state management systems and work around a model’s context window constraints. The Assistants API will automatically handle the optimizations to keep the thread below the max context window of your chosen model. Once you create a Thread, you can append new messages to it as users respond. Assistants can also access multiple tools in parallel, if needed. These tools include:
2932

3033
- [Code Interpreter](../how-to/code-interpreter.md)
3134
- [Function calling](../how-to/assistant-functions.md)
@@ -38,12 +41,26 @@ Assistants API is built on the same capabilities that power OpenAI’s GPT produ
3841
> [!IMPORTANT]
3942
> Retrieving untrusted data using Function calling, Code Interpreter or File Search with file input, and Assistant Threads functionalities could compromise the security of your Assistant, or the application that uses the Assistant. Learn about mitigation approaches [here](https://aka.ms/oai/assistant-rai).
4043
44+
### Using assistants
45+
46+
For information on using assistants, see the following reference documentation.
47+
* [C#](/dotnet/api/overview/azure/ai.openai.assistants-readme?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext)
48+
* [Java](/java/api/overview/azure/ai-openai-assistants-readme?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext)
49+
* [JavaScript](../how-to/migration-javascript.md?tabs=javascript-new#assistants)
50+
* [Python](https://platform.openai.com/docs/api-reference/assistants)
51+
* [REST API](../reference-preview.md#list---assistants)
52+
4153
## Available models
4254

43-
To see a list of Azure OpenAI models that you can use with assitants, see the [Models](./models.md#assistants-preview) article.
55+
To see a list of Azure OpenAI models that you can use with assistants, see the [Models](./models.md#assistants-preview) article.
4456

4557
## Assistants playground
4658

59+
Before using assistants, you need:
60+
61+
- A [compatible model](../concepts/models.md#assistants-preview) deployed. For more information about model deployment, see the [resource deployment guide](../how-to/create-resource.md).
62+
- An [Azure AI project](../../../ai-foundry/how-to/create-projects.md) in Azure AI Foundry portal.
63+
4764
We provide a walkthrough of the Assistants playground in our [quickstart guide](../assistants-quickstart.md). This provides a no-code environment to test out the capabilities of assistants.
4865

4966
## Assistants components

articles/ai-services/openai/includes/assistants-ai-studio.md

Lines changed: 0 additions & 134 deletions
This file was deleted.

0 commit comments

Comments
 (0)