Límites, cuotas y soporte técnico regional del servicio Foundry Agent

Foundry Agent Service aplica cuotas y límites en artefactos del agente, cargas de archivos, mensajes y registros de herramientas. Comprender estos límites le ayuda a diseñar aplicaciones que se escalan sin alcanzar los límites del servicio. En este artículo se enumeran los límites predeterminados, las regiones admitidas, los modelos compatibles y las instrucciones para controlar los errores de límite.

Nota

El servicio de agente de Foundry está disponible con carácter general (GA). Algunas subfunciones están en versión preliminar pública y pueden tener restricciones diferentes.

Los agentes de voz permiten conversaciones por voz en tiempo real. La disponibilidad depende de la región, el modelo seleccionado, las características de audio, el canal y las características de versión preliminar habilitadas. Para la configuración del modelo, consulte Configuración de un agente de voz. Para ver las opciones de publicación, consulte Publicación y conexión de canales del agente de voz.

Requisitos previos

  • Una suscripción Azure.
  • Un proyecto Microsoft Foundry.
  • Un modelo desplegado compatible con Agent Service. La disponibilidad del modelo y la región pueden variar.

Regiones soportadas

En la tabla siguiente se muestra la compatibilidad regional con la API de respuestas, los agentes y los agentes basados en voz (versión preliminar). También se muestra compatibilidad con intervalos de direcciones IP de clase A privados.

En el caso de los agentes basados en voz, la región debe admitir el servicio del agente y las funcionalidades necesarias de Voice Live para el modelo y el canal seleccionados.

Region API de respuestas Agentes Agentes basados en voz (versión preliminar) Red virtual privada
Australia East Sí Sí Sí Sí
Sur de Brasil Sí Sí Sí Sí
Canada Central Sí Sí Sí Sí
Este de Canadá Sí Sí Sí Sí
Central US Sí Sí Sí Sí
East US Sí Sí Sí Sí
Este de EE. UU. 2 Sí Sí Sí Sí
Centro de Francia Sí Sí Sí Sí
Centro-oeste de Alemania Sí Sí Sí Sí
Norte de Italia Sí Sí Sí Sí
Japón Oriental Sí Sí Sí Sí
Oeste de Japón Sí Sí Sí Sí
Korea Central Sí Sí Sí Sí
Centro-Norte de EE. UU Sí Sí Sí Sí
Norway East Sí Sí Sí Sí
Poland Central Sí Sí No Sí
Norte de Sudáfrica Sí Sí Sí Sí
Centro-sur de EE. UU. Sí Sí Sí Sí
Sudeste Asiático Sí Sí Sí Sí
South India Sí Sí Sí Sí
Centro de España Sí Sí No Sí
Centro de Suecia Sí Sí Sí Sí
Norte de Suiza Sí Sí Sí Sí
Switzerland West Sí Sí Sí Sí
Norte de Emiratos Árabes Unidos Sí Sí Sí Sí
UK South Sí Sí Sí Sí
Centro-oeste de EE. UU. Sí Sí Sí Sí
West Europe Sí Sí Sí Sí
West US Sí Sí Sí Sí
Oeste de EE. UU. 3 Sí Sí Sí Sí

Algunos modelos de Azure OpenAI no están disponibles en todas las regiones. Para obtener más información, consulte Disponibilidad por región de los Modelos de Foundry vendidos por Azure.

Importante

No todas las herramientas están disponibles en todas las regiones. Por ejemplo, la búsqueda de archivos no está disponible en Norte de Italia y Sur de Brasil. Para obtener la matriz completa de herramientas por región, consulte Compatibilidad de herramientas por región y modelo.

Soporte regional para redes privadas

Cuando se usa una configuración de red privada, como un agente estándar protegido por red, se aplican los siguientes requisitos regionales:

  • El recurso de Foundry y la región de la red virtual. Debe implementar el recurso Foundry en la misma región que su red virtual. Puede implementar otros recursos de Azure, como Azure Cosmos DB, Búsqueda de Azure AI y Azure Storage, en diferentes regiones. Tenga en cuenta las implicaciones de costos de las implementaciones entre regiones.
  • Fundamentos con Bing Search. Solo se admiten las siguientes regiones: Oeste de Europa, Este de Canadá, Norte de Suiza, Centro de España, Norte de Emiratos Árabes Unidos, Centro de Corea del Sur, Centro de Polonia, Sudeste asiático, Oeste de EE. UU., Oeste de EE. UU. 2, Oeste de EE. UU., Este de EE. UU. 2, Centro de EE. UU., Centro de Ee. UU., Centro de Japón, Sur de Japón, Sur de Reino Unido, Centro de Francia, Este de Noruega, Este de Australia, Centro de Canadá, Centro de Suecia, Norte de Sudáfrica, Norte de Italia, Sur de Brasil.

