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.
Respuestas a preguntas comunes sobre el uso de Microsoft Web IQ. Para obtener detalles de api y ejemplos de solicitudes, consulte la referencia de API.
Servicio y despliegue
¿Qué es Microsoft Web IQ?
Microsoft Web IQ es un conjunto de API nativas de IA de búsqueda web y grounding que proporcionan acceso a llms, agentes de IA y aplicaciones a información web actual y relevante. Esto permite respuestas de IA más precisas y actualizadas, con fuentes que los usuarios pueden verificar. Web IQ potencia a los asistentes de inteligencia artificial de frontera líderes, incluidos Microsoft Copilot y ChatGPT.
Web IQ está disponible a través de REST en https://api.microsoft.ai/v3 y a través de MCP en https://api.microsoft.ai/v3/mcp. Las API disponibles actualmente son Búsqueda web, Noticias, Vídeos, Imágenes y Browse.
Auto está disponible en la versión beta.
¿Qué es la fundamentación web y cuándo la necesita un agente de IA?
La fundamentación en la web da a la IA acceso a la información web más reciente para que pueda responder basándose en información actual más allá de sus datos de entrenamiento, con fuentes citadas que los usuarios pueden comprobar. Resulta más útil con la información que cambia con frecuencia, como los desarrollos del mercado, la actividad de los competidores, las noticias y las actualizaciones normativas.
¿Es Web IQ un LLM? ¿Genera la respuesta final?
N.º Web IQ no es un modelo de IA ni LLM. Se trata de un conjunto de API de búsqueda web y grounding nativas de IA que proporcionan acceso a llms, agentes de IA y aplicaciones a información web actual y relevante.
Web IQ no genera la respuesta de IA final. Recupera información relevante de la web, y tu LLM, agente de IA o lógica de la aplicación elegidos usan esa evidencia para generar una respuesta.
¿Qué hace que Web IQ sea diferente de otras API de búsqueda web y servicios de grounding?
La mayoría de las API de búsqueda web implican una disyuntiva: rápido o preciso, rentable o completo. En la comparación publicada de Microsoft, Web IQ ofrece la mayor satisfacción de fundamentación, la velocidad más rápida y la menor cantidad de tokens por consulta. Es la misma plataforma en la que se basan cada día asistentes de inteligencia artificial como Copilot y ChatGPT, probada a escala global y lista para que cualquier agente o aplicación de IA se desarrolle sobre ella.
Web IQ también se diferencia por cómo accede al contenido. Adopta un enfoque responsable del acceso web, que reúne la Web abierta y los datos estructurados con protección y seguridad de nivel empresarial integrada.
Web IQ funciona con la pila de IA que ya usa. Puede usar el modelo de IA preferido y conectarse a través de la API REST o el Protocolo de contexto de modelo (MCP), sin estar vinculado a un único modelo o plataforma.
Fuente: Resultados de pruebas comparativas de Web IQ (secciones Calidad, Eficiencia y Velocidad).
¿Qué puedo crear con Web IQ?
Web IQ potencia a los agentes y aplicaciones de inteligencia artificial que necesitan información externa nueva desde la web pública. Los equipos internos pueden usarlo para la inteligencia competitiva, la supervisión, la investigación normativa, la inteligencia de ventas y la optimización de contenido. Las experiencias orientadas al cliente pueden usarlas para investigación, descubrimiento, recomendaciones y agentes especializados.
Es más adecuado para escenarios en los que la información cambia con frecuencia, abarca muchos orígenes externos y debe basarse en contenido web actual y atribuible.
¿Qué API de Web IQ se ajusta a mi caso de uso?
Utilice la Web Search API para buscar páginas y pasajes públicos relevantes para el modelo, la News API para eventos actuales, las API de Images y Videos para los resultados visuales y de vídeo, y la API Browse cuando ya conoce la dirección URL. Compruebe la referencia de API para conocer las funcionalidades y los límites disponibles para su cuenta.
¿Puedo usar Web IQ con mi modelo de IA y el marco de agente existentes?
Yes. Web IQ le permite agregar información web al modelo de IA y al flujo de trabajo del agente que elija. Las API REST y MCP proporcionan flexibilidad en la forma de conectarte. Consulte el SDK y la documentación de integración de MCP para ver las configuraciones admitidas.
¿Qué aspecto tiene la integración?
El agente de IA o la aplicación llama a Web IQ para la evidencia web y, a continuación, pasa los resultados seleccionados a su modelo para generar una respuesta. Tú controlas cómo se selecciona, usa y cita la información. Siga el Quickstart para conectar el primer flujo de trabajo o empezar a trabajar con Playground.
¿Puede Web IQ recuperar información privada de la empresa?
N.º Web IQ obtiene información de la web pública. Para el contexto empresarial, Microsoft ofrece Work IQ, Fabric IQ y Foundry IQ, cada uno de los cuales atiende un rol diferente, desde el contexto organizativo hasta los datos empresariales y los conocimientos empresariales.
¿Cómo se relaciona Web IQ con Foundry IQ, Work IQ y Fabric IQ?
Microsoft IQ reúne cuatro capas integradas que potencian la inteligencia empresarial en todo Microsoft. Web IQ proporciona información de la web pública. Work IQ se centra en las señales de trabajo, Fabric IQ en los datos empresariales y Foundry IQ en los conocimientos de la organización. Estos productos abordan diferentes necesidades de información para los agentes y aplicaciones de inteligencia artificial y son más eficaces cuando se usan juntos.
¿Es Web IQ un recurso de Azure?
Implemente un recurso de Web IQ en la suscripción de Azure. El recurso administra la identidad, la medición y la facturación.
El propio servicio está alojado por Microsoft y es multiempresa. La recuperación web y la clasificación se ejecutan en la infraestructura de Microsoft y la aplicación llama a api.microsoft.ai a través de HTTPS. El recurso Azure no hospeda Web IQ y no está en la ruta de acceso de la solicitud.
¿Dónde está desplegado Web IQ?
Web IQ está hospedado por Microsoft y está disponible a través del punto de conexión público https://api.microsoft.ai/v3. La aplicación llama a la API y Web IQ realiza la recuperación web del lado del servidor.
¿Hay API dedicadas para finanzas, deportes o clima?
Hoy no. Las API dedicadas son Búsqueda web, Noticias, Vídeos, Imágenes y Browse. Para finanzas, deportes, clima y otros temas sin una API dedicada, use búsqueda web, que devuelve contenido rastreado relevante. Ese contenido es texto de página no estructurado en lugar de un feed estructurado.
Acceso e introducción
¿Cómo puedo pasar de la evaluación a la producción?
- Complete la evaluación y confirme que el servicio cumple sus requisitos.
- La suscripción Azure está habilitada para Web IQ.
- Implemente el recurso de Web IQ en esa suscripción y, a continuación, inicie sesión en el sitio de cliente de Web IQ y conecte el recurso. Esto crea el AppID de producción, que comienza en el límite predeterminado de 15 consultas por segundo (QPS).
- Para autenticarse con Entra ID, agregue el identificador de cliente de la aplicación a ese AppID en el sitio de cliente de Web IQ.
El uso de Web IQ se rige por los Términos de uso de Web IQ, en el contexto de su Contrato de cliente de Microsoft existente.
¿Qué suscripciones Azure puedo usar?
Web IQ requiere una suscripción de Azure de pago. Los créditos de Azure no funcionan para Web IQ.
¿Qué dirección debo usar para iniciar sesión?
Use la dirección de inicio de sesión Microsoft que tiene acceso a Web IQ: la dirección Microsoft habilitada para usted o la cuenta que usó para conectar el recurso de Web IQ en el sitio de cliente de Web IQ. Normalmente, esta es la dirección que usa para Azure, Teams u Office, que puede diferir de la dirección de su buzón.
Para confirmarlo, inicie sesión en Azure portal y compruebe la dirección en la esquina superior derecha.
¿Por qué el inicio de sesión dice que no tengo acceso?
En primer lugar, confirme que la dirección que se muestra en la esquina superior derecha de Azure portal coincide exactamente con la dirección que tiene acceso a Web IQ. Las organizaciones suelen usar una dirección para iniciar sesión en Microsoft y otra para el correo electrónico.
Si las direcciones coinciden, la organización puede bloquear el acceso de invitado entre tenants al tenant de Microsoft Corporation. Pida al administrador de TI que permita ese acceso.
¿Dónde puedo obtener ayuda?
Visite el sitio de soporte técnico de Microsoft Web IQ para obtener ayuda sobre el producto. Para preguntas sobre el uso permitido, la privacidad, el almacenamiento o la visualización, consulte los términos de uso actuales de Web IQ y su contrato de cliente aplicable.
Autenticación de API
¿Qué métodos de autenticación se admiten?
Web IQ admite:
- Microsoft Entra ID tokens al portador a través del flujo de credenciales de cliente de OAuth 2.0. Se recomienda para las cargas de trabajo de producción.
- Claves de API enviadas en el encabezado de solicitud
x-apikey.
Todo el tráfico de API usa HTTPS.
¿Cómo se configura la autenticación de servidor a servidor?
Registre una aplicación en Microsoft Entra ID y use el flujo de credenciales de cliente de OAuth 2.0. Agregue el identificador de cliente de la aplicación a su AppID de Web IQ en el sitio de cliente de Web IQ, adquiera un token de acceso y envíelo como Authorization: Bearer <access_token>.
Consulte Autenticación para ver los pasos de configuración completos.
¿Puedo administrar mis propias claves de API?
Yes. Puede crear tantas claves de API como necesite desde el sitio de cliente de Web IQ. No hay ningún cargo por crear claves.
¿Web IQ usa Azure RBAC para la autorización de API?
N.º Web IQ es un servicio hospedado por Microsoft al que se accede a través de Internet. El recurso de Web IQ que implemente en la suscripción de Azure controla la identidad, la medición y la facturación, pero no está en la ruta de acceso de solicitud, por lo que no hay ningún recurso de servicio al que puedan asociarse los roles RBAC de Azure.
Web IQ autoriza solicitudes por AppID. Cada AppID tiene su propio perfil y cuota de idoneidad de contenido, y las llamadas no autorizadas devuelven HTTP 403. Para separar equipos de trabajo o cargas de trabajo, por ejemplo, con diferentes directivas de acceso o cuotas, use varios AppIDs.
¿Puede una llamada a Entra ID invocar más de un AppID?
Yes. Se puede autorizar un único identificador de aplicación de Entra (cliente) ID para llamar a uno o varios AppID. Para elegir appID, páselo como parámetro de consulta, por ejemplo https://api.microsoft.ai/v3/search/web?appid=<AppID>. La API resuelve el appID de la siguiente manera:
- El Entra ID está enlazado a un AppID: si no especifica un AppID o especifica que AppID, la solicitud se realiza correctamente (HTTP 200). Si especifica un AppID diferente, la solicitud devuelve HTTP 403.
- Su Entra ID está enlazado a varios AppID: debe especificar uno. Un AppID que falta o está en blanco devuelve HTTP 400; uno de tus AppID vinculados devuelve HTTP 200; cualquier otro AppID devuelve HTTP 403.
- El Entra ID no está enlazado a ningún AppID: la solicitud devuelve HTTP 401.
La autenticación de clave de API (x-apikey) no se ve afectada. Cada clave de API está enlazada a un único AppID, por lo que ?appid= nunca se necesita ni acepta para las llamadas autenticadas por claves.
¿Qué autenticación debe usar un agente hospedado: Identidad administrada o AgentID?
Cualquiera de las dos funciona. Managed Identity y AgentID son ambas identidades de Entra ID, y Web IQ acepta cualquier identidad de Entra ID cuyo identificador de aplicación (cliente) esté vinculado a su perfil de aplicación de Web IQ desde la página Administración de perfiles del sitio de cliente de Web IQ.
El que uses depende de dónde se hospede el agente:
- Managed Identity se ajusta a los agentes que se ejecutan en la infraestructura de Azure, como Foundry, App Service, Container Apps, AKS, Functions o máquinas virtuales. Tanto las identidades asignadas por el sistema como las asignadas por el usuario funcionan.
- AgentID es adecuado para los agentes hospedados en Foundry o Copilot Studio que exponen una identidad del agente.
- Los agentes hospedados fuera de Azure, por ejemplo, en su propio clúster de Kubernetes u otra nube, pueden usar un registro de aplicación Entra estándar con un secreto de cliente o credenciales federadas.
En cada caso, la llamada usa el flujo de credenciales de cliente de OAuth 2.0 y envía el token como Authorization: Bearer <access_token>. Consulte Autenticación para conocer los pasos de configuración. Una clave de API en el x-apikey encabezado sigue siendo la opción más sencilla para los prototipos.
Redes y seguridad
¿Admite Web IQ Private Link, puntos de conexión privados, integración de VNet o listas de direcciones IP permitidas?
N.º Actualmente no se admite ninguna de estas opciones. Se accede a Web IQ a través de un único punto de conexión público, https://api.microsoft.ai/v3, a través de HTTPS con Entra ID o autenticación de clave de API. No hay ningún control de acceso basado en IP en el punto de conexión de API.
El recurso de Web IQ de la suscripción de Azure controla la identidad, la medición del consumo y la facturación, pero no está en la ruta de acceso de la solicitud, por lo que los controles de red de Azure, como Private Link, integración de red virtual, Azure Firewall, NSG y topologías en estrella tipo hub-and-spoke no tienen nada en el lado de Web IQ para asociar. La integración de identidad (Entra ID) está alineada con Azure; la capa de red no.
Por su parte, permita el nombre de host api.microsoft.ai en los controles de salida.
¿El tráfico de Azure a Web IQ permanece en la red de Microsoft o en la red troncal de Azure?
Esto no está garantizado. Los clientes se conectan al punto de conexión público https://api.microsoft.ai y el tráfico se protege en tránsito con HTTPS.
El tráfico de API de Web IQ finaliza en Azure Front Door, que admite TLS 1.2 y TLS 1.3 con estos conjuntos de cifrado:
-
TLS 1.3:
TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256 -
TLS 1.2:
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384, ,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
¿Zscaler u otra herramienta de inspección de salida interferirá con Web IQ?
No debe interferir cuando está configurado para permitir conexiones a api.microsoft.ai. Se trata de una acción estándar de allowlist, no una excepción general. El mismo enfoque se aplica a otras puertas de enlace web seguras, como Netskope.
¿Puedo poner a Web IQ detrás de Azure API Management?
Yes. Puede colocar Azure API Management u otra puerta de enlace delante de Web IQ en su propia suscripción de Azure para observabilidad y gobernanza, y no hay limitaciones de bloqueo conocidas. Las llamadas API van desde el cliente que realiza la llamada hasta https://api.microsoft.ai/v3 mediante TLS con una clave de API o un token de Entra ID, por lo que todo lo que ponga delante de ese tráfico es su propia infraestructura en su tenant. Microsoft no publica una arquitectura de referencia para estas implementaciones; el equipo de arquitectura en la nube posee ese diseño.
En los Términos de uso de Web IQ, el contenido de respuesta no se puede almacenar en caché ni almacenarse para compilar un conjunto de datos derivado, independientemente de lo que haga la pasarela. La telemetría operativa, como el estado, la latencia, los encabezados y los identificadores de seguimiento, se pueden conservar, por ejemplo, en Application Insights o en Log Analytics.
¿Qué controles de seguridad están disponibles?
- Autenticación: Entra ID (credenciales de cliente de OAuth 2.0) o una clave de API.
- Autorización: acceso por AppID a las interfaces API. Las llamadas no autorizadas devuelven HTTP 403.
- Limitación de solicitudes: aplicación de cuota por AppID. Las solicitudes por encima del límite devuelven HTTP 429.
- Transporte: solo HTTPS.
La política de red en el perímetro es su responsabilidad. Si tiene requisitos de arquitectura específicos que desee que se evalúen, póngase en contacto con el soporte técnico de Web IQ.
Límites de tasa y claves de API
¿Hay un límite de solicitudes?
Yes. Cada recurso de Web IQ tiene un límite predeterminado de 15 consultas por segundo (QPS). El límite se aplica al AppID creado al conectar el recurso y el sitio de cliente de Web IQ lo muestra.
El límite se comparte entre todas las claves de API y Entra ID clientes para ese AppID. Las solicitudes por encima del límite devuelven HTTP 429.
¿Puedo aumentar mi límite de tasa?
Yes. Cada recurso de Web IQ comienza en 15 QPS. Para solicitar un límite mayor, póngase en contacto con el soporte técnico de Web IQ con el tráfico esperado y el caso de uso.
¿Cuántas claves de API puedo crear?
Puede crear tantas claves como necesite la aplicación. La creación de claves es gratuita, pero todas las claves de un recurso comparten su límite de tasa.
Privacidad y control de datos
¿Web IQ registra las consultas a la API?
Yes. Las solicitudes de API se registran con fines operativos: confiabilidad del servicio, depuración y mejora de la calidad. Esto es estándar para servicios Microsoft.
- El acceso está restringido al personal autorizado de ingeniería y operaciones de Microsoft y se rige por las directivas de control de acceso interno de Microsoft. Los datos de los registros no son accesibles para otros clientes o terceros.
- Los registros se almacenan en la infraestructura de producción de Microsoft y están sujetos a los controles de seguridad estándar de Microsoft, incluido el control de acceso basado en rol y los seguimientos de auditoría.
- Los registros se cifran en tránsito (HTTPS) y en reposo mediante las prácticas de cifrado estándar de Microsoft.
Microsoft funciona como responsable del tratamiento bajo la Declaración de privacidad de Microsoft.
¿Cuánto tiempo se conservan las consultas?
La retención de datos de telemetría de consulta se rige por la sección 4 de los Términos de uso de Web IQ, que somete el tratamiento de Microsoft a la Declaración de privacidad de Microsoft. No hay ningún compromiso de retención específico de Web IQ independiente más allá de lo que describe la Declaración de privacidad.
¿Puedo desactivar el registro de consultas para cargas de trabajo reguladas o confidenciales?
El texto de la consulta se captura como parte de la telemetría de solicitudes estándar y su procesamiento se rige por la declaración de privacidad de Microsoft y la sección 4 de los Términos de uso de Web IQ.
Si tiene un requisito normativo o de cumplimiento específico, Web IQ ofrece Zero Query Logging, que suprime el texto de la consulta de la telemetría. No es una característica de autoservicio; cada caso de uso se revisa y aprueba individualmente, y se puede aplicar a todas tus aplicaciones o solo a aplicaciones específicas. Para solicitarlo, póngase en contacto con el equipo de cuentas de Microsoft y comparta lo siguiente:
- El marco normativo o de cumplimiento que se aplica (por ejemplo, GLBA, HIPAA, RGPD o APPI).
- Una breve descripción de tu escenario de implementación.
¿Qué compromisos de residencia de datos proporciona Web IQ?
Ninguna hoy. Web IQ no ofrece compromisos sobre residencia de datos específica de una región ni sobre procesamiento dentro de la región, y el enrutamiento entre regiones al punto de conexión disponible más cercano es el comportamiento esperado. La privacidad está cubierta por la declaración de privacidad de Microsoft.
¿Web IQ está cubierto por el anexo de protección de datos de Azure o el límite de datos de la UE?
N.º La sección 4.1 de los Términos de uso de Web IQ excluye el servicio del anexo de protección de datos de productos y servicios de Microsoft.
En cambio, Microsoft y el cliente actúan como responsables independientes de cualquier dato personal procesado en virtud de los Términos de uso (sección 4.4). El procesamiento de Microsoft se rige por la Declaración de privacidad de Microsoft (sección 4.2), y usted es responsable de dar un aviso adecuado a los usuarios finales.
Para las transferencias internacionales, los Términos de uso incorporan cláusulas contractuales estándar cuando sea necesario (sección 4.6.1). Ese mecanismo de transferencia viaja a través de los Términos de uso, que se encuentran bajo su Contrato de cliente de Microsoft, no a través del Anexo de protección de datos.
Web IQ no asume hoy por hoy compromisos sobre límites de datos de la UE, residencia de datos por región ni procesamiento en la región.
¿Detecta Web IQ o enmascara los datos personales en las consultas?
N.º Web IQ no realiza la detección o enmascaramiento del lado servidor de datos personales en las consultas entrantes. Si una carga de trabajo puede enviar datos personales o confidenciales, depúrela antes de llamar a Web IQ, por ejemplo, con Lenguaje de Azure AI PII Detection como paso de preprocesamiento. De este modo, nada confidencial sale del entorno y mantienes el control total sobre lo que llega a la API.
¿Admite Web IQ sectores regulados?
Yes. Web IQ admite una variedad de casos de uso empresariales y regulados. Si tiene requisitos especializados de cumplimiento, gobernanza o sector, póngase en contacto con el soporte técnico de Web IQ.
Seguridad y cobertura de contenido
¿Qué controles de seguridad de contenido se aplican?
Web IQ aplica la clasificación de calidad y seguridad en el momento del rastreo, el filtrado de contenido para adultos y las reglas de idoneidad de contenido por cliente. SafeSearch se aplica del lado del servidor en strict de forma predeterminada. Los resultados de la búsqueda web también incluyen un campo isAdult para el control adicional del lado cliente.
¿Protege Web IQ un LLM de la inyección de prompts en el contenido recuperado?
Microsoft Web IQ recupera y clasifica el contenido de la web; no ejecuta, interpreta ni actúa sobre instrucciones incrustadas en el contenido recuperado. Web IQ complementa este comportamiento de recuperación con la calidad, confianza, spam y filtrado de contenido malintencionado existente de Bing.
La protección contra la inyección indirecta de prompts, los intentos de jailbreak y los ataques de seguimiento de instrucciones es principalmente responsabilidad del modelo posterior y de la capa de orquestación. Trate los prompts y el contenido recuperado como entradas que no son de confianza y aplique controles en capas, como Prompt Shields, Seguridad del contenido de Azure AI, aislamiento del prompt del sistema, acceso a herramientas con privilegios mínimos, validación de grounding y validación de salida. Web IQ no debe tratarse como el único punto de aplicación para la mitigación de la inyección de prompts.
¿Cómo se procesa el contenido web antes de que Web IQ lo devuelva? ¿Está saneado para instrucciones similares a un prompt?
Microsoft Web IQ no funciona directamente en HTML de página sin procesar en el momento de la recuperación. Durante la indexación, el contenido web se normaliza en una representación de documento estructurada diseñada para conservar contenido significativo y estructura de documentos. Los pasajes devueltos por Web IQ se seleccionan a partir de esa representación, que es lo que permite la extracción y recuperación más coherentes en toda la superficie de la API. La calidad, seguridad, correo no deseado y controles de contenido malintencionado existentes de Bing también se aplican como parte de la canalización de indexación.
Esta normalización no debe interpretarse como una garantía de que el texto similar a un prompt se identifique o elimine. Trate el contenido recuperado como entrada que no es de confianza y aplique las protecciones de nivel de orquestación y modelo descritas en la respuesta anterior.
¿Devuelve Web IQ contenido de página oculto o no orientado al usuario?
Microsoft Web IQ intenta devolver contenido visible a través de la interacción normal del usuario, incluido el contenido revelado a través de controles de página normales o renderizado del lado del cliente. Esto no está garantizado. La estructura de páginas y la implementación varían, por lo que las aplicaciones no deben suponer que todos los pasajes devueltos eran visibles en el estado inicial de la página o que todos los elementos ocultos siempre se excluirán.
¿Cómo mantiene Microsoft la calidad del índice?
Las páginas se evalúan por calidad, autoridad y confiabilidad. Se detecta y excluye contenido malintencionado, spam y phishing, y el índice se actualiza continuamente. Es el mismo índice del que dependen los propios productos de inteligencia artificial de Microsoft.
¿Cómo respeta Web IQ las preferencias de contenido del editor?
Web IQ está diseñado para respetar los controles de publicador admitidos, incluidas las directivas de robots.txt aplicables y otras señales de publicador reconocidas por Microsoft.
¿Hay una lista publicada de sitios excluidos o categorías bloqueadas?
N.º Los controles de exclusión incluyen cumplimiento de robots.txt, retiradas por motivos legales y de cumplimiento (como avisos de la DMCA y órdenes judiciales), correo no deseado, malware y filtrado de suplantación de identidad (phishing) y filtrado de contenido para adultos. Las listas son propietarias y se actualizan continuamente. Si tiene dudas sobre categorías específicas de contenido que aparecen o no aparecen, en los resultados, póngase en contacto con el soporte técnico de Web IQ para analizar si la configuración del perfil de aplicación aborda esos requisitos.
¿Qué contenido cubre Web IQ y qué tan actualizado está?
Web IQ obtiene continuamente información nueva en páginas web, noticias e imágenes y resultados de vídeo para ayudar a tu agente de IA o aplicación a responder preguntas más allá de los datos de entrenamiento de su modelo.
La disponibilidad y la actualización varían según la API, el tipo de origen y el caso de uso; no hay ninguna garantía de actualización única en todo el contenido. Tenga en cuenta los requisitos de recencia de la carga de trabajo al elegir los orígenes y la configuración de recuperación.
¿Qué idiomas y mercados admite Web IQ?
Web IQ se basa en la web global, pero la cobertura varía según el idioma, el mercado, el tema y el tipo de origen. Revise la página Idiomas y regiones admitidos para ver los códigos que acepta cada API y evalúe la cobertura en función de la información que necesitan los usuarios previstos.
¿Puedo configurar listas de dominios permitidos o bloqueados?
Para dominios individuales o listas pequeñas, use operadores de consulta estándar como site:example.com para incluir un dominio y -site:example.com excluir uno. Las listas configurables más grandes no se exponen actualmente como una característica administrada por el cliente.
¿Por qué no veo resultados de LinkedIn?
Los resultados de LinkedIn están excluidos actualmente.
¿Qué ocurre cuando se llama a Browse para una dirección URL excluida?
Browse devuelve HTTP 403. La lista de exclusión subyacente no se expone.
¿Cómo puedo hacer que Web IQ pueda encontrar mi sitio web?
Web IQ se basa en el mismo índice web que Microsoft usa para sus propios productos de inteligencia artificial. Utilice prácticas estándar de descubrimiento web, como sitemaps, IndexNow, Herramientas de administrador web de Bing y una directiva de robots.txt adecuada. No hay ninguna ruta de envío de Web IQ independiente.
Comportamiento de la consulta y calidad de los resultados
¿Debo usar consultas en lenguaje natural o de palabras clave?
Ambos funcionan. Las consultas de lenguaje natural suelen funcionar bien con contentFormat=passage, mientras que las consultas de palabras clave son útiles para búsquedas precisas, como nombres de empresa, símbolos bursátiles o temas específicos. Evite consultas excesivamente largas o compuestas; divida varias necesidades de información en llamadas API independientes.
¿Cuál es la longitud máxima de la consulta?
El máximo es de 1000 caracteres y se rechazan las consultas más largas. Las consultas más cortas y centradas suelen generar mejores resultados: si una consulta contiene mucho contexto, es posible que la recuperación no se centre en la señal correcta.
¿Puedo filtrar los resultados de búsqueda web por fecha?
Búsqueda web no ofrece un filtro de intervalo de fechas en la actualidad y se recomienda evitar un filtro de fecha dura a menos que realmente necesite uno. La actualidad ya se ha factorizado en la clasificación en función de la consulta y agregar una restricción de fecha dura casi siempre cuesta relevancia. Para escenarios de noticias, use la News API en lugar de filtrar los resultados de búsqueda web por fecha.
lastUpdatedAt es la fecha en la que el publicador actualizó por última vez el contenido, no la fecha en la que web IQ comprobó por última vez la página, por lo que una fecha anterior no significa que la página no se haya comprobado recientemente. Se devuelve en la respuesta, no es un filtro de solicitud y no todos los resultados lo incluyen. Puede usarlo para ordenar o filtrar los resultados de la aplicación.
¿Puede Web Search gestionar un mensaje que contenga varias preguntas?
Cada solicitud de búsqueda web procesa una consulta. Si una solicitud contiene varias preguntas o intenciones, dividala en consultas independientes en la aplicación, llame a Búsqueda web para cada una y combine los resultados antes de generar la respuesta.
¿Puede Web IQ admitir flujos de trabajo de agente de varios pasos?
Yes. Un agente puede llamar a Web IQ siempre que necesite evidencia web adicional durante una tarea. La latencia de recuperación es especialmente importante en los flujos de trabajo que realizan varias llamadas antes de generar una respuesta.
¿Cómo debe gestionar mi agente de IA o la aplicación las pruebas recuperadas?
Utilice evidencia relevante para la pregunta y realice un seguimiento de las fuentes que admiten la respuesta. Mantenga el contenido recuperado independiente de las instrucciones que controlan el agente. Cuando las fuentes entren en conflicto o la evidencia sea incompleta, deje clara esa incertidumbre en lugar de rellenar las lagunas con afirmaciones no respaldadas.
¿Cómo se compara la calidad de conexión a tierra?
Microsoft informa de la mayor satisfacción de fundamentación en su comparación publicada, con una puntuación de 79,05. Los resultados dependen del conjunto de consultas, el modelo y el método de evaluación, por lo que valide la calidad en sus propios escenarios.
Fuente: Resultados de pruebas comparativas de Web IQ. 3K Global, Consultas ciegas muestreadas de prod, Config: 10 resultados, 10 000 caracteres por resultado (o equivalente).
¿Por qué los resultados difieren de Bing.com?
Web IQ está optimizado para el consumo de LLM, la densidad fáctica, la calidad del pasaje y la baja latencia. Bing.com es una experiencia para el consumidor con señales de clasificación adicionales, personalización, respuestas visuales y contenido que puede no ser redistribuible a través de una API. Se esperan algunas diferencias de clasificación.
¿Pueden las solicitudes idénticas devolver resultados diferentes?
Se espera alguna variación porque el índice se actualiza continuamente y las actualizaciones se propagan entre centros de datos. Los resultados de solicitudes idénticas realizadas con poca diferencia de tiempo deben permanecer ampliamente estables. Si ve una varianza significativa en consultas idénticas en cuestión de segundos, póngase en contacto con el soporte técnico de Web IQ.
¿Por qué una consulta devuelve menos resultados de lo esperado?
Compruebe la respuesta de Web IQ sin procesar antes de contar los resultados. La causa más común es una configuración del lado cliente o un paso de canalización de bajada que filtra los resultados válidos antes de medirlos.
maxResultsCompruebe también la idoneidad del contenido, el comportamiento de SafeSearch y los operadores site: o -site: en la consulta.
Contenido de la respuesta
¿Por qué Web Search y News Search no devuelven un campo snippet?
Esto es así por motivos de diseño. Ambos devuelven content como un extracto dependiente de la consulta (passage) en lugar de un snippet independiente de la consulta y separado.
¿Qué formatos de contenido admite Web Search?
Con passage, cada resultado devuelve las partes del documento más relevantes para la consulta, hasta maxLength caracteres (sin acceso completo al documento, como máximo 3000). Es el formato recomendado para la puesta a tierra. Las aplicaciones con acceso completo a documentos también pueden usar text, htmly markdown. Consulte Fragmentos y formatos de contenido.
¿Qué es passagey por qué usarlo?
Configure contentFormat=passage y la API devuelve, para cada resultado, solo los segmentos del documento más relevantes para la consulta, no el documento completo. El documento completo se procesa en el lado de Web IQ y lo que vuelve es un extracto orientado a la consulta, por lo que su LLM no tiene que pasar por alto párrafos no relacionados para encontrar la frase pertinente.
- Ahorros de tokens: LLM recibe una fracción del documento en lugar de todo ello.
- Mayor rigor factual: con menos contenido fuera del tema en el contexto, es menos probable que el modelo se ancle en un párrafo tangencial.
Establezca contentFormat=passage en todas las solicitudes de búsqueda web y noticias. Browse no admite passage, ya que recupera una dirección URL específica que ya eligió y no hay ninguna consulta de la que extraer.
¿Cuál es el valor máximo maxResults de Web Search?
Web Search admite hasta 50 resultados por solicitud.
¿Qué parámetros de solicitud puedo configurar?
Web Search expone maxResults, language y region, contentFormat (passage, text, htmlo markdown), maxLengthy safeSearch. Consulte la referencia de API para obtener la lista completa de parámetros.
¿Cuál es la diferencia entre lastUpdatedAt y crawledAt?
lastUpdatedAt es la fecha de actualización de contenido notificada por el publicador, devuelta por Web Search, News, Videos, Images, Browse y Auto cuando esté disponible.
crawledAt es la hora en que Web IQ recuperó por última vez la página, devuelta por Web Search, Browse, News y Auto. La cobertura de ambos campos varía según el resultado.
¿Cómo debo ajustar maxResults y maxLength para administrar los costos de ventana de contexto y token?
Web IQ puede priorizar los pasajes relevantes para una consulta en lugar de proporcionar contexto de página innecesario. Esto puede reducir la cantidad de texto pasado al modelo y reducir los costos de token de entrada. Las ventajas dependen del modelo, los prompts, la combinación de consultas y la configuración de recuperación.
Para la mayoría de los escenarios de fundamentación, más resultados con pasajes más cortos proporcionan una mejor salida que menos resultados con pasajes más largos para aproximadamente el mismo presupuesto total de tokens. Un buen punto de partida es maxResults=10 con maxLength alrededor de 3000 caracteres en passage formato. Prueba comparativa con sus propias consultas y modelo.
¿Qué es Browse Live Crawl y cuándo debo usarlo?
Examinar devuelve contenido del índice web de Bing, que se actualiza continuamente a medida que nuestros rastreadores observan los cambios en la web. Así es como funciona la búsqueda web en general: los resultados de búsqueda se sirven desde un índice en lugar de obtener cada URL en tiempo real en cada solicitud, y es lo que proporciona a Browse su velocidad y coherencia.
En escenarios que necesitan específicamente una captura Just-In-Time de la dirección URL en el momento de la solicitud, como la supervisión en tiempo real, las comprobaciones competitivas o los flujos de trabajo que se activan cuando se produce un cambio del que sabe que acaba de producirse, Browse admite el rastreo en vivo. Establezca liveCrawl: "fallback" en la solicitud para activar una recuperación en vivo cuando falta la copia indizada o está obsoleta. Si se omite el parámetro (o se establece liveCrawl: "none") solo se devuelve contenido indizado. Consulte la referencia de Browse API para obtener detalles completos de los parámetros.
Live Crawl está disponible de forma predeterminada en Web IQ Browse y se aprovisiona con un límite de capacidad por segundo moderado, independiente de su QPS general de Browse. Este límite se comparte entre todas las claves de API bajo el AppID. La mayoría de las cargas de trabajo Browse no necesitan Live Crawl y son mejor atendidas por la ruta de acceso indexada estándar; use Live Crawl para el conjunto estrecho de escenarios anteriores.
¿Puede Browse recuperar páginas renderizadas por JavaScript?
Yes. Usa renderDynamicPages: true junto con liveCrawl: "fallback". Consulte la referencia de Browse API para ver el conjunto de parámetros completo y los detalles de respuesta. Pruebe las direcciones URL representativas antes de depender de este comportamiento en producción.
¿Puede Browse extraer archivos PDF en línea?
Los archivos PDF hospedados en línea no son un escenario de exploración documentado actualmente. Si tiene un caso de uso específico de PDF, póngase en contacto con el soporte técnico de Web IQ con una dirección URL representativa y el comportamiento esperado y obtendrá una respuesta definitiva.
Facturación y aspectos legales
¿Qué cuesta Web IQ?
Web IQ usa precios por consumo y por llamada. Los precios dependen de las API habilitadas para su cuenta, el uso y los términos comerciales. Consulte Precios para conocer las tarifas actuales.
¿Web IQ incluye un acuerdo de nivel de servicio, RTO o RPO?
N.º Microsoft Web IQ no incluye un contrato de nivel de servicio. Los términos de uso de Web IQ no garantizan objetivos de tiempo de actividad, latencia, objetivo de tiempo de recuperación (RTO) ni objetivo de punto de recuperación (RPO), y los términos del Acuerdo de Nivel de Servicio no se agregan para clientes individuales.
¿Necesito mostrar referencias?
Yes. El Anexo A, sección 1 (uso de LLM) de los Términos de uso de Web IQ requiere la atribución de origen y un vínculo a cada origen usado para el contenido LLM mostrado, cerca de ese contenido.
- Cita solo las fuentes usadas realmente para generar la respuesta. Si Web IQ devolvió 10 resultados y el modelo usó 3, muestre esos 3.
- Las citas deben permanecer visibles con la respuesta y ser accesibles con una sola acción. No los muestres solo brevemente, ocultarlos detrás de varias pantallas o exigir a los usuarios que soliciten fuentes por separado.
- En el caso de interfaces restringidas, como automóviles, dispositivos portátiles, dispositivos controlados por voz o quioscos, use un código QR persistente que se resuelva en una página que muestre todas las citas usadas para la respuesta actual, una aplicación complementaria que muestre la respuesta con citas en las que se pueden hacer clic o una lista en pantalla que el usuario pueda abrir directamente.
Puede almacenar referencias como parte del historial de chat de un usuario final individual durante un máximo de 30 días. Consulte la pregunta de almacenamiento en caché a continuación.
¿Cuánto contenido de origen puede mostrar mi agente de IA o aplicación?
El Anexo A de los Términos de uso de Web IQ limita el Grounding Content mostrado de cualquier fuente individual al menor de 200 caracteres o el máximo especificado por el propietario del sitio web o el webmaster. En el caso de las experiencias de voz o audio, aplique el mismo límite a la salida hablada. Se aplican restricciones adicionales a los resúmenes y a la visualización. Revisar los Términos de uso antes de diseñar extractos; este límite no es permiso para reproducir páginas de origen completas.
¿Se pueden usar los resultados de imágenes y vídeos para fundamentar un LLM?
Los metadatos de imagen y vídeo y el texto alternativo se incluyen en la definición de Grounding Content. Sin embargo, los Términos de uso de Web IQ prohíben el uso de imágenes o vídeos reales de los resultados para grounding, incluidos en la salida de LLM, o la creación de imágenes o vídeos derivados de ellos. Revise los términos de la implantación prevista.
¿Puedo almacenar en caché o almacenar contenido de Web IQ?
Como regla general, no. Los Términos de uso de Web IQ prohíben copiar, almacenar, almacenar, archivar o crear una base de datos de contenido, excepto en excepciones estrechas (sección 3.2.15 y sección 4 de los documentos A y B):
- Historial de chat del usuario final (hasta 30 días): el contenido se puede almacenar en una base no agregada por usuario final para el historial de chat de un usuario final individual durante un máximo de 30 días. Para uso de LLM (Anexo A), esto abarca el contenido en general; para uso de búsqueda (Anexo B), abarca las direcciones URL de imágenes y vídeos.
- Procesamiento transitorio de acción atómica: el contenido se puede mantener en un estado de procesamiento transitorio solo según sea estrictamente necesario para completar una única solicitud lógica o flujo de trabajo iniciado por un LLM (una "acción atómica", que puede implicar varios pasos internos o interacciones agenteicas). El contenido debe eliminarse rápidamente cuando se complete la Atomic Action.
- Su propio producto de trabajo: en la medida en que lo permita la ley de derechos de autor, el contenido se puede copiar o almacenar como parte integrada de su propio producto de trabajo, siempre que el producto de trabajo no se cree para sustituir los Servicios (por ejemplo, la creación de una base de datos de Contenido, vínculos de indexación para rastreo o ofrecer una búsqueda independiente).
Fuera de estas excepciones, los Términos de uso no permiten bases de datos derivadas, almacenamiento en caché persistente ni archivado a largo plazo del contenido.
¿Dónde puedo leer los Términos de uso de Web IQ?
Los términos actuales se publican en Microsoft Términos de uso de Web IQ. Se aplican junto con su Contrato de cliente de Microsoft existente.
Acceso completo al documento
¿Por qué obtengo HTTP 403 cuando configuro contentFormat en html?
En Búsqueda web y Búsqueda de noticias, text, htmly markdown devuelven el documento completo y están disponibles para las aplicaciones con acceso completo al documento. Otras aplicaciones obtienen HTTP 403 con el código AuthContentFormatForbiddende error .
passage funciona para cada aplicación. Consulte Fragmentos y formatos de contenido.
¿Cómo solicito acceso completo al documento?
Abra una solicitud de soporte técnico de Web IQ a través de Azure Support y elija la categoría de contenido de página completa. Aplicaciones que ya usan html o text siguen funcionando como hoy.