Procedimientos recomendados de herramientas para Microsoft servicio del agente foundry

Al compilar agentes en Microsoft servicio de agente de Foundry, las herramientas amplían lo que el agente puede hacer, recuperando información, llamando a las API y conectándose a servicios externos. Este artículo le ayuda a configurar herramientas de forma eficaz, controlar cuándo los llama el agente y mantener los datos seguros.

Propina

En las instrucciones del agente, describa para qué sirve cada herramienta y cuándo usarla. Por ejemplo:

When you need information from my indexed documents, use File Search. When you need to call an API, use the OpenAPI tool. When a tool call fails or returns no results, explain what happened and ask a follow-up question.

Requisitos previos

Acceso a un proyecto foundry en el portal de Foundry con el rol Azure AI Developer o permisos equivalentes.
Un modelo implementado en el mismo proyecto.
Las conexiones necesarias configuradas para las herramientas que planea usar (por ejemplo, Búsqueda de Azure AI, SharePoint o Bing grounding).

Configuración y validación del uso de herramientas

Configure herramientas y conexiones en el catálogo de herramientas de Foundry. Consulte Detección y administración de herramientas en el catálogo de herramientas foundry (versión preliminar).
Revise los seguimientos de ejecución para confirmar cuándo el agente llama a las herramientas y para inspeccionar las entradas y salidas de la herramienta. Para la configuración de seguimiento de un extremo a otro, consulte Seguimiento de la aplicación.

Mejora de la confiabilidad de las llamadas a herramientas

Control de llamadas a herramientas con `tool_choice`

Se usa tool_choice para el control más determinista sobre las llamadas a herramientas.

auto: el modelo decide si se debe llamar a herramientas.
required: el modelo debe llamar a una o varias herramientas.
none: el modelo no llama a herramientas.

Para obtener más información, consulte tool_choice en Rest del proyecto Foundry (versión preliminar).

Escribir instrucciones de herramientas eficaces

Mantenga instrucciones específicas y coherentes con la configuración de la herramienta.
Indique al modelo para qué sirve cada herramienta.
Si tiene varias herramientas que se superponen, agregue una regla de decisión (por ejemplo, "Usar búsqueda de archivos antes de buscar contenido interno").

Uso seguro de herramientas

Las herramientas envían y reciben datos fuera del modelo. Reduzca los riesgos de seguridad y privacidad con estas prácticas:

Trate las salidas de la herramienta como entrada que no son de confianza y valide los valores críticos antes de actuar en ellas.
Envíe solo la información necesaria para completar la tarea.
No incluya claves, tokens u otras credenciales en mensajes.
Evite registrar secretos en seguimientos o registros de aplicaciones.
Si se conecta a servidores MCP que no son de servicios Microsoft (por ejemplo, servidores MCP de terceros), revise las consideraciones de Discover y administre herramientas en el catálogo de herramientas foundry (versión preliminar).
Si necesita el enrutamiento centralizado y la aplicación de directivas para las herramientas de MCP, consulte Gobernanza de herramientas con AI Gateway (versión preliminar).

Compatibilidad de herramientas por región y modelo

La región y el modelo determinan qué herramientas están disponibles para el agente.

Nota

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 muestra la disponibilidad de las herramientas por región.

Nota

Esta tabla de disponibilidad de región solo tiene en cuenta la disponibilidad del servicio. Debe asegurarse de que el modelo que desea usar también está disponible en la misma región.

Nombre de la región	Agent2Agent	Búsqueda de Azure AI	Automatización del explorador	Intérprete de código	Uso del equipo	agente de datos de Fabric	Búsqueda de archivos	Función	Puesta en tierra con Bing Custom Search	Puesta en tierra con Bing Search	Generación de imágenes	MCP	OpenAPI	SharePoint	Búsqueda web
australiaeast	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
brazilsouth	Sí	Sí	Sí	Sí	No	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí
canadaeast	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
eastus	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
eastus2	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
francecentral	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
alemaniawestcentral	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
italynorth	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
japaneast	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
koreacentral	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
northcentralus	Sí	Sí	Sí	Sí	No	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí
noruegaeast	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
poloniacentral	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
southafricanorth	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
southcentralus	Sí	Sí	Sí	No	No	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí
southeastasia	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
southindia	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
spaincentral	Sí	Sí	Sí	No	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
sueciacentral	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
suizanorth	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
uaenorth	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
uksouth	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
westus	Sí	Sí	Sí	Sí	No	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí
westus3	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí

Las herramientas son compatibles con los siguientes modelos.

Nota

Para la herramienta de generación de imágenes, necesita el modelo de gpt-image-1 y un modelo de lenguaje grande (LLM) que el orquestador en el mismo proyecto de Microsoft Foundry.