Para obtener más información, consulte Uso de una red virtual con el servicio del agente Foundry.

Modelos compatibles

Agent Service es compatible con los modelos de Azure OpenAI y varios modelos de Foundry comercializados por Azure. La disponibilidad del modelo puede cambiar con el tiempo y varía según la región. Para ver la lista completa de modelos que puede implementar para su proyecto y su región, use la experiencia de modelos del portal Foundry.

Nubes soberanas

Foundry Agent Service también está disponible en Azure Government (US Gov Virginia y US Gov Arizona) con un subconjunto de tipos y herramientas de agente. Para obtener la lista completa de las características admitidas, consulte Disponibilidad de características del servicio Foundry Agent en Azure Government.

Compatibilidad de herramientas por región y modelo

La región y el modelo determinan qué herramientas están disponibles para el agente. En las tablas siguientes, Sí significa totalmente compatible, No significa no admitido y Limitado significa compatibilidad parcial que varía según la configuración de la herramienta. Consulte la documentación de herramientas individuales para obtener más información.

En la tabla siguiente se muestran las herramientas disponibles en cada región admitida. Esta tabla solo tiene en cuenta la disponibilidad del servicio, por lo que asegúrese de que el modelo que desea usar también está disponible en la misma región.

Haga clic para expandir
Region Agent2Agent Búsqueda de Azure AI Automatización del explorador Intérprete de código Uso del ordenador Agente de datos de Fabric Búsqueda de archivos Function Fundamentos de la búsqueda personalizada de Bing Fundamentación con Bing Search Generación de imágenes MCP OpenAPI SharePoint Web Search
Australia East Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Sur de Brasil Sí Sí Sí Sí no Sí no no Sí Sí Sí Sí Sí Sí Sí
Canada Central Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Este de Canadá Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Central US Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
East US Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Este de EE. UU. 2 Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Centro de Francia Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Centro-oeste de Alemania Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Norte de Italia Sí Sí Sí Sí no Sí no Sí Sí Sí Sí Sí Sí Sí Sí
Japón Oriental Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Oeste de Japón Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Korea Central Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Centro-Norte de EE. UU Sí Sí Sí Sí no Sí Sí no Sí Sí Sí Sí Sí Sí Sí
Norway East Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Poland Central Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Norte de Sudáfrica Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Centro-sur de EE. UU. Sí Sí Sí Sí no Sí Sí no Sí Sí Sí Sí Sí Sí Sí
Sudeste Asiático Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
South India Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Centro de España Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Centro de Suecia Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Norte de Suiza Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Switzerland West Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Norte de Emiratos Árabes Unidos Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
UK South Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
Centro-oeste de EE. UU. Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
West Europe Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí
West US Sí Sí Sí Sí no Sí Sí no Sí Sí Sí Sí Sí Sí Sí
Oeste de EE. UU. 3 Sí Sí Sí Sí no Sí Sí Sí Sí Sí Sí Sí Sí Sí Sí

En la tabla siguiente se muestran las herramientas que admite cada modelo. Para la herramienta de generación de imágenes, necesita tanto el modelo de gpt-image-1 como un modelo de lenguaje grande (LLM) que actúe como orquestador, ambos en el mismo proyecto de Microsoft Foundry.

