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.
Las herramientas de anclaje a la web en el Foundry Agent Service de Microsoft conectan a los agentes a datos públicos de la web en tiempo real, por lo que se ignora el límite de extracción de conocimientos en el modelo de Foundry del agente. Por ejemplo, puede formular preguntas como "cuál es la noticia de inteligencia artificial más importante hoy" y recibir respuestas actuales citadas.
Funcionamiento del "web grounding"
El proceso de puesta en tierra implica varios pasos clave:
- Formulación de consultas: el agente identifica brechas de información y construye consultas de búsqueda basadas en la entrada del usuario.
- Ejecución de búsqueda: la herramienta de búsqueda envía consultas a Bing y recupera los resultados.
- Síntesis de información: el agente procesa los resultados de búsqueda e integra los resultados en las respuestas.
- Atribución de origen: el agente proporciona transparencia mediante la cita de orígenes de búsqueda con direcciones URL.
Requisitos previos
Antes de usar cualquier herramienta de puesta a tierra web, asegúrese de que tiene:
- Un entorno de agente básico o estándar.
- El paquete de SDK más reciente del lenguaje (Python:
azure-ai-projects, C#:Azure.AI.ProjectsyAzure.AI.Extensions.OpenAI, JavaScript:@azure/ai-projects). Consulte el inicio rápido para conocer los pasos de instalación. - Una implementación del modelo de Azure OpenAI en el proyecto Foundry.
Nota
Web Search no requiere ningún rol adicional más allá del acceso al proyecto Foundry. La conexión a tierra con Bing Search y la conexión a tierra con Bing Custom Search requieren el rol de Contributor o Owner para crear recursos de Bing, y el rol de Foundry Project Manager para crear conexiones de proyecto. Para más información, consulte configuración del entorno del agente.
Importante
Recientemente se cambió 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.
Importante
Web Search, Grounding with Bing Search y Grounding with Bing Custom Search son Servicios de Consumo de Primera Parte con términos para servicios en línea. Se rigen por los términos de uso de ‘Grounding with Bing’ y la Declaración de Privacidad de Microsoft.
El Microsoft Data Protection Addendum no se aplica a los datos enviados a Grounding con Bing Search o Grounding con Bing Custom Search. Al usar estos servicios, los datos fluyen fuera del cumplimiento de Azure y el límite geográfico. Esto también significa que el uso de estos servicios renuncia a todos los compromisos elevados de cumplimiento y seguridad de la comunidad pública en la nube, incluida la soberanía de datos y el soporte basado en la ciudadanía, según corresponda.
Nota
El uso de Grounding con Bing Search y Grounding con Bing Custom Search conlleva costos. Consulte los detalles de precios. Los administradores de Azure pueden restringir el acceso a estas herramientas. Para obtener más información, consulte Control de administrador para la herramienta Búsqueda web.
Determina la mejor herramienta para tus casos de uso
Si acaba de empezar, use Búsqueda web. No requiere los recursos adicionales de Azure y es la manera más sencilla de agregar conexión a la web al agente.
Si estás migrando desde Grounding con Bing Search en la plataforma clásica de agentes, tanto Web Search como Grounding con Bing Search son opciones GA en la nueva API de agentes. Web Search no requiere ningún recurso de Bing independiente. La puesta en tierra con Bing Search ofrece más parámetros y admite modelos que no son de OpenAI implementados directamente en Azure.
Los siguientes casos de uso le ayudan a comparar las herramientas disponibles. El caso de uso 1 cubre la búsqueda web general, en la que tanto Web Search como Grounding con Bing Search pueden recuperar resultados de la web pública. En el caso de uso 2 se trata la búsqueda restringida por dominio, que solo admite Grounding con Bing Custom Search.
Caso de uso 1: Anclaje a través de la web general indexada por Bing
| Búsqueda web (recomendado) | Integración con Bing Search | |
|---|---|---|
| Fase | Disponibilidad general | Disponibilidad general |
| Recurso de Grounding con Bing | Administrado por Microsoft | Administrado por usted: requiere la creación de un recurso Grounding with Bing Search en primer lugar. |
| Parámetros admitidos |
-
user_location: proporciona resultados relevantes geográficamente- search_context_size: bajo/medio/alto (valor predeterminado: medio)Más información sobre los parámetros de Búsqueda web |
-
count: el máximo de resultados devueltos por Bing - freshness: especifica el período de los resultados de búsqueda.- market: especifica la región de los resultados de búsqueda. - set_lang: especifica el idioma de los resultados de búsqueda. Más información sobre los parámetros de Bing Search |
| Límite de datos | Flujos de datos fuera de la frontera de cumplimiento de Azure | Flujos de datos fuera de la frontera de cumplimiento de Azure |
| Modelos admitidos | modelos de OpenAI de Azure | Modelos de Azure OpenAI y Foundry Models comercializados por Azure (los modelos que no son de OpenAI y que se implementan directamente en Azure) |
Caso de uso 2: fundamentación desde los dominios específicos que definiste
| Búsqueda web (recomendado) | Grounding con Bing Custom Search | |
|---|---|---|
| Fase | GA (requiere una instancia de Bing Custom Search) | Vista previa |
| Restringir a dominios personalizados | Compatible: use custom_search_configuration para definir previamente dominios permitidos o bloqueados (requiere la creación de un recurso y una instancia de Bing Custom Search). |
Compatible: use custom_search_configuration para definir previamente dominios permitidos o bloqueados (requiere la creación de un recurso y una instancia de Bing Custom Search). |
| Otros parámetros |
-
user_location: proporciona resultados relevantes geográficamente- search_context_size: bajo/medio/alto (valor predeterminado: medio)Más información sobre los parámetros de Búsqueda web |
-
count: el número máximo de resultados devueltos por Bing - freshness: especifica el período de los resultados de búsqueda.- market: especifica la región de los resultados de búsqueda. - set_lang: especifica el idioma de los resultados de búsqueda. Más información sobre los parámetros de Bing Custom Search |
| Modelos admitidos | modelos de OpenAI de Azure | Modelos de Azure OpenAI y modelos vendidos por Azure |
Preguntas comunes
¿Qué herramienta debo usar si acabo de empezar?
Usa Búsqueda web. No requiere recursos de Azure adicionales, controla la administración de recursos de Bing automáticamente y proporciona resultados relevantes geográficamente con el parámetro user_location.
¿Puedo usar herramientas de ajuste web con proyectos de Foundry con seguridad de red?
Las herramientas de conexión a tierra web no respetan las VPN ni los puntos de conexión privados. Actúan como puntos de conexión públicos. Tenga en cuenta esta implicación de seguridad al usar Foundry protegido por red con estas herramientas.
¿Cómo puedo restringir los resultados de búsqueda a sitios web específicos?
Usa Búsqueda web. Esta herramienta le permite definir una lista de permitidos o una lista de bloques de dominios, por lo que los resultados de búsqueda solo proceden de orígenes aprobados.
¿Hay costes adicionales para el "web grounding"?
Sí. Web Search, Grounding with Bing Search y Grounding with Bing Custom Search (versión preliminar) conllevan costos más allá del uso estándar Azure OpenAI. Consulte los detalles de precios.
Solución de problemas
| Problema | Causa probable | Resolución |
|---|---|---|
| El agente no utiliza "web grounding" | La herramienta no está configurada o el modelo no admite la herramienta. | Compruebe que la herramienta se agrega a la definición del agente. Usar tool_choice="required" para forzar el uso de herramientas. Compruebe que la implementación del modelo admite la herramienta. |
| No hay citas en respuesta | El modelo generó una respuesta sin usar los resultados de búsqueda. | Agregue instrucciones explícitas para citar siempre los orígenes. Use tool_choice="required" para garantizar la invocación de herramientas. |
| Los resultados de la búsqueda no son relevantes | La formulación de consultas no capturó la intención del usuario. | Mejora las instrucciones del agente para guiar la construcción de consultas. En el caso de las herramientas de Bing, ajuste los parámetros market y set_lang. |
| Herramienta bloqueada por el administrador | Su organización deshabilitó las herramientas de "web grounding". | Póngase en contacto con el administrador de Azure para habilitar el acceso. Consulte control de administrador. |
| Costos inesperados | Las herramientas de conexión a tierra web tienen precios basados en el uso. | Revise los detalles de precios e implemente la limitación de velocidad si es necesario. |