Introducción a las herramientas de puesta a tierra de la red

Las herramientas de conexión a la web en el servicio Microsoft Foundry Agent conectan a los agentes a datos web públicos en tiempo real, superando el límite de conocimiento del modelo 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 de la conexión a tierra en la web

El proceso de puesta en tierra implica varios pasos clave:

  1. Formulación de consultas: el agente identifica brechas de información y construye consultas de búsqueda basadas en la entrada del usuario.
  2. Ejecución de búsqueda: la herramienta de búsqueda envía consultas a Bing y recupera los resultados.
  3. Síntesis de información: el agente procesa los resultados de búsqueda e integra los resultados en las respuestas.
  4. 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.Projects y Azure.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 utilización de Bing Search y Bing Custom Search requiere el rol de Contributor o Owner para crear recursos de Bing, y el rol de Azure AI Project Manager para crear conexiones de proyecto. Para más información, consulte configuración del entorno del agente.

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: contextualización de la web general indexada por Bing

Búsqueda web (recomendado) Integración con Bing Search
Fase Disponibilidad general Disponibilidad general
Puesta a tierra con el recurso de 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 Azure modelos OpenAI y modelos de Azure directos (modelos que no son de OpenAI implementados directamente en Azure)

Caso de uso 2: fundamentación desde los dominios específicos que definiste

Búsqueda web (recomendado) Fundamentación 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 Azure OpenAI y modelos Azure directos.

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 costos adicionales para la configuración web?

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 usa la base web 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. Mejore 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 estabilización web. 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.

Contenido relacionado

  • Last updated on