Haga clic para expandir
Modelo Agent2Agent Búsqueda de Azure AI Azure Functions Fundamentación de Bing Custom Fundamentos de la búsqueda de Bing Automatización del explorador Intérprete de código Uso del ordenador Agente de datos de Fabric Búsqueda de archivos Functions Generación de imágenes MCP OpenAPI SharePoint Web Search Work IQ (versión preliminar)
Cohere-command-r No No No No No No Sí No No Sí No No No No No No No
Cohere-command-r-plus No No No No No No Sí No No Sí No No No No No No No
DeepSeek-R1-0528 No No No No No No Sí No No Sí No No No No No No No
DeepSeek-V3-0324 No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
DeepSeek-V3.1 No No No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
FW-DeepSeek-V3.1 No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-DeepSeek-V3.2 No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-GLM-4.7 No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-GLM-5 No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-GLM-5.1 No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-GPT-OSS-120B No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-Kimi-K2-Instruct-0905 No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-Kimi-K2-Pensamiento No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-Kimi-K2.5 No No No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-Kimi-K2.6 No No No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-MiniMax-M2.5 No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-Qwen3.5-122B-A10B No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
FW-Qwen3.5-397B-A17B No Sí No No No No Sí No Sí Sí No No Sí Sí No Sí Sí
GROK-4-20-RAZONAMIENTO No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
Llama-3.3-70B-Instruct No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
Llama-4-Maverick-17B-128E-Instruct-FP8 No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
Llama-4-Scout-17B-16E-Instruct No No No No No No Sí No No Sí No No No No No No No
MAI-DS-R1 Sí No No No No Sí Sí No No Sí Sí No Sí No No No No
Meta-Llama-3.1-405B-Instruct No No No No No No Sí No No Sí No No No No No No No
Mistral-large-2407 No No No No No No Sí No No Sí No No No No No No No
codex-mini No No No No No No Sí No No Sí No No No No No No No
computer-use-preview No No No No No No No Sí No No No No No No No No No
gpt-35-turbo No No No No No No Sí No No Sí No No No No No No No
gpt-4 No No No No No No Sí No No Sí No No No No No No Sí
gpt-4.1 Sí Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
gpt-4.1-mini Sí Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
gpt-4.1-nano Sí Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
gpt-4, 0125-versión preliminar No No No No No No Sí No No Sí No No No No No No No
gpt-4o Sí Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
gpt-4o-mini Sí No No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
gpt-5 Sí Sí No Sí Sí Sí Sí No Sí Sí Sí Sí Sí Sí Sí Sí Sí
gpt-5-chat No No No No No No Sí No No Sí No No No No No No Sí
gpt-5-codex No No No No No No Sí No No Sí No No Sí No No No Sí
gpt-5-mini No No No No No No Sí No No Sí No No Sí No No Sí Sí
gpt-5-nano No No No No No No Sí No No Sí No No No No No No Sí
gpt-5-pro No No No No No No Sí No No Sí No No No No No No No
gpt-5.1 No Sí Sí No Sí No Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
gpt-5.1-chat No No No No No No Sí No No Sí No No No No No No No
gpt-5.1-codex No No No No No No Sí No No Sí No No Sí No No No Sí
gpt-5.1-codex-max No No No No No No Sí No No Sí No No No No No No No
gpt-5.1-codex-mini No No No No No No Sí No No Sí No No No No No No No
gpt-5.2 No Sí Sí No Sí No Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
gpt-5.2-chat Sí Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí No Sí Sí
gpt-5.2-codex No No No No No No Sí No No Sí No No Sí No No No Sí
gpt-5.3-chat Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-5.3-codex Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-5.4 Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-5.4-mini Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-5.4-nano Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-5.4-pro Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-5.5 Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-chat-latest Sí Sí No Sí Sí Sí Sí No Sí Sí No No Sí Sí Sí Sí Sí
gpt-oss-120b No No No No No No Sí No No Sí Sí No Sí No No No Sí
grok-3 No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
grok-3-mini No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
grok-4 No No No No No No Sí No No Sí No No No No No No No
grok-4-1-fast-non-reasoning No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
grok-4-1-fast-reasoning No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
grok-4-20-non-reasoning No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
grok-4-20-razonamiento No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
grok-4-fast-non-reasoning No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
grok-4-fast-reasoning No Sí No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí Sí Sí
mistral-small-2503 No No No No No No Sí No No Sí No No No No No No No
model-router No No No Sí Sí Sí Sí No Sí Sí Sí No Sí Sí Sí No Sí
o1 No Sí No Sí No Sí Sí No No Sí Sí No Sí No Sí Sí Sí
o1-mini No No No No No No Sí No No Sí No No No No No No No
o1-preview No No No No No No Sí No No Sí No No No No No No No
o3 Sí Sí No Sí No Sí Sí No Sí Sí Sí No Sí Sí No Sí Sí
o3-deep-research No No No No No No No No No No No No Sí No No Sí Sí
o3-mini Sí No No Sí Sí Sí Sí No Sí Sí No No No No No No Sí
o3-pro No No No No No No Sí No No Sí No No No No No No No
o4-mini Sí No No Sí Sí Sí Sí No Sí Sí Sí No Sí No Sí Sí Sí

