Configuración del entorno

La creación del primer agente con azure AI Foundry Agent Service es un proceso de dos pasos:

1. Configure el entorno del agente.
2. Cree y configure su agente mediante el SDK de su elección o el Portal de Azure Foundry.

Use este artículo para obtener más información sobre cómo configurar el entorno del agente.

Permisos necesarios

Acción	Rol obligatorio
Creación de una cuenta y un proyecto	Propietario de la cuenta de Azure AI
configuración estándar Solo: asigne RBAC para los recursos necesarios (Cosmos DB, Search, Storage, etc.)	Administrador de control de acceso basado en roles
Creación y edición de agentes	Usuario de Azure AI

Configuración del entorno del agente

Para empezar, necesitará un recurso de Azure AI Foundry y un proyecto de Foundry.
Los agentes se crean dentro de un proyecto específico y cada proyecto actúa como un área de trabajo aislada. Esto significa lo siguiente:

• Todos los agentes del mismo proyecto comparten acceso al mismo almacenamiento de archivos, almacenamiento de subprocesos (historial de conversaciones) e índices de búsqueda.
• Los datos están aislados entre proyectos. Los agentes de un proyecto no pueden acceder a los recursos de otro. Actualmente, los proyectos son la unidad de uso compartido y aislamiento en Foundry. Consulte el artículo ¿Qué es la fundición de IA? para obtener más información sobre los proyectos de Fundición.

Prerrequisitos

• Una suscripción de Azure: cree una gratuitamente.
• Asegúrese de que la persona que crea la cuenta y el proyecto tiene el rol Propietario de la cuenta de Azure AI en el ámbito de la suscripción.
• Si configura una configuración estándar, el mismo individuo también debe tener permisos para asignar roles a los recursos necesarios (Cosmos DB, Azure AI Search, Azure Blob Storage). Para más información sobre los roles de RBAC, específicos del servicio Azure AI Foundry Agent, consulte Roles RBAC del servicio Azure AI Foundry Agent.
  • El rol integrado necesario es Administrador de acceso basado en roles.
  • Como alternativa, tener el rol Propietario en el nivel de suscripción también satisface este requisito.
  • El permiso de clave necesario es: Microsoft.Authorization/roleAssignments/write

Elección de la configuración

Azure AI Foundry Agent Service ofrece tres modos de configuración de entorno para satisfacer diferentes necesidades:

• Configuración básica:

  Esta configuración es compatible con los asistentes de OpenAI y administra los estados del agente mediante el almacenamiento integrado de la plataforma. Incluye las mismas herramientas y funcionalidades que la API assistants, con compatibilidad agregada para modelos y herramientas que no son de OpenAI, como Azure AI Search y Bing.

• Configuración estándar:

  Incluye todo en la configuración básica y el control específico sobre los datos, ya que le permite usar sus propios recursos de Azure. Todos los datos del cliente, incluidos los archivos, los subprocesos y los almacenes de vectores, se almacenan en sus propios recursos de Azure, lo que le proporciona la propiedad y el control completos.

• Configuración estándar con Bring Your Own (BYO) Virtual Network:

  Incluye todo en la configuración estándar, con la capacidad adicional de operar completamente dentro de su propia red virtual. Esta configuración admite Bring Your Own Virtual Network (byO virtual network), lo que permite un control estricto sobre el movimiento de datos y ayuda a evitar la filtración de datos manteniendo el tráfico limitado a su entorno de red.

Comparación de las opciones de configuración

Casos de uso	Configuración básica	Configuración estándar con redes públicas	Configuración estándar con redes privadas
Comienza rápidamente sin administrar recursos	✅
Todos los historiales de conversaciones, archivos y almacenes de vectores se almacenan en sus propios recursos.		✅	✅
Compatibilidad con claves administradas por el cliente (CMK)		✅	✅
Aislamiento de red privada (Traiga su propia red virtual)			✅

Opciones de implementación

Para personalizar estas plantillas, consulte Uso de sus propios recursos.

Si desea compatibilidad con el aislamiento de red privada, consulte configuración protegida por red para obtener más información sobre cómo traer su propia red virtual.

Descripción e implementación automática	Diagrama (haga clic para acercar)
Implemente una configuración básica del agente que use identidad administrada para la autenticación. Se crea una cuenta y un proyecto. Se implementa un modelo GPT-4o. Una instancia de Key Vault administrada por Microsoft se usa de forma predeterminada.
Implemente una configuración de agente estándar que use identidad administrada para la autenticación. Se crea una cuenta y un proyecto. Se implementa un modelo GPT-4o. Los recursos de Azure para almacenar datos de los clientes( Azure Storage, Azure Cosmos DB y Azure AI Search ) se crean automáticamente si no se proporcionan recursos existentes. Estos recursos están conectados al proyecto para almacenar archivos, subprocesos y datos vectoriales. Una instancia de Key Vault administrada por Microsoft se usa de forma predeterminada.

[Opcional] Selección de modelos en plantilla de implementación automática

Importante

No cambie el parámetro modelFormat.

Las plantillas solo admiten la implementación de modelos de Azure OpenAI. Consulte qué modelos de Azure OpenAI se admiten en el artículo compatibilidad con modelos .

Puede personalizar el modelo usado por su agente editando los parámetros del modelo en la plantilla de implementación automática. Para implementar un modelo diferente, es necesario actualizar al menos los parámetros modelName y modelVersion.

De manera predeterminada, la plantilla de implementación está configurada con los siguientes valores:

Parámetro del modelo	Valor predeterminado
nombre del modelo	gpt-4o
modelFormat	OpenAI (para Azure OpenAI)
modelVersion	20-11-2024
modelSkuName	GlobalStandard
ubicación del modelo	eastus

¿Qué es lo siguiente?

• Creación del primer agente
• Explore más:
  • Uso de los recursos existentes
  • Configuración del agente protegido por red