Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Visualizando atualmente:versão do portal do Foundry (clássico) - Alternar para a versão do novo portal do Foundry
Um recurso do Foundry fornece acesso unificado a modelos, agentes e ferramentas. Este artigo explica qual SDK e endpoint utilizar para seu cenário.
O Foundry SDK é um SDK thin client que expõe todas as APIs do projeto Foundry por meio de um único endpoint de projeto. SDKs de nível superior baseiam-se nele – por exemplo, o pacote do Agent Framework foundry depende do SDK do Foundry para acessar modelos, ferramentas e configuração de projeto do Foundry.
| SDK | Para que serve | Ponto de extremidade |
|---|---|---|
| Foundry SDK | SDK de cliente leve para todas as APIs de projetos do Foundry. Acesso aos Modelos de Fundação e ferramentas de plataforma (pesquisa de arquivos, interpretador de código, pesquisa na Web, memória, SharePoint, WorkIQ, Fabric IQ, MCP). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| Estrutura do Agente | Orquestração unificada de vários agentes para agentes hospedados e sistemas de vários agentes, disponível em C#/.NET e Python. O foundry pacote depende do SDK do Foundry para acesso ao projeto. |
API de respostas no ponto de extremidade do projeto, via FoundryChatClient. |
| OpenAI SDK | Superfície completa da API OpenAI, incluindo embeddings e modelos do Foundry vendidos pelo Azure por meio de Conclusões de Chat. Melhor latência e compatibilidade máxima do OpenAI. | https://<resource-name>.openai.azure.com/openai/v1 |
| SDK do Anthropic | Modelos Anthropic Claude implementados no Foundry. | https://<resource-name>.services.ai.azure.com/anthropic |
| SDKs do Foundry Tools | Soluções predefinidas (Visão, Fala, Segurança de Conteúdo e muito mais). | Pontos de extremidade específicos da ferramenta. |
Escolha seu SDK:
- Usar o SDK do Foundry ao criar aplicativos com agentes, avaliações ou recursos específicos do Foundry
- Usar o Agent Framework para agentes hospedados ou sistemas multi-agente no código usando a API de Respostas em C#/.NET ou Python
- Use o SDK do OpenAI quando a compatibilidade máxima do OpenAI ou a menor latência for necessária, ao gerar inserções ou ao usar modelos vendidos por Azure por meio de conclusões de chat
- Use Anthropic SDK ao trabalhar com modelos Anthropic Claude implantados no Foundry
- Use os SDKs do Foundry Tools ao trabalhar com serviços de IA específicos (Visão, Fala, Linguagem, etc.).
Nota
Tipos de recurso: Um recurso Foundry fornece todos os pontos de extremidade anteriormente listados. Um recurso do Azure OpenAI fornece apenas o endpoint /openai/v1.
Authentication: Exemplos aqui usam Microsoft Entra ID (DefaultAzureCredential). As chaves de API funcionam em /openai/v1. Passe a chave como api_key em vez de um provedor de token.
Pré-requisitos
-
Uma conta Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta de Azure free, que inclui uma assinatura de avaliação gratuita.
Tenha a função RBAC do Azure necessária para executar sua tarefa no escopo mais restrito possível:
Usuário do Foundry no projeto do Foundry para desenvolvimento diário.
Importante
As funções RBAC do Foundry foram renomeadas recentemente. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager eram anteriormente chamados de Usuário do Azure AI, Proprietário do Azure AI, Proprietário da conta do Azure AI e Gerente de Projeto do Azure AI. Você ainda pode ver os nomes anteriores em alguns lugares enquanto essa mudança de nome está sendo implementada. Os IDs das funções e as permissões principais não são alterados com a mudança de nome.
Gerente de Projeto do Foundry no projeto do Foundry para gerenciar um projeto existente e suas conexões.
Proprietário da Conta do Foundry no recurso do Foundry para criar projetos ou gerenciar recursos em nível de conta. Atribua essa função no grupo de recursos de destino somente quando você precisar criar um recurso do Foundry.
Ative a atribuição de grupo de recursos bem a tempo por meio de Microsoft Entra Privileged Identity Management (PIM) e desative-a após o provisionamento. Os desenvolvedores diários e os usuários de runtime não precisam dessa atribuição elevada.
Para obter detalhes sobre as permissões de cada função, consulte o controle de acesso baseado em Role para Microsoft Foundry.
Instale os runtimes de idioma necessários, as ferramentas globais e as extensões do VS Code, conforme descrito em Preparar seu ambiente de desenvolvimento.
Verificar pré-requisitos
Antes de prosseguir, confirme se cada verificação retorna o resultado declarado:
Confirme se o CLI do Azure usa a assinatura e o locatário pretendidos:
az account show --query "{subscription:name, tenant:tenantId}" --output tableO comando é concluído com êxito e exibe a assinatura e o locatário esperados.
Confirme se a credencial local pode solicitar um token de acesso do Foundry sem exibir o token:
az account get-access-token --resource https://ai.azure.com --query expiresOn --output tsvO comando é encerrado com êxito e exibe o tempo de expiração do token. Se falhar, execute
az logincom uma identidade que tenha a função Foundry necessária.Confirme se você possui a função RBAC necessária no portal do Azure em Recurso do Foundry>Controle de acesso (IAM).
- Execute
python --version. O comando é executado com êxito e informa Python 3.9 ou versão posterior.
- Execute
node --version. O comando é executado com êxito e informa o Node.js 22 ou posterior.
- Execute
dotnet --version. O comando é concluído com êxito e informa que o .NET é 8 ou posterior.
- Execute
java --version. O comando é concluído com êxito e informa que o Java é 17 ou posterior.
Confirme se o ponto de extremidade do projeto tem esse formato:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>.Confirme se a
gpt-5-miniimplantação está pronta:az cognitiveservices account deployment show \ --name <resource-name> \ --resource-group <resource-group> \ --deployment-name gpt-5-mini \ --query properties.provisioningState \ --output tsvO comando retorna
Succeeded. Use o nome implantado nos exemplos de código se a implantação tiver um nome diferente.
Foundry SDK
O SDK do Foundry se conecta a um único endpoint de projeto que fornece acesso aos recursos mais populares do Foundry.
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Nota
Se sua organização usar um subdomínio personalizado, substitua <resource-name><your-custom-subdomain> na URL do ponto de extremidade.
Essa abordagem simplifica a configuração do aplicativo. Em vez de gerenciar vários pontos de extremidade, você configura um.
Instalar o SDK
Nota
Este artigo se aplica a um projeto do Foundry. O código mostrado aqui não funciona para um projeto baseado em hub. Para obter mais informações, consulte Tipos de projetos.
Nota
Versões do SDK: Este artigo aborda a instalação do SDK 1.x. Verifique se os exemplos a seguir correspondem ao pacote instalado. Mude para a nova documentação do portal Foundry para visualizar o artigo da versão 2.x.
| Versão do SDK | Versão do Portal | Status | Pacote Python |
|---|---|---|---|
| 2.x | Fundição (novo) | Estável | azure-ai-projects>=2.0.0 |
| 1.x | Fundição (clássico) | Estável | azure-ai-projects==1.0.0 |
A biblioteca de clientes Azure AI Projects para Python é uma biblioteca unificada que permite que você use várias bibliotecas de cliente juntas conectando-se a um único ponto de extremidade de projeto.
Execute este comando para instalar os pacotes 1.x para projetos clássicos do Foundry.
pip install openai azure-identity azure-ai-projects==1.0.0
| Versão do SDK | Versão do Portal | Status | Pacote Java |
|---|---|---|---|
| 1.x | Clássico da fundição | Aposentado | Nenhum pacote de Java com suporte está disponível para este caminho clássico. Use com.azure:azure-ai-projects:2.2.0 com um projeto atual do Foundry. |
| Versão do SDK | Versão do Portal | Status | Pacote JavaScript |
|---|---|---|---|
| 1.0.1 | Clássico da fundição | Estável | @azure/ai-projects |
| Versão do SDK | Versão do Portal | Status | Pacote .NET |
|---|---|---|---|
| 1.1.0 (GA) | Clássico da fundição | Estável | Azure.AI.Projects |
O caminho do SDK Java para o Foundry clássico foi descontinuado. O SDK clássico de projeto 1.x não alcançou disponibilidade geral para Java, e o pacote de versão preliminar descontinuado azure-ai-inference não é uma alternativa com suporte.
Importante
Não inicie nem migre o desenvolvimento Java no caminho legado do SDK. Mude para o guia atual do SDK do Foundry e use a biblioteca cliente GA Projetos de IA do Azure para Java com um projeto do Foundry existente.
Para um projeto atual do Foundry, adicione a seguinte dependência ao arquivo Maven pom.xml:
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-projects</artifactId>
<version>2.2.0</version>
</dependency>
A biblioteca de clientes Azure AI Projects para JavaScript é uma biblioteca unificada que permite que você use várias bibliotecas de cliente juntas conectando-se a um único ponto de extremidade de projeto.
Execute este comando para instalar os pacotes JavaScript 1.x para projetos clássicos do Foundry.
npm install @azure/ai-projects@1.0.1 @azure/identity
A biblioteca de clientes Azure AI Projects para .NET é uma biblioteca unificada que permite que você use várias bibliotecas de clientes juntas conectando-se a um único ponto de extremidade de projeto.
Execute esses comandos para adicionar os pacotes 1.x Azure SDK de IA para projetos clássicos do Foundry.
# Add 1.x Azure AI SDK packages
dotnet add package Azure.Identity
dotnet add package Azure.AI.Projects --version 1.1.0
dotnet add package Azure.AI.Agents.Persistent --version 1.1.0
dotnet add package Azure.AI.Inference
Usando o SDK do Foundry
O SDK expõe dois tipos de cliente porque o Foundry e o OpenAI têm formas de API diferentes:
- Project client – Use para operações nativas do Foundry em que o OpenAI não tem equivalente. Exemplos: listar conexões, recuperar propriedades do projeto, habilitar o rastreamento.
-
Cliente compatível com OpenAI – Use a funcionalidade Foundry que se baseia em conceitos OpenAI. A API de Respostas, agentes, avaliações e ajuste fino usam padrões de solicitação/resposta no estilo OpenAI. Esse cliente também fornece acesso aos modelos diretos do Foundry (modelos nãoAzure-OpenAI hospedados na Foundry). O endpoint do projeto direciona esse tráfego na rota
/openai.
A maioria dos aplicativos usa os dois clientes. Use o cliente do projeto para configuração e configuração e use o cliente compatível com OpenAI para executar agentes, avaliações e modelos de chamada (incluindo modelos diretos do Foundry).
Criar um cliente de projeto:
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential
project_client = AIProjectClient(
endpoint="https://<resource-name>.services.ai.azure.com/api/projects/<project-name>",
credential=DefaultAzureCredential(),
)
Crie um cliente compatível com OpenAI do seu projeto:
models = project_client.get_openai_client(api_version="2024-10-21")
chat_responses = models.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "system", "content": "You are a helpful assistant"},
{"role": "user", "content": "What is the size of France in square miles?"},
],
)
print(chat_responses.choices[0].message.content)
O caminho de sucesso inicial com Java para o Foundry clássico foi descontinuado. O exemplo anterior azure-ai-inference não cria um cliente de projeto clássico e usa uma chamada de API que não está disponível nessa versão do pacote.
Para desenvolvimento em Java, use com.azure:azure-ai-projects:2.2.0 com um projeto atual do Foundry e siga o guia atual do SDK do Foundry. Esse caminho atual do SDK não adiciona Java suporte a projetos clássicos do Foundry.
Criar um cliente de projeto:
const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deployment = "gpt-4o";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
Crie um cliente compatível com OpenAI do seu projeto:
const client = await project.getAzureOpenAIClient({
// The API version should match the version of the Azure OpenAI resource
apiVersion: "2024-12-01-preview"
});
const chatCompletion = await client.chat.completions.create({
model: deployment,
messages: [
{ role: "system", content: "You are a helpful assistant" },
{ role: "user", content: "What is the speed of light?" },
],
});
console.log(chatCompletion.choices[0].message.content);
Criar um cliente de projeto:
using System.ClientModel.Primitives;
using Azure.AI.OpenAI;
using Azure.AI.Projects;
using Azure.Identity;
using OpenAI.Chat;
string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
AIProjectClient projectClient = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential());
Crie um cliente compatível com OpenAI do seu projeto:
ClientConnection connection = projectClient.GetConnection(typeof(AzureOpenAIClient).FullName!);
if (!connection.TryGetLocatorAsUri(out Uri uri) || uri is null)
{
throw new InvalidOperationException("Invalid URI.");
}
uri = new Uri($"https://{uri.Host}");
const string modelDeploymentName = "gpt-4o";
AzureOpenAIClient azureOpenAIClient = new AzureOpenAIClient(uri, new DefaultAzureCredential());
ChatClient chatClient = azureOpenAIClient.GetChatClient(deploymentName: modelDeploymentName);
Console.WriteLine("Complete a chat");
ChatCompletion result = chatClient.CompleteChat("List all the rainbow colors");
Console.WriteLine(result.Content[0].Text);
O que você pode fazer com o SDK do Foundry
- Access Foundry Models, incluindo Azure OpenAI
- Usar o Serviço de Agente do Foundry
- Executar avaliações de nuvem
- Habilitar o rastreamento de aplicativo
- Ajustar um modelo
- Obtenha pontos de extremidade e chaves para Foundry Tools, orquestração local e muito mais
Solucionando problemas
Erros de autenticação
Se você vir DefaultAzureCredential failed to retrieve a token:
Verify CLI do Azure é autenticado:
az account show az login # if not logged inVerificar a atribuição da função RBAC:
Confirme se você tem pelo menos a função de Usuário do Foundry no projeto Foundry
Importante
As funções RBAC do Foundry foram renomeadas recentemente. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager eram anteriormente chamados de Usuário do Azure AI, Proprietário do Azure AI, Proprietário da conta do Azure AI e Gerente de Projeto do Azure AI. Você ainda pode ver os nomes anteriores em alguns lugares enquanto essa mudança de nome está sendo implementada. Os IDs das funções e as permissões principais não são alterados com a mudança de nome.
Consulte Atribuir funções do Azure
Para identidade gerenciada em produção:
- Verifique se a identidade gerenciada tem a função apropriada atribuída
- Consulte Configurar identidades gerenciadas
Erros de configuração de ponto de extremidade
Se você vir Connection refused ou 404 Not Found:
- Verificar se os nomes de recursos e projetos correspondem à sua implantação real
-
Verificar o formato da URL do ponto de extremidade: Deve ser
https://<resource-name>.services.ai.azure.com/api/projects/<project-name> -
Para subdomínios personalizados: substitua
<resource-name>pelo subdomínio personalizado
Incompatibilidades de versão do SDK
Se os exemplos de código falharem com AttributeError ou ModuleNotFoundError:
Verifique a versão do SDK:
pip show azure-ai-projects # Python npm list @azure/ai-projects # JavaScript dotnet list package # .NETReinstalar com sinalizadores de versão corretos: consulte os comandos de instalação em cada seção de idioma acima
SDK de OpenAI
Use o SDK do OpenAI quando quiser a compatibilidade total máxima do cliente e da superfície da API do OpenAI. Esse ponto de extremidade fornece acesso a modelos de OpenAI do Azure e modelos diretos do Foundry (via API Conclusões de Chat). Ele não fornece acesso a recursos específicos do Foundry, como agentes e avaliações.
O seguinte trecho mostra como usar o endpoint Azure OpenAI /openai/v1 diretamente.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://ai.azure.com/.default"
)
client = OpenAI(
base_url = "https://<resource-name>.openai.azure.com/openai/v1/",
api_key=token_provider,
)
response = client.responses.create(
model="model_deployment_name",
input= "What is the size of France in square miles?"
)
print(response.model_dump_json(indent=2))
Para obter mais informações, consulte linguagens de programação com suporte do Azure OpenAI. Saída esperada:
{
"id": "resp_abc123",
"object": "response",
"created": 1234567890,
"model": "gpt-5.2",
"output_text": "France has an area of approximately 213,011 square miles (551,695 square kilometers)."
}
Para mais informações, consulte linguagens de programação com suporte do Azure OpenAI
Importante
Itens marcados (versão prévia) neste artigo estão atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não recomendamos isso para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou ter recursos restritos. Para obter mais informações, consulte Supplemental Terms of Use for Microsoft Azure Previews.
O seguinte trecho mostra como usar o endpoint Azure OpenAI /openai/v1 diretamente.
import com.azure.ai.openai.OpenAIClient;
import com.azure.ai.openai.OpenAIClientBuilder;
import com.azure.ai.openai.models.ChatChoice;
import com.azure.ai.openai.models.ChatCompletions;
import com.azure.ai.openai.models.ChatCompletionsOptions;
import com.azure.ai.openai.models.ChatRequestAssistantMessage;
import com.azure.ai.openai.models.ChatRequestMessage;
import com.azure.ai.openai.models.ChatRequestSystemMessage;
import com.azure.ai.openai.models.ChatRequestUserMessage;
import com.azure.ai.openai.models.ChatResponseMessage;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.core.util.Configuration;
import java.util.ArrayList;
import java.util.List;
String endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
String deploymentName = "gpt-5.2";
TokenCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
OpenAIClient client = new OpenAIClientBuilder()
.credential(defaultCredential)
.endpoint("{endpoint}")
.buildClient();
List<ChatRequestMessage> chatMessages = new ArrayList<>();
chatMessages.add(new ChatRequestSystemMessage("You are a helpful assistant."));
chatMessages.add(new ChatRequestUserMessage("What is the speed of light?"));
ChatCompletions chatCompletions = client.getChatCompletions(deploymentName, new ChatCompletionsOptions(chatMessages));
System.out.printf("Model ID=%s is created at %s.%n", chatCompletions.getId(), chatCompletions.getCreatedAt());
for (ChatChoice choice : chatCompletions.getChoices()) {
ChatResponseMessage message = choice.getMessage();
System.out.printf("Index: %d, Chat Role: %s.%n", choice.getIndex(), message.getRole());
System.out.println("Message:");
System.out.println(message.getContent());
Para obter mais informações sobre como usar o SDK do OpenAI, consulte Azure linguagens de programação com suporte do OpenAI.
import { AzureOpenAI } from "openai";
import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";
const deployment = "gpt-4o";
const endpoint = "https://<resource-name>.openai.azure.com";
const scope = "https://ai.azure.com/.default";
const apiVersion = "2024-04-01-preview";
const azureADTokenProvider = getBearerTokenProvider(new DefaultAzureCredential(), scope);
const options = { azureADTokenProvider, deployment, apiVersion, endpoint };
const client = new AzureOpenAI(options);
const result = await client.chat.completions.create({
model: deployment,
messages: [
{ role: "system", content: "You are a helpful assistant" },
{ role: "user", content: "What is the speed of light?" },
],
});
console.log(result.choices[0].message.content);
Para obter mais informações sobre como usar o SDK do OpenAI, consulte Azure linguagens de programação com suporte do OpenAI.
- Instale o pacote OpenAI: execute este comando para adicionar a biblioteca de clientes OpenAI ao seu projeto de .NET.
dotnet add package OpenAI ```When it succeeds, the .NET CLI confirms that it installed the `OpenAI` package. This snippet configures `DefaultAzureCredential`, builds `OpenAIClientOptions`, and creates a `ChatClient` for the Azure OpenAI v1 endpoint. ```csharp using System.ClientModel.Primitives; using Azure.Identity; using OpenAI; using OpenAI.Chat; #pragma warning disable OPENAI001 const string directModelEndpoint = "https://<resource-name>.openai.azure.com/openai/v1/"; const string modelDeploymentName = "gpt-5.2"; BearerTokenPolicy tokenPolicy = new( new DefaultAzureCredential(), "https://ai.azure.com/.default"); OpenAIClient openAIClient = new( authenticationPolicy: tokenPolicy, options: new OpenAIClientOptions() { Endpoint = new($"{directModelEndpoint}"), }); ChatClient chatClient = openAIClient.GetChatClient(modelDeploymentName); ChatCompletion completion = await chatClient.CompleteChatAsync( [ new SystemChatMessage("You are a helpful assistant."), new UserChatMessage("How many feet are in a mile?") ]); Console.WriteLine(completion.Content[0].Text); #pragma warning restore OPENAI001
Para obter mais informações sobre como usar o SDK do OpenAI, consulte Azure linguagens de programação com suporte do OpenAI.
Estrutura do Agente
Microsoft Agent Framework é um SDK de software livre para C#/.NET e Python que fornece orquestração multi-agente unificada e abstrações consistentes para compilar agentes e sistemas multi-agentes. É a camada de orquestração recomendada para agentes hospedados na Foundry.
- Se você usou anteriormente o AutoGen ou Kernel semântico para orquestração de vários agentes (coordenando vários agentes para trabalhar em conjunto em tarefas), considere o Agent Framework como sua camada de orquestração primária. Ele ajuda a evitar a combinação de vários SDKs de orquestração que resolvem tarefas de coordenação semelhantes, que podem adicionar abstrações e dependências conflitantes.
- Se você já tiver um código de orquestração substancial existente, dependa de recursos específicos do produto ou enfrente requisitos complexos de migração, avalie esses requisitos antes de se consolidar no Agent Framework.
Executar seu código como um agente hospedado
A principal abordagem for agentes baseados em código no Foundry são Agentes hospedados. Escreva seu agente com o Agent Framework, empacote-o como uma imagem de contêiner ou zip do código-fonte e deixe o Foundry executá-lo com um ponto de extremidade gerenciado, dimensionamento automático em Micro VMs isoladas, uma identidade de agente Microsoft Entra dedicada, estado de nível de sessão e observabilidade de ponta a ponta.
Os agentes hospedados são a opção recomendada quando você deseja um endpoint gerenciado pelo Foundry, acessível pela rede, que pode ser chamado por outros aplicativos ou agentes. Consulte Implantar seu primeiro agente hospedado.
Criar agentes em código fora do Foundry com a API de Respostas
Se você hospedar seu agente fora do Foundry — no seu próprio processo ou na sua própria infraestrutura — também poderá usar o Agent Framework para chamar diretamente a API de Respostas no endpoint do seu projeto. O Agent Framework se conecta por meio do FoundryChatClient provedor, que tem como destino:
{project_endpoint}/openai/v1/responses
Usar o ponto de extremidade do projeto — em vez de um ponto de extremidade do OpenAI no nível do recurso — fornece ao seu agente:
- Modelos do Foundry do catálogo (modelos diretos do OpenAI do Azure e do Foundry) em uma única API.
- Ferramentas de plataforma além do conjunto de ferramentas da OpenAI, incluindo busca de arquivos, interpretador de código, memória, busca na Web, servidores MCP, SharePoint, WorkIQ e Fabric IQ.
- Dados com escopo do projeto, autenticação de ferramenta On-Behalf-Of (OBO) e o rastreamento, os filtros de conteúdo e a configuração de identidade do projeto.
Esse padrão é cumulativo para agentes hospedados, não uma alternativa – o mesmo código do Agent Framework pode chamar a API de Respostas do seu próprio processo hoje e ser empacotado como um agente hospedado mais tarde, quando você quiser um ponto de extremidade gerenciado pelo Foundry. Confira o Início Rápido: Criar agentes usando a API de Respostas.
Para obter uma comparação completa dos tipos de agentes e das opções de hospedagem, consulte O que é o Microsoft Foundry Agent Service?.
SDKs do Foundry Tools
As Ferramentas Foundry (anteriormente Serviços de IA do Azure) são soluções pontuais predefinidas com SDKs dedicados. Utilize os seguintes pontos de extremidade para trabalhar com o Foundry Tools.
Qual ponto de extremidade você deve utilizar?
Escolha um ponto de extremidade com base em suas necessidades:
Utilize o ponto de extremidade dos Serviços de IA do Azure para acessar Visão Computacional, Segurança de Conteúdo, Inteligência de Documentos, Idioma, Tradução e Foundry Tools para Token.
Ponto de extremidade do Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/
Nota
Os pontos de extremidade usam o nome do recurso ou um subdomínio personalizado. Se sua organização configurou um subdomínio personalizado, substitua your-resource-name por your-custom-subdomain em todos os exemplos de pontos de extremidade.
Se as cargas de trabalho usarem os recursos da Linguagem de IA do Azure que está em desativação, por exemplo, análise de sentimento, extração de frases-chave, resumo, vinculação de entidade, CLU ou CQA, planeje migrar para as alternativas da Microsoft Foundry. Para um novo desenvolvimento, considere usar o SDK do Foundry ou o endpoint compatível com o OpenAI, como descrito anteriormente neste artigo. Consulte Migrar do Language Studio para o Microsoft Foundry.
Para Foundry Tools de Fala e Tradução, use os pontos de extremidade nas tabelas a seguir. Substitua os espaços reservados pelas informações do seu recurso.
Pontos de Extremidade de Fala
| Ferramenta de Fundição | Ponto de extremidade |
|---|---|
| Conversão de Fala em Texto (Padrão) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Conversão de Texto em Fala (Neural) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Voz Personalizada | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Pontos de extremidade de tradução
| Ferramenta de Fundição | Ponto de extremidade |
|---|---|
| Tradução de texto | https://api.cognitive.microsofttranslator.com/ |
| Tradução de Documento | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Endpoints de linguagem
| Ferramenta de Fundição | Ponto de extremidade |
|---|---|
| Análise de texto | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com |
Importante
Em 20 de março de 2027, o Azure Language Studio será desativado e migrado para Microsoft Foundry; todos os recursos e aprimoramentos futuros estarão disponíveis no Microsoft Foundry.
Em 31 de março de 2029, os seguintes recursos do Azure Language serão desativados (fim do suporte). Antes dessa data, os usuários devem migrar cargas de trabalho existentes e integrar novos projetos para modelos Microsoft Foundry para melhor compreensão da linguagem natural e integração simplificada de aplicativos:
- Extração de Frases-chave
- Análise de Sentimento e Mineração de Opiniões
- Classificação de texto personalizado
- Compreensão da Linguagem Conversacional (CLU)
- Resposta a perguntas personalizadas (CQA)
- Fluxo de trabalho de orquestração
- Resumo (extrativo e abstrativo, para documentos e conversas)
- Relacionamento de Entidades
Principais recursos com suporte contínuo: Detecção de Idioma, Detecção de PII, Análise de Texto para Saúde, NER Predefinido e NER Personalizado.
Para obter opções de migração, consulte Migrate do Language Studio para Microsoft Foundry.