Crear modelo personalizado usando Microsoft Entra ID
- Última actualización2025/10/16
Este tema describe los pasos para configurar la autenticación de Microsoft Entra ID (anteriormente Azure AD) para definiciones de modelos personalizados dentro de AI Agent Studio, lo que permite la integración fluida de sus modelos con Automation 360.
Entra ID solo es compatible mediante autenticación OAuth2, y este método es obligatorio al integrarse con modelos alojados por Microsoft que requieren tókenes de acceso basados en Entra.
- Utilice Entra ID cuando el proveedor del modelo de destino solo admita autenticación OAuth2.
- Este suele ser el caso de los servicios alojados en Azure cuando la autenticación mediante clave API no puede usarse en paralelo con OAuth2.
- Por ejemplo, los modelos de Azure OpenAI usan autenticación con clave de API de forma predeterminada, pero si sus requisitos de seguridad exigen OAuth2 a través de Entra ID, debe configurar el modelo mediante la ruta de definición de modelo personalizada.
Para descargar y usar la colección de Postman (ejemplo de Entra ID), haga clic en este enlace Colección de Postman: ejemplo de Entra ID.
Antes de empezar
- Una Cuenta de Azure con Entra ID habilitado. Recopile los detalles requeridos:
- ID de cliente
- Secreto del cliente
- URL de autorización
- URL del token
- Configure una conexión OAuth utilizando Entra ID. Para obtener más información, consulte Configuración de la identificación de Microsoft Entra.
¿Por qué usar un modelo personalizado y Entra ID?
Azure OpenAI es compatible con autenticación mediante clave API en la interfaz de usuario; si necesita OAuth2/Entra ID en su lugar, defínalo a través de la API de modelo personalizado porque un proveedor solo puede exponer un mecanismo de autenticación en la interfaz de usuario a la vez.
Procedimiento
Definición de modelo personalizado utilizando Entra ID
Aquí tiene un ejemplo simplificado para una implementación de Azure OpenAI GPT-4.1 mini, usando Entra OAuth2:
POST https:/{{ControlRoomURL}}/gai/prompttools/v1/custommodel
Cuerpo de la solicitud:
{
"name": "AAI Docs Example - Entra",
"version": "0",
"authAction": {
"authType": "OAUTH2",
"oAuth": {
"location": "header",
"keyName": "Authorization",
"prefix": "Bearer "
}
},
"apiType": "REST",
"actions": [
{
"name": "gpt-4.1-mini",
"displayName": "GPT-4.1 mini",
"description": "GPT-4.1 mini provides a balance between intelligence, speed, and cost that makes it an attractive model for many use cases.",
"method": "POST",
"uri": "https://{resourceName}.openai.azure.com/openai/deployments/{deployment}/chat/completions?api-version={apiVersion}",
"params": [
{
"type": "PATH_PARAM",
"attribute": [
{
"name": "resourceName",
"label": "Resource Name",
"value": {
"type": "TEXT",
"string": "genaitemplateplatformeastca"
}
}
]
},
{
"type": "PATH_PARAM",
"attribute": [
{
"name": "deployment",
"label": "Deployment",
"value": {
"type": "TEXT",
"string": "deploy-gpt-4.1"
}
}
]
},
{
"type": "PATH_PARAM",
"attribute": [
{
"name": "apiVersion",
"label": "API Version",
"value": {
"type": "TEXT",
"string": "2025-01-01-preview"
}
}
]
}
],
"request": {
"raw": {
"body": "{\"model\": \"gpt-4.1\",\"messages\":[{\"role\":\"system\",\"content\":\"system prompt\"},{\"role\":\"user\",\"content\":\"some prompt query\"}],\"max_completion_tokens\":500}",
"variables": [
{
"path": "$.max_completion_tokens",
"attribute": {
"name": "max_completion_tokens",
"label": "Max tokens",
"value": {
"type": "INTEGER",
"number": "2048"
},
"annotations": [
"MODEL_PARAMETER"
],
"canonicalName": "choices[0].completionTokens"
}
},
{
"path": "$.messages[1].content",
"attribute": {
"name": "prompt",
"label": "prompt",
"value": {
"type": "TEXT"
},
"annotations": [
"PROMPT_QUERY"
]
}
},
{
"path": "$.messages[0].content",
"attribute": {
"name": "systemPrompt",
"label": "System Prompt",
"value": {
"type": "TEXT"
},
"annotations": [
"SYSTEM_PROMPT_MESSAGE"
]
}
}
]
}
},
"response": {
"body": "{\n \"id\": \"chatcmpl-APwQdLa9WCQAdZg0dO5OjGr2ER4sX\",\n \"object\": \"chat.completion\",\n \"created\": 1730746163,\n \"model\": \"o3-mini-2025-01-31\",\n \"choices\": [\n {\n \"index\": 0,\n \"message\": {\n \"role\": \"assistant\",\n \"content\": \"Sure! They are one of the most mysterious and exciting objects in space.\",\n \"refusal\": null\n },\n \"finish_reason\": \"stop\"\n }\n ],\n \"usage\": {\n \"prompt_tokens\": 17,\n \"completion_tokens\": 959,\n \"total_tokens\": 976,\n \"prompt_tokens_details\": {\n \"cached_tokens\": 0\n },\n \"completion_tokens_details\": {\n \"reasoning_tokens\": 64\n }\n },\n \"system_fingerprint\": \"fp_35c19d48ca\"\n}",
"variables": [
{
"path": "$.usage.completion_tokens",
"attribute": {
"name": "completion_tokens",
"label": "completion_tokens",
"value": {
"type": "INTEGER"
},
"annotations": [
"RESPONSE_PARAMETER"
],
"canonicalName": "choices[0].completionTokens"
}
},
{
"path": "$.choices[0].message.content",
"attribute": {
"name": "content",
"label": "content",
"value": {
"type": "TEXT",
"string": "Some response from LLM"
},
"annotations": [
"RESPONSE_PARAMETER"
],
"canonicalName": "choices[0].value"
}
},
{
"path": "$.model",
"attribute": {
"name": "model",
"label": "model",
"value": {
"type": "TEXT"
},
"annotations": [
"RESPONSE_PARAMETER"
],
"canonicalName": "model_name"
}
},
{
"path": "$.usage.prompt_tokens",
"attribute": {
"name": "prompt_tokens",
"label": "prompt_tokens",
"value": {
"type": "INTEGER"
},
"annotations": [
"RESPONSE_PARAMETER"
],
"canonicalName": "choices[0].promptTokens"
}
},
{
"path": "$.usage.total_tokens",
"attribute": {
"name": "total_tokens",
"label": "total_tokens",
"value": {
"type": "INTEGER"
},
"annotations": [
"RESPONSE_PARAMETER"
],
"canonicalName": "choices[0].totalTokens"
}
}
]
}
}
]
}