Solución de problemas

Un modelo o una versión no están disponibles en su región

  • Confirme que ha seleccionado la pestaña derecha para el tipo de implementación (estándar global frente a aprovisionado).
  • Pruebe otra región que admita el modelo y la API de respuestas.
  • Si usa los modelos gpt-5, se requiere el registro. El acceso se concede según los criterios de idoneidad de Microsoft.

Una herramienta no está disponible en su región

  • No todas las herramientas se admiten en todas las regiones. Por ejemplo, la búsqueda de archivos no está disponible en Norte de Italia y Sur de Brasil.
  • Compruebe la compatibilidad de la herramienta por región y tabla de modelos para confirmar la disponibilidad antes de implementarla.
  • Si una herramienta no está disponible, elija una región admitida o use otra herramienta.

Error en la implementación del rendimiento aprovisionado

El agente recibe errores de límite de velocidad (429)

  • Si el código de error es session_quota_exceeded, detenga las sesiones que no necesitan proceso activo, elimine las sesiones cuyo estado ya no sea necesario o solicite un aumento del límite.
  • Si el código de error es regional_session_quota_exceeded, vuelva a intentarlo con retroceso exponencial o use otra región. Si el error persiste, cree una solicitud de Soporte técnico de Azure.
  • Implemente el retroceso exponencial con variación aleatoria en la lógica de reintentos de la aplicación.
  • Para cargas de trabajo de alto volumen sostenidas, considere realizar implementaciones de volumen de procesamiento aprovisionado.
  • Revise Cuotas y límites de Azure OpenAI para los tokens por minuto y solicitudes por minuto de la implementación.

Cómo Agent Service aplica límites

Foundry Agent Service aplica límites en dos lugares:

  • Límites del servicio del agente. Límites para artefactos de agente y subproceso, como cargas de archivos, datos adjuntos del almacén de vectores, recuentos de mensajes y registro de herramientas.
  • Límites del modelo. Cuotas y límites de velocidad para las implementaciones del modelo a las que llaman los agentes.

Los artefactos a los que se aplican estos límites se almacenan en almacenamiento administrado por Microsoft o en sus propios recursos de Azure, según su configuración.

Dónde almacena Agent Service sus datos

Donde residen los datos del agente depende de la opción de configuración que elija. La opción de configuración también determina a qué recursos se aplican las cuotas y los límites de este artículo.

  • La configuración básica almacena el estado del agente en un almacenamiento seguro administrado Microsoft que está separado lógicamente. Este es el valor predeterminado cuando no configura sus propios recursos.
  • La configuración estándar almacena el estado del agente en los recursos de Azure de un solo inquilino administrados por el cliente en su propia suscripción, lo que le proporciona control total sobre la residencia y el acceso a los datos.
Tipo de dato Configuración básica Configuración estándar
Archivos, cargas y datos adjuntos almacenamiento administrado Microsoft Azure Storage (almacenamiento de blobs)
Almacenes de vectores, incrustaciones e índices de recuperación búsqueda vectorial administrada por Microsoft Búsqueda de Azure AI
Hilos, historial de conversaciones, mensajes y definiciones de agentes almacenamiento administrado Microsoft Azure Cosmos DB (la base de datos de Azure Cosmos)

La configuración de funcionalidad indica al servicio del agente dónde almacenar y procesar cargas de archivos, almacenes vectoriales y historial de conversaciones. Para almacenar datos del agente en sus propios recursos, consulte Configuración del agente estándar.

Los puntos de conexión del servicio foundry Agent son regionales y los datos se almacenan en la misma región que el punto de conexión. Para obtener más información, consulte la documentación de residencia de datos Azure.

Límites de servicio predeterminados

El servicio de agente aplica un límite por suscripción a las sesiones simultáneas del agente hospedado en cada región. Este límite incluye las sesiones de todas las cuentas y proyectos de Foundry de la suscripción y la región. Una sesión se contabiliza dentro del cupo mientras se están aprovisionando sus recursos de procesamiento o está en ejecución. Una sesión inactiva o detenida conserva su estado persistente, pero no cuenta para la cuota. Reanudarlo requiere cuota disponible.

Sesiones simultáneas de agentes hospedados Regions
2.000 Centro de Canadá, Este de EE. UU. 2, Este de Japón, Centro-norte de EE. UU., Norte de Sudáfrica, Sudeste asiático y Centro de Suecia
1,000 Todas las demás regiones en las que están disponibles los agentes hospedados

