Agregar experiencias de agente y Microsoft 365 Copilot

Se aplica a: Desarrollador

Las experiencias de agente de SharePoint Embedded permiten que la aplicación responda a preguntas sobre los archivos almacenados en contenedores de SharePoint Embedded. Dos productos distintos fundamentan esas experiencias en el contenido del contenedor:

• Microsoft Foundry Agent Service con un origen de conocimiento de SharePoint , para los agentes que compiles en Foundry. Fundición ejecuta la recuperación por usted como parte del agente. Para obtener los pasos de configuración, consulte Configurar SharePoint Embedded como un origen de conocimiento de Fundición.
• API de recuperación de Microsoft 365 Copilot: para agentes personalizados y aplicaciones que ejecutan su propio paso de conexión a tierra. Llámelo desde cualquier aplicación, incluido un agente de Fundición que no use el origen de conocimiento de SharePoint.

Elija el origen de conocimiento cuando desee que Foundry administre la recuperación y la orquestación del agente. Elige la API de recuperación cuando desees controlar el paso de conexión a tierra, la consulta y el modelo tú mismo.

Precaución

El SDK anterior del agente de SharePoint Embedded (el control ReactChatEmbedded) quedó en desuso en marzo de 2026 y fue sustituido por el servicio de agente de Microsoft Foundry por un origen de conocimiento de SharePoint (versión preliminar) configurado para SharePoint Embedded. Use una de las dos opciones de este artículo para trabajos nuevos.

Uso de la API de recuperación

La API de recuperación de Microsoft 365 Copilot devuelve extractos de texto relevantes que la aplicación pasa a su propio modelo como datos de fundamentación. Establézcalo dataSource en sharePointEmbedded para recuperar desde el contenido de SharePoint Embedded.

Nota:

La compatibilidad de la API de recuperación con el origen de sharePointEmbedded datos está en versión preliminar.

Requisitos previos de la API de recuperación

• Una aplicación de SharePoint Embedded con al menos un contenedor, más el identificador de tipo de contenedor.
• Facturación de pago por uso configurada para el tipo de contenedor.
• Al menos un usuario en el inquilino con una licencia de Microsoft 365 Copilot, por lo que se inicializa el índice semántico. Para obtener más información, consulte Índice semántico para Microsoft 365 Copilot.

El sharePointEmbedded origen de datos factura el pago por uso, por lo que cada usuario que consulta la API de recuperación no necesita una licencia individual de Microsoft 365 Copilot.

Recuperar contenido de un tipo de contenedor

Llamada POST /copilot/retrieval con un token delegado. Establézcalo dataSource y pase el identificador de tipo de contenedor en dataSourceConfiguration.sharePointEmbedded La solicitud necesita el FileStorageContainer.Selected permiso delegado y el servicio recorta los resultados al contenido al que pueda acceder el usuario que ha iniciado sesión.

POST https://graph.microsoft.com/v1.0/copilot/retrieval
Content-Type: application/json

{
  "queryString": "What are the terms of the Contoso agreement?",
  "dataSource": "sharePointEmbedded",
  "dataSourceConfiguration": {
    "sharePointEmbedded": {
      "containerTypeId": "{containerTypeId}"
    }
  }
}

Reemplácelo {containerTypeId} por el identificador de tipo de contenedor.

La respuesta devuelve una retrievalHits colección. Cada resultado identifica un archivo de origen y webUrl lleva uno o varios extracts, ordenados por relevanceScore.

{
  "retrievalHits": [
    {
      "webUrl": "https://contoso.com/spe/file",
      "extracts": [
        {
          "text": "The agreement renews annually unless either party gives 30 days' notice.",
          "relevanceScore": 0.8421
        }
      ]
    }
  ]
}

La forma depende de la configuración del tipo de webUrlurlTemplate contenedor, por lo que debe tratarlo como un vínculo opaco en lugar de analizarlo. Para resolver los detalles del archivo, llame a Obtener un elemento de unidad. Para obtener más información sobre urlTemplate, consulte Creación y configuración de un tipo de contenedor.

Para devolver campos adicionales, como title o author con cada visita, agregue una resourceMetadata colección a la solicitud. Solicite solo los campos que usa la aplicación, ya que cada campo se suma a la carga de respuesta.

Pase las extracciones a su propio modelo o paso de generación de respuestas como datos de fundamentación. Este fragmento envía la consulta y lee el extracto principal de cada acierto:

const response = await fetch("https://graph.microsoft.com/v1.0/copilot/retrieval", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`
  },
  body: JSON.stringify({
    queryString: query,
    dataSource: "sharePointEmbedded",
    dataSourceConfiguration: {
      sharePointEmbedded: { containerTypeId: containerTypeId }
    }
  })
});

const data = await response.json();
const grounding = (data.retrievalHits ?? []).map(hit => ({
  url: hit.webUrl,
  text: hit.extracts?.[0]?.text?.trim(),
  score: hit.extracts?.[0]?.relevanceScore
}));

La recuperación cubre todos los contenedores del tipo de contenedor a los que puede acceder el usuario que ha iniciado sesión. Si una solicitud no devuelve resultados, confirme que el índice semántico se inicializó, que la indexación finalizó y que el usuario tiene acceso al contenido.

Facturación de API de recuperación

Las solicitudes de API de recuperación que usan la factura del origen de sharePointEmbedded datos en el medidor de mensajes de Copilot Studio. Los cargos siguen el modelo de facturación configurado para el tipo de contenedor. La facturación Standard cobra la suscripción a Azure del inquilino propietario y la facturación transferida cobra la suscripción del inquilino consumidor.

Para obtener detalles sobre los medidores, consulte Medidores de facturación. Para comparar modelos, consulte Elegir un modelo de facturación.

Probar la experiencia del usuario

Inicie sesión con un usuario que pueda acceder al contenido del contenedor. Cargue los archivos compatibles en un contenedor, espere a que se indexen, abra el chat y formule preguntas que el contenido del archivo pueda responder. Si las respuestas omiten los archivos esperados, compruebe:

• Detectabilidad.
• Formatos de archivo admitidos.
• Acceso a la aplicación.
• Acceso de usuarios.
• Selección de ámbito.
• Retraso de indexación.

Pasos siguientes

• Configurar SharePoint Embedded como un origen de conocimiento de Fundición
• Medidores de facturación
• Elegir un modelo de facturación