Modelo	Agent2Agent	Búsqueda de Azure AI	Azure Functions	Creación de suelo de Bing Custom	Búsqueda de Bing en tierra	Automatización del explorador	Intérprete de código	Uso del equipo	agente de datos de Fabric	Búsqueda de archivos	Funciones	Generación de imágenes	MCP	OpenAPI	SharePoint	Búsqueda web
Cohere-command-r	No	No	No	No	No	No	Sí	No	No	Sí	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
DeepSeek-R1-0528	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
DeepSeek-V3-0324	No	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	No
DeepSeek-V3.1	No	No	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	No
FW-DeepSeek-V3.1	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-DeepSeek-V3.2	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-GLM-4.7	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-GLM-5	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-GPT-OSS-120B	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-Kimi-K2-Instruct-0905	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-Kimi-K2-Thinking	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-Kimi-K2.5	No	No	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-MiniMax-M2.5	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	No
FW-Qwen3.5-122B-A10B	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	Sí
FW-Qwen3.5-397B-A17B	No	Sí	No	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	Sí
Llama-3.3-70B-Instruct	No	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
Llama-4-Maverick-17B-128E-Instruct-FP8	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
Llama-4-Scout-17B-16E-Instruct	No	No	No	No	No	No	Sí	No	No	Sí	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
Meta-Llama-3.1-405B-Instruct	No	No	No	No	No	No	Sí	No	No	Sí	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
codex-mini	No	No	No	No	No	No	Sí	No	No	Sí	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
gpt-35-turbo	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
gpt-4	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
gpt-4.1	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
gpt-4.1-mini	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
gpt-4.1-nano	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
gpt-4.5-preview	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
gpt-4o	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
gpt-4o-mini	Sí	No	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
gpt-5	Sí	Sí	No	Sí	Sí	Sí	Sí	No	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
gpt-5-codex	No	No	No	No	No	No	Sí	No	No	Sí	No	No	Sí	No	No	No
gpt-5-mini	No	No	No	No	No	No	Sí	No	No	Sí	No	No	Sí	No	No	Sí
gpt-5-nano	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
gpt-5-pro	No	No	No	No	No	No	Sí	No	No	Sí	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í
gpt-5.1-chat	No	No	No	No	No	No	Sí	No	No	Sí	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
gpt-5.1-codex-max	No	No	No	No	No	No	Sí	No	No	Sí	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
gpt-5.2	No	Sí	Sí	No	Sí	No	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
gpt-5.2-chat	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	No	Sí
gpt-5.2-codex	No	No	No	No	No	No	Sí	No	No	Sí	No	No	Sí	No	No	No
gpt-5.3-chat	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	Sí	Sí	Sí	Sí
gpt-5.3-codex	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	Sí	Sí	Sí	Sí
gpt-5.4	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	Sí	Sí	Sí	Sí
gpt-5.4-mini	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	Sí	Sí	Sí	Sí
gpt-5.4-nano	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	Sí	Sí	Sí	Sí
gpt-5.4-pro	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	Sí	Sí	Sí	Sí
gpt-5.5	Sí	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	Sí	Sí	Sí	Sí
gpt-oss-120b	No	No	No	No	No	No	Sí	No	No	Sí	Sí	No	Sí	No	No	No
grok-3	No	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	No
grok-3-mini	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
grok-4	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
grok-4-1-fast-non-razonamiento	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
grok-4-1-fast-razonamiento	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
grok-4-20-non-razonamiento	No	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
grok-4-20-razonamiento	No	Sí	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí
grok-4-fast-non-razonamiento	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
grok-4-fast-razonamiento	No	No	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	Sí	No	No	No
mistral-small-2503	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
model-router	No	No	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	No
o1	No	Sí	No	Sí	No	Sí	Sí	No	No	Sí	Sí	No	Sí	No	Sí	Sí
o1-mini	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
o1-preview	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
o3	Sí	Sí	No	Sí	No	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	No	Sí
o3-deep-research	No	No	No	No	No	No	No	No	No	No	No	No	Sí	No	No	Sí
o3-mini	Sí	No	No	Sí	Sí	Sí	Sí	No	Sí	Sí	No	No	No	No	No	No
o3-pro	No	No	No	No	No	No	Sí	No	No	Sí	No	No	No	No	No	No
o4-mini	Sí	No	No	Sí	Sí	Sí	Sí	No	Sí	Sí	Sí	No	Sí	No	Sí	Sí

Solución de problemas

Use estas comprobaciones para resolver problemas comunes:

El agente no llama a una herramienta:
- Confirme que la herramienta está asociada al agente.
- Confirme que el modelo admite la herramienta.
- Si necesita un comportamiento determinista, establezca en tool_choicerequired.
- Revise los seguimientos de ejecución para confirmar si el modelo generó una llamada a herramienta.
Las llamadas de herramienta devuelven resultados vacíos o irrelevantes:
- Mejore las descripciones de herramientas y las instrucciones del agente.
- Para las herramientas de recuperación, asegúrese de que los datos se ingieren y se pueden buscar.
Se produce un error en las llamadas a herramientas:
- Compruebe la configuración y la autenticación de la herramienta.
- En el caso de las herramientas MCP y OpenAPI, valide que el punto de conexión sea accesible y devuelva respuestas esperadas.

Preguntas más frecuentes

¿Cómo se valida si se llamó a una herramienta?

Revise los seguimientos de ejecución para confirmar si el agente llamó a una herramienta e inspeccionar las entradas y salidas de la herramienta. Para la configuración de seguimiento de un extremo a otro, consulte Seguimiento de la aplicación.

¿Cómo puedo hacer que el uso de herramientas sea más confiable?

Comience con instrucciones de herramientas claras. Si necesita llamadas a herramientas deterministas, use tool_choice. Para obtener más información, consulte Control tool calling with tool_choice.

Procedimientos recomendados de herramientas para Microsoft servicio del agente foundry

Requisitos previos

Configuración y validación del uso de herramientas

Mejora de la confiabilidad de las llamadas a herramientas

Control de llamadas a herramientas con tool_choice

Escribir instrucciones de herramientas eficaces

Uso seguro de herramientas

Compatibilidad de herramientas por región y modelo

Solución de problemas

Preguntas más frecuentes

Contenido relacionado

Administración de herramientas

Herramientas de recuperación y búsqueda

Herramientas de integración y datos

Herramientas de automatización y generación

Comentarios

Recursos adicionales

Control de llamadas a herramientas con `tool_choice`