Estos valores son los límites predeterminados. Para solicitar un límite de sesión simultáneo mayor, cree una solicitud de Soporte técnico de Azure. En la solicitud, especifique la suscripción, la región y el número esperado de sesiones simultáneas. Los aumentos de límite dependen de la capacidad regional disponible.

En la tabla siguiente se enumeran los límites predeterminados aplicados por el servicio del agente. Estos límites se aplican a todos los proyectos de Foundry independientemente del tipo de suscripción o región.

Nombre del límite Valor de límite
Número máximo de archivos por agente o subproceso 10.000
Tamaño máximo de archivo que se puede subir para los agentes de indicaciones 512 MB
Tamaño máximo para todos los archivos cargados para agentes 300 GB
Tamaño máximo de archivo en tokens para adjuntar a un almacén vectorial 2000 000 tokens
Número máximo de mensajes por subproceso 100,000
Tamaño máximo de text contenido por mensaje 1500 000 caracteres
Número máximo de herramientas registradas por agente 128
Número máximo de versiones por agente 1,000

Los límites del servicio del agente de esta tabla se fijan y se aplican uniformemente en todos los tipos de suscripción. La limitación de frecuencia para las llamadas al modelo se aplica a nivel de implementación del modelo; consulte Cuotas y límites de Azure OpenAI para conocer los límites de frecuencia específicos de cada modelo.

Los agentes basados en voz también pueden incurrir en límites de sesión de voz, audio, canal o Voice Live.

Límite o configuración del agente de voz Value
Duración máxima de la sesión de voz 60 minutos
Conversaciones de voz almacenadas y retención de audio administrada por Microsoft 60 días

Limitar la referencia al error

Cuando se supera un límite, el servicio del agente devuelve un error. Controle estos errores correctamente en la aplicación.

Escenario de error Estado HTTP Código de error Acción recomendada
Archivo demasiado grande 400 file_size_exceeded Dividir contenido en archivos más pequeños
Límite de tokens en el almacenamiento de vectores 400 token_limit_exceeded Reducir el contenido del archivo o dividir archivos
Límite de mensajes del hilo 400 message_limit_exceeded Crear un nuevo hilo
Contenido del mensaje demasiado grande 400 content_size_exceeded Uso de la búsqueda de archivos para contenido grande
Demasiadas herramientas 400 tool_limit_exceeded Eliminación de herramientas sin usar
Límite de tasa superado 429 rate_limit_exceeded Implementar retroceso exponencial
Se ha superado la cuota de sesiones simultáneas 429 session_quota_exceeded Detener sesiones que no necesitan proceso activo, eliminar sesiones cuyo estado ya no sea necesario o solicitar un aumento del límite
Se ha superado la capacidad regional de sesiones 429 regional_session_quota_exceeded Reintentar con retroceso exponencial o usar otra región
La subred delegada no tiene direcciones IP disponibles 429 subnet_exhausted Detener sesiones que no necesitan proceso activo o configurar una subred más grande
Demasiadas versiones del agente 400 UserError Elimine versiones anteriores y, a continuación, cree una nueva versión. Este error es terminal: reintentar la misma llamada de creación sin eliminar versiones sigue fallando.

