Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Visualización actual:Versión - Cambio a la versión del nuevo portal de Foundry
Un recurso Foundry proporciona acceso unificado a modelos, agentes y herramientas. En este artículo se explica qué SDK y punto de conexión usar para su escenario.
El SDK de Foundry es un SDK de cliente fino que expone todas las API del proyecto Foundry a través de un único punto de conexión de proyecto. Los SDK de nivel superior se basan en él; por ejemplo, el paquete de Agent Framework foundry depende del SDK de Foundry para acceder a los modelos, herramientas y configuración del proyecto de Foundry.
| SDK | Para qué sirve | Punto de conexión |
|---|---|---|
| Foundry SDK | SDK de cliente ligero para todas las API del proyecto Foundry. Acceso a las herramientas de plataforma y modelos de Foundry (búsqueda de archivos, intérprete de código, búsqueda web, memoria, SharePoint, WorkIQ, Fabric IQ, MCP). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| Marco de trabajo del agente | Orquestación multiagente unificada para agentes hospedados y sistemas multiagente, disponibles en C#/.NET y Python. El foundry paquete depende del SDK de Foundry para el acceso al proyecto. |
API de Respuestas en el punto de conexión del proyecto, a través de FoundryChatClient. |
| OpenAI SDK | Superficie completa de la API de OpenAI, incluidas las incrustaciones y los modelos de Foundry vendidos por Azure a través de Chat Completions. Mejor latencia y compatibilidad máxima de OpenAI. | https://<resource-name>.openai.azure.com/openai/v1 |
| SDK de Anthropic | Modelos Anthropic Claude implementados en Foundry. | https://<resource-name>.services.ai.azure.com/anthropic |
| SDKs de herramientas Foundry | Soluciones precompiladas (Visión, Voz, Seguridad de contenido, etc.). | Puntos de conexión específicos de la herramienta. |
Elija el SDK:
- Usar el SDK de Foundry al compilar aplicaciones con agentes, evaluaciones o características específicas de Foundry
- Use Agent Framework para agentes alojados o sistemas multiagente en código mediante la API de Responses en C#/.NET o Python
- Use el SDK de OpenAI cuando se requiera la compatibilidad máxima de OpenAI o la latencia más baja, al generar incrustaciones o cuando se usen modelos vendidos por Azure a través de finalizaciones de chat
- Use Anthropic SDK al trabajar con modelos de Anthropic Claude implementados en Foundry
- Usar SDKs de Foundry Tools al trabajar con servicios de IA específicos (Visión, Voz, Lenguaje, etc.)
Nota
Tipos de recursos: Un recurso Foundry proporciona todos los puntos de conexión enumerados anteriormente. Un recurso Azure de OpenAI solo proporciona el punto de conexión de /openai/v1.
Authentication: Ejemplos aquí usan Microsoft Entra ID (DefaultAzureCredential). Las claves de API funcionan en /openai/v1. Pase la clave como api_key en lugar de un proveedor de tokens.
Requisitos previos
-
Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta de free Azure, que incluye una suscripción de evaluación gratuita.
Disponga del rol de Azure RBAC necesario para su tarea en el ámbito más restringido posible:
Foundry User en el proyecto Foundry para las tareas diarias de desarrollo.
Importante
Recientemente se ha cambiado el nombre de los roles RBAC de Foundry. Foundry User, Foundry Owner, Foundry Account Owner y Foundry Project Manager se llamaban anteriormente Usuario de Azure AI, Propietario de Azure AI, Propietario de la cuenta de Azure AI y Administrador de proyectos de Azure AI. Es posible que siga viendo los nombres anteriores en algunos lugares mientras se implementa el cambio de nombre. El cambio de nombre no modifica los identificadores de rol y los permisos principales.
Foundry Project Manager en el proyecto Foundry para gestionar un proyecto existente y sus conexiones.
Titular de la cuenta de Foundry en el recurso de Foundry para crear proyectos o administrar recursos en el nivel de cuenta. Asigne este rol en el grupo de recursos de destino solo cuando necesite crear un recurso Foundry.
Activa la asignación del grupo de recursos justo a tiempo a través de Microsoft Entra Privileged Identity Management (PIM) y desactívala tras el aprovisionamiento. Los desarrolladores habituales y los usuarios del entorno de ejecución no necesitan esta asignación elevada.
Para obtener más información sobre los permisos de cada rol, consulte Control de acceso basado en roles para Microsoft Foundry.
Instale los entornos de ejecución de lenguaje necesarios, las herramientas globales y las extensiones de VS Code, tal como se describe en Preparación del entorno de desarrollo.
Comprobación de los requisitos previos
Antes de continuar, confirme que cada comprobación devuelve el resultado indicado:
Confirme que la CLI de Azure está usando la suscripción y el tenant correctos:
az account show --query "{subscription:name, tenant:tenantId}" --output tableEl comando finaliza correctamente y muestra la suscripción y el arrendatario esperados.
Confirme que la credencial local puede solicitar un token de acceso de Foundry sin mostrar el token:
az account get-access-token --resource https://ai.azure.com --query expiresOn --output tsvEl comando se cierra correctamente y muestra la hora de expiración del token. Si se produce un error, ejecute
az logincon una identidad que tenga el rol Foundry necesario.Confirme que dispone del rol RBAC necesario en el portal de Azure, en Recurso de Foundry>Control de acceso (IAM).
- Ejecute
python --version. El comando finaliza correctamente e indica la versión de Python 3.9 o una versión posterior.
- Ejecute
node --version. El comando finaliza correctamente e indica Node.js 22 o una versión posterior.
- Ejecute
dotnet --version. El comando finaliza correctamente e informa de .NET 8 o una versión posterior.
- Ejecute
java --version. El comando finaliza correctamente y muestra Java 17 o versiones posteriores.
Confirme que el punto de conexión del proyecto tiene este formato:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>.Confirme que la
gpt-5-miniimplementación está lista:az cognitiveservices account deployment show \ --name <resource-name> \ --resource-group <resource-group> \ --deployment-name gpt-5-mini \ --query properties.provisioningState \ --output tsvEl comando devuelve
Succeeded. Use el nombre implementado en los ejemplos de código si la implementación tiene un nombre diferente.
Foundry SDK
El SDK de Foundry se conecta a un único punto de conexión de proyecto que proporciona acceso a las funcionalidades de Foundry más populares:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Nota
Si su organización usa un subdominio personalizado, reemplace por <resource-name><your-custom-subdomain> en la dirección URL del punto de conexión.
Este enfoque simplifica la configuración de la aplicación. En lugar de administrar varios puntos de conexión, configure uno.
Instalación del SDK
Nota
Este artículo se aplica a un proyecto de Foundry. El código que se muestra aquí no funciona para un proyecto basado en un hub. Para obtener más información, vea Tipos de proyectos.
Nota
Versiones del SDK: En este artículo se describe la instalación del SDK 1.x. Asegúrese de que los ejemplos que sigue coinciden con el paquete instalado. Cambie a la nueva documentación del portal de Foundry para ver el artículo de la versión 2.x.
| Versión del SDK | Versión del portal | Estado | paquete de Python |
|---|---|---|---|
| 2.x | Foundry (nuevo) | Estable | azure-ai-projects>=2.0.0 |
| 1.x | Foundry (clásico) | Estable | azure-ai-projects==1.0.0 |
La biblioteca cliente Azure AI Projects para Python es una biblioteca unificada que permite usar varias bibliotecas cliente juntas mediante la conexión a un único punto de conexión de proyecto.
Ejecute este comando para instalar los paquetes 1.x para proyectos clásicos de Foundry.
pip install openai azure-identity azure-ai-projects==1.0.0
| Versión del SDK | Versión del portal | Estado | paquete de Java |
|---|---|---|---|
| 1.x | Foundry clásico | Retirado | No hay ningún paquete Java compatible disponible para esta ruta de acceso clásica. Usa com.azure:azure-ai-projects:2.2.0 con un proyecto actual de Foundry. |
| Versión del SDK | Versión del portal | Estado | Paquete de JavaScript |
|---|---|---|---|
| 1.0.1 | Foundry clásico | Estable | @azure/ai-projects |
| Versión del SDK | Versión del portal | Estado | paquete de .NET |
|---|---|---|---|
| 1.1.0 (GA) | Foundry clásico | Estable | Azure.AI.Projects |
La ruta de acceso del SDK de Java para Foundry Classic se ha retirado. El SDK de proyecto clásico 1.x no alcanzó la disponibilidad general para Java y el paquete de versión preliminar retirado azure-ai-inference no es un reemplazo compatible.
Importante
No inicie ni migre el desarrollo de Java en la ruta clásica del SDK. Cambie a la guía actual del SDK de Foundry y utilice la biblioteca de cliente GA Azure AI Projects para Java con un proyecto actual de Foundry.
Para un proyecto actual de Foundry, añada la siguiente dependencia a su Maven pom.xml:
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-projects</artifactId>
<version>2.2.0</version>
</dependency>
La biblioteca cliente Azure AI Projects para JavaScript es una biblioteca unificada que permite usar varias bibliotecas cliente juntas mediante la conexión a un único punto de conexión de proyecto.
Ejecute este comando para instalar los paquetes de JavaScript 1.x para proyectos clásicos de Foundry.
npm install @azure/ai-projects@1.0.1 @azure/identity
La biblioteca cliente Azure AI Projects para .NET es una biblioteca unificada que permite usar varias bibliotecas cliente juntas mediante la conexión a un único punto de conexión de proyecto.
Ejecute estos comandos para agregar los paquetes 1.x Azure SDK de IA para proyectos clásicos de 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
Uso del SDK de Foundry
El SDK expone dos tipos de cliente porque Foundry y OpenAI tienen diferentes formas de API:
- Project client – Utilícelo para operaciones propias de Foundry en las que OpenAI no tiene ningún equivalente. Ejemplos: enumerar conexiones, recuperar propiedades del proyecto, habilitar el seguimiento.
-
Cliente compatible con OpenAI : se usa para la funcionalidad foundry que se basa en los conceptos de OpenAI. La API de respuestas, los agentes, las evaluaciones y el ajuste preciso usan patrones de solicitud y respuesta de estilo OpenAI. Este cliente también proporciona acceso a los modelos directos de Foundry (modelos noAzure-OpenAI hospedados en Foundry). El punto de conexión del proyecto gestiona este tráfico en la ruta
/openai.
La mayoría de las aplicaciones usan ambos clientes. Use el cliente del proyecto para configurar y configurar y, a continuación, use el cliente compatible con OpenAI para ejecutar agentes, evaluaciones y modelos de llamada (incluidos los modelos directos de Foundry).
Cree un cliente de proyecto:
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(),
)
Cree un cliente compatible con OpenAI desde el proyecto:
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)
Se ha retirado la ruta de primer éxito en Java para Foundry Classic. El ejemplo anterior azure-ai-inference no crea un cliente de proyecto clásico y usa una llamada API que no está disponible en esa versión del paquete.
Para el desarrollo en Java, utilice com.azure:azure-ai-projects:2.2.0 con un proyecto actual de Foundry y siga la guía actual del SDK de Foundry. La ruta actual del SDK no añade compatibilidad con Java a los proyectos clásicos de Foundry.
Cree un cliente de proyecto:
const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deployment = "gpt-4o";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
Cree un cliente compatible con OpenAI desde el proyecto:
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);
Cree un cliente de proyecto:
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());
Cree un cliente compatible con OpenAI desde el proyecto:
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);
Qué puede hacer con el SDK de Foundry
- modelos de Access Foundry, incluidos Azure OpenAI
- Uso del Servicio Foundry Agent
- Ejecución de evaluaciones en la nube
- Habilitación del seguimiento de aplicaciones
- Afina un modelo
- Obtención de puntos de conexión y claves para las herramientas de Foundry, la orquestación local y mucho más
Solución de problemas
Errores de autenticación
Si ve DefaultAzureCredential failed to retrieve a token:
Verify CLI de Azure se autentica:
az account show az login # if not logged inCompruebe la asignación de roles de RBAC:
Confirme que tiene al menos el rol de usuario de Foundry en el proyecto Foundry
Importante
Recientemente se ha cambiado el nombre de los roles RBAC de Foundry. Foundry User, Foundry Owner, Foundry Account Owner y Foundry Project Manager se llamaban anteriormente Usuario de Azure AI, Propietario de Azure AI, Propietario de la cuenta de Azure AI y Administrador de proyectos de Azure AI. Es posible que siga viendo los nombres anteriores en algunos lugares mientras se implementa el cambio de nombre. El cambio de nombre no modifica los identificadores de rol y los permisos principales.
Consulte Asignar roles de Azure
Para la identidad administrada en producción:
- Asegúrese de que la identidad administrada tiene asignado el rol adecuado.
- Consulte Configuración de identidades administradas.
Errores de configuración del punto de conexión
Si ve Connection refused o 404 Not Found:
- Comprobación de que los nombres de recursos y proyectos coinciden con la implementación real
-
Comprobar el formato de dirección URL del punto de conexión: debe ser
https://<resource-name>.services.ai.azure.com/api/projects/<project-name> -
Para subdominios personalizados: reemplace
<resource-name>por el subdominio personalizado.
Incompatibilidad de versiones del SDK
Si se produce un error en los ejemplos de código con AttributeError o ModuleNotFoundError:
Compruebe la versión del SDK:
pip show azure-ai-projects # Python npm list @azure/ai-projects # JavaScript dotnet list package # .NETReinstalar con marcas de versión correctas: consulte los comandos de instalación en cada sección de idioma anterior.
SDK de OpenAI
Use el SDK de OpenAI cuando desee la superficie completa de la API de OpenAI y la compatibilidad máxima del cliente. Este punto de conexión proporciona acceso a los modelos de Azure OpenAI y a los modelos directos de Foundry (a través de la API de finalizaciones de chat). No proporciona acceso a características específicas de Foundry, como agentes y evaluaciones.
En el fragmento de código siguiente se muestra cómo usar directamente el punto de conexión de Azure OpenAI /openai/v1.
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 obtener más información, consulte Azure lenguajes de programación compatibles con OpenAI. Salida 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 obtener más información, consulte Azure lenguajes de programación compatibles con OpenAI
Importante
Los elementos marcados (versión preliminar) de este artículo se encuentran actualmente en versión preliminar pública. Esta versión preliminar se proporciona sin un contrato de nivel de servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no se admitan o que tengan funcionalidades restringidas. Para obtener más información, vea Supplemental Terms of Use for Microsoft Azure Previews.
En el fragmento de código siguiente se muestra cómo usar directamente el punto de conexión de Azure OpenAI /openai/v1.
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 obtener más información sobre el uso del SDK de OpenAI, consulte Azure lenguajes de programación compatibles con 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 obtener más información sobre el uso del SDK de OpenAI, consulte Azure lenguajes de programación compatibles con OpenAI.
- Instale el paquete OpenAI: ejecute este comando para agregar la biblioteca cliente de OpenAI al proyecto 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 obtener más información sobre el uso del SDK de OpenAI, consulte Azure lenguajes de programación compatibles con OpenAI.
Marco de trabajo del agente
Microsoft Agent Framework es un SDK de código abierto para C#/.NET y Python que proporciona una orquestación multiagente unificada y abstracciones coherentes para crear agentes y sistemas multiagente. Es la capa de orquestación recomendada para los agentes hospedados en Foundry.
- Si anteriormente usaba AutoGen o Kernel semántico para la orquestación multiagente (coordinar varios agentes para trabajar juntos en tareas), considere El marco del agente como la capa de orquestación principal. Ayuda a evitar combinar varios SDK de orquestación que resuelven tareas de coordinación similares, lo que puede agregar abstracciones y dependencias en conflicto.
- Si ya tiene código de orquestación existente considerable, dependa de características específicas del producto o de los requisitos de migración complejos, evalúe esos requisitos antes de consolidarse en Agent Framework.
Ejecución del código como agente hospedado
La historia principal de los agentes basados en código en Foundry es Agentes hospedados. Escriba el agente con Agent Framework, empaquetelo como una imagen de contenedor o un archivo zip del código fuente y deje que Foundry lo ejecute con un punto de conexión administrado, el escalado automático en máquinas virtuales micro aisladas, una identidad del agente de Microsoft Entra dedicada, el estado de nivel de sesión y la observabilidad de un extremo a otro.
Los agentes hospedados son la ruta de acceso recomendada cuando desea un punto de conexión administrado por Foundry y direccionable de red al que pueden llamar otras aplicaciones o agentes. Consulte Implementación del primer agente hospedado.
Crear agentes mediante código fuera de Foundry con la API Responses
Si aloja su agente fuera de Foundry —en su propio proceso o infraestructura—, también puede usar Agent Framework para llamar directamente a la Responses API en el punto de conexión de su proyecto. Agent Framework se conecta a través del FoundryChatClient proveedor, que tiene como destino:
{project_endpoint}/openai/v1/responses
Si pasa por el punto de conexión del proyecto, en lugar de por un punto de conexión de OpenAI de nivel de recurso, su agente tendrá:
- Modelos de Foundry del catálogo (modelos directos de Azure OpenAI y Foundry) a través de una sola API.
- Herramientas de plataforma más allá del conjunto de herramientas de OpenAI, incluyendo búsqueda de archivos, intérprete de código, memoria, búsqueda web, servidores MCP, SharePoint, WorkIQ y Fabric IQ.
- Datos de ámbito de proyecto, autenticación de herramientas en nombre de (OBO) y seguimiento, filtros de contenido y configuración de identidad del proyecto.
Este patrón complementa a los agentes hospedados, no es una alternativa: el mismo código de Agent Framework puede llamar hoy a la API de Respuestas desde su propio proceso y empaquetarse más adelante como un agente hospedado, cuando desee un punto de conexión administrado por Foundry. Consulte Inicio rápido: Compilación de agentes mediante la API de respuestas.
Para ver una comparación completa de los tipos de agentes y las opciones de hospedaje, consulte ¿Qué es Microsoft Foundry Agent Service?.
SDK de herramientas de fundición
Foundry Tools (anteriormente Azure AI Services) son soluciones de punto precompiladas con SDK dedicados. Utilice los siguientes puntos de conexión para trabajar con las herramientas de Foundry.
¿Qué punto de conexión deberías utilizar?
Elija un punto de conexión en función de sus necesidades:
Utilice el punto de conexión de Azure AI Services para acceder a Visión por Computadora, Seguridad de Contenido, Inteligencia de Documentos, Lenguaje, Traducción y Herramientas de Token Foundry.
Punto de conexión de Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/
Nota
Los puntos de conexión utilizan el nombre del recurso o un subdominio personalizado. Si su organización configura un subdominio personalizado, reemplace por your-resource-nameyour-custom-subdomain en todos los ejemplos de puntos de conexión.
Si sus cargas de trabajo utilizan características en desuso de Lenguaje de Azure AI (por ejemplo, análisis de sentimientos, extracción de frases clave, resumen, vinculación de entidades, CLU o CQA), considere migrar a las alternativas de Microsoft Foundry. Para el nuevo desarrollo, considere la posibilidad de usar el SDK de Foundry o el punto de conexión compatible con OpenAI, como se ha descrito anteriormente en este artículo. Consulte Migrar de Language Studio a Microsoft Foundry.
En el caso de las herramientas de conversión de voz y traducción, use los puntos de conexión de las tablas siguientes. Reemplace los marcadores de posición por los nombres de recursos.
Puntos de conexión de voz
| Herramienta de fundición | Punto de conexión |
|---|---|
| Conversión de voz en texto (estándar) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Texto a voz (Neuronal) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Voz personalizada | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Puntos de conexión de traducción
| Herramienta de fundición | Punto de conexión |
|---|---|
| Traducción de texto | https://api.cognitive.microsofttranslator.com/ |
| Traducción de documentos | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Puntos de conexión de idioma
| Herramienta de fundición | Punto de conexión |
|---|---|
| Análisis de texto | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com |
Importante
El 20 de marzo de 2027, Azure Language Studio se retirará y migrará a Microsoft Foundry; todas las funcionalidades y futuras mejoras estarán disponibles en Microsoft Foundry.
El 31 de marzo de 2029, se retirarán las siguientes funcionalidades de lenguaje de Azure (finalización del soporte técnico). Antes de esa fecha, los usuarios deben migrar las cargas de trabajo existentes e incorporar nuevos proyectos a Microsoft modelos Foundry para mejorar la comprensión del lenguaje natural y la integración simplificada de aplicaciones:
- Extracción de frases clave
- Análisis de sentimiento y minería de opiniones
- Clasificación de texto personalizada
- Comprensión del Lenguaje Conversacional (CLU)
- Respuesta a preguntas personalizadas (CQA)
- Flujo de trabajo de orquestación
- Resumen (extractivo y abstracto, para documentos y conversaciones)
- Vinculación de entidades
Características principales con compatibilidad continua: detección de idioma, detección de PII, Text Analytics para salud, NER preconstruido y NER personalizado.
Para obtener opciones de migración, consulte Migrate de Language Studio a Microsoft Foundry.