Lección 2 · Lectura, paginación y miembros: alcance del contexto
Interpreta qué información devuelve cada consulta y qué puede quedar fuera.
Leer respuestas no es leer automáticamente todo el hilo
La herramienta read_thread llama a la función que consulta las respuestas del hilo. El contrato y su implementación no permiten asumir que esa misma llamada incluya el mensaje inicial. list_threads consulta los mensajes del canal. La comprensión de una conversación puede necesitar relacionar resultados de herramientas diferentes.
Si un cliente resume información parcial sin identificar esa limitación, el problema no está resuelto por el hecho de haber usado una API estructurada. El alcance temporal, las páginas recibidas y la presencia del contexto inicial influyen en lo que el cliente puede afirmar.
El límite de página
En las herramientas de mensajes y respuestas, limit tiene máximo de cincuenta. La respuesta puede incluir un cursor para obtener otra página. Ese tamaño no significa que el canal o el hilo contengan como máximo cincuenta elementos, ni que una sola llamada recupere todo el historial disponible.
El campo total también requiere lectura del código: cuando Microsoft no aporta un recuento, la implementación utiliza la longitud de los elementos recibidos. Por ello no se puede interpretar siempre como un censo completo de la conversación. El cursor y la respuesta efectiva explican si el recorrido puede continuar.
| Dato u operación | Significado en el código | Inferencia que no permite |
|---|---|---|
| read_thread | Respuestas de un hilo | Que incluya automáticamente el mensaje inicial |
| limit | Tamaño de la página solicitada | Que limite el volumen total de la conversación |
| cursor | Continuación de la consulta | Que las páginas siguientes ya se hayan leído |
| total sin recuento externo | Longitud de los elementos recibidos | Que describa siempre el total existente |
Validación del cursor
El cliente comprueba que el cursor use HTTPS, corresponda a graph.microsoft.com y conserve la ruta del equipo y canal configurados, o de las respuestas del hilo pertinente. Rechaza rutas y formas que no satisfacen esas condiciones. Este mecanismo limita el destino de continuación; no demuestra por sí solo que el usuario o el agente deban tener acceso al contenido.
La validación técnica de una URL y la autorización de lectura son controles diferentes. La primera comprueba una forma y un destino admitidos; la segunda responde a quién puede consultar esos datos y para qué finalidad.
Miembros y coincidencias de nombre
list_members recorre las páginas hasta reunir la lista de miembros. Su tamaño de página admite un máximo de cien, pero no es un límite total de personas recuperadas. get_member_by_name utiliza la lista y devuelve la primera coincidencia exacta del nombre encontrada. El código no muestra un proceso independiente de desambiguación de personas con el mismo nombre.
La información de miembros incluye identificadores, nombre y correo. Es información de identidad que el cliente puede recibir y utilizar para menciones. Buscar un nombre y resolver la persona adecuada son cuestiones relacionadas, pero no idénticas. Los módulos de datos y seguimiento ayudan a interpretar la cobertura y la minimización de esas consultas.
Amplía este punto en el curso
Módulo 7 · Datos y seguridad. Amplía la minimización y el acceso a datos de conversaciones y miembros.
Módulo 10 · Seguimiento y medición. Ayuda a interpretar recuentos, cobertura y contexto incompleto.