Por ejemplo:

  • El archivo supera el tamaño máximo. Se produce un error al cargar el archivo. Divida el contenido en archivos más pequeños o reduzca el tamaño del archivo antes de cargarlo.
  • Límite de tokens de almacenamiento vectorial. Si el archivo supera el límite de tokens, se produce un error al adjuntar un archivo a un almacén de vectores. Reduzca el contenido del archivo o divida en varios archivos.
  • Límite de mensajes de hilo. Se puede producir un error al agregar mensajes después de que un subproceso alcance el límite de mensajes. Crear un nuevo hilo para una nueva conversación, o archivar y rotar hilos como parte del diseño de su aplicación.
  • Tamaño del contenido del mensaje. La creación de un mensaje puede producir un error si el text contenido es demasiado grande. Envíe mensajes más pequeños o mueva contenido grande a archivos y use la búsqueda de archivos.
  • Límite de registro de herramientas. La creación o actualización de un agente puede fallar si registra demasiadas herramientas. Registre solo las herramientas que necesita y prefiera menos herramientas reutilizables.
  • Se superó el límite de velocidad. Las llamadas a la API para la implementación del modelo están limitadas. Implemente el retroceso exponencial con variación aleatoria.
  • Se ha superado el número máximo de sesiones simultáneas. Se produce un error al crear o reanudar una sesión del agente hospedado cuando la suscripción alcanza su límite de sesión simultáneo en la región. Elimine sesiones sin usar o solicite un aumento del límite.
  • Se ha superado la capacidad de sesiones de la región. Se produce un error al crear o reanudar una sesión del agente hospedado cuando la región no tiene capacidad suficiente. Vuelva a intentarlo con retroceso exponencial o use otra región.
  • Se ha superado el número máximo de sesiones simultáneas. Se produce un error al crear o reanudar una sesión del agente hospedado cuando la suscripción alcanza su límite de sesión simultáneo en la región. Detenga las sesiones que no necesiten proceso activo, elimine sesiones cuyo estado persistente ya no sea necesario o solicite un aumento del límite.
  • Se ha superado la capacidad de sesiones de la región. Se produce un error al crear o reanudar una sesión del agente hospedado cuando la región no tiene capacidad suficiente. Vuelva a intentarlo con retroceso exponencial o use otra región.
  • La subred delegada no tiene direcciones IP disponibles. Error al crear o reanudar una sesión de agente alojado cuando la subred delegada se queda sin direcciones. Detenga las sesiones que no necesiten proceso activo o configure una subred más grande antes de volver a intentarlo.
  • Límite de versión del agente. Se produce un error al crear una versión una vez que un agente alcanza las 1000 versiones. El servicio devuelve HTTP 400 con el mensaje Maximum number of agent versions (1000) exceeded. Please delete older versions before creating new ones. Este error es terminal, no uno transitorio, por lo que no vuelva a intentar la misma llamada. Elimine las versiones que ya no necesite liberar capacidad inmediatamente y, a continuación, cree la nueva versión.

Para escenarios de búsqueda de archivos, consulte Almacenes de vectores para búsqueda de archivos para obtener instrucciones sobre cómo administrar el crecimiento del almacén de vectores.

Procedimientos recomendados para mantenerse dentro de los límites

Use los procedimientos siguientes para reducir los errores relacionados con el límite:

  • Mantenga los archivos pequeños y centrados. Es preferible utilizar varios documentos más pequeños en lugar de un único documento grande.
  • Evite mensajes muy grandes. Coloque contenido largo en archivos cargados y búsquelo mediante la búsqueda de archivos.
  • Planificar conversaciones largas. Tratar los hilos como historial de la conversación y cambiar a hilos nuevos cuando las conversaciones se vuelvan muy largas.
  • Registre solo las herramientas necesarias. Quite las herramientas sin usar de las definiciones del agente.
  • Administrar versiones del agente. Cada agente permite hasta 1000 versiones. Elimine o rote las versiones que ya no necesite como parte de su flujo de implementación para mantenerse muy por debajo del límite, y no vuelva a intentar las llamadas de creación que fallen con el error de límite de versiones hasta que libere capacidad.
  • Supervise las tendencias de uso. Realice un seguimiento de la actividad del agente mediante métricas del servicio Foundry Agent para identificar el crecimiento antes de alcanzar los límites.

Cuotas de modelos y límites de tasa

Los agentes siguen las cuotas y los límites de tasa para las implementaciones del modelo que usan.

Para conocer las cuotas y límites actuales del modelo, consulte:

Para ver o solicitar más cuotas de modelos, consulte Administración y aumento de cuotas de recursos con Microsoft Foundry (proyectos de Foundry).

Solicitar un aumento del límite

Los límites de este artículo son valores predeterminados para Foundry Agent Service. Si la carga de trabajo requiere límites mayores:

  • Cuotas de modelo. Puede solicitar aumentos para las cuotas de implementación del modelo. Consulte Administrar y aumentar las cuotas de recursos con Microsoft Foundry.
  • Cuotas de sesiones de agentes hospedados. Para solicitar un límite de sesión simultáneo mayor, cree una solicitud de Soporte técnico de Azure. Especifique la suscripción, la región y el número esperado de sesiones simultáneas.
  • Límites del servicio del agente. Los límites de archivos, mensajes y herramientas enumerados en este artículo son límites fijos de servicio y no se pueden aumentar. Diseñe la aplicación para que funcione dentro de estas restricciones mediante los procedimientos recomendados descritos anteriormente.

Contenido relacionado

  • Se actualizó por última vez el