Agente de actas para Teams · para IT
Lo que pide, y por qué.
Alguien de vuestro equipo quiere que el acta de cada reunión salga sola. Esto es lo que el agente necesita de vuestro Microsoft 365, lo que hace con ello y cómo acotarlo.
- Dónde corre
- En un ordenador o servidor vuestro
- Envía correos
- No. Solo deja borradores
- Cómo se identifica
- Con un certificado. La clave no sale de vuestro equipo
- El programa
- Un fichero de Python de unas 440 líneas, legible
- Servidores de terceros
- Microsoft y Anthropic. Ninguno mío
Qué hace, y con quién habla en cada paso.
Cinco pasos. En dos habla con Microsoft Graph, en uno con Claude y en el último no hace nada: espera a una persona.
- TeamsAcaba la reuniónTeams cierra la transcripción.
- Graph · solo lecturaEl agente la recogePregunta a Microsoft Graph cada minuto si hay una nueva.
- AnthropicClaude escribe el actaRecibe la transcripción y las reglas del equipo. Devuelve el acta.
- Graph · escrituraLo deja en su sitioWord en OneDrive, borrador en Outlook, filas en el Excel y tareas en Planner.
- VosotrosLo revisa una personaEl agente no envía ningún correo.
Los seis permisos, uno a uno.
Son permisos de aplicación de Microsoft Graph, con consentimiento de administrador. Para cada uno, para qué lo usa el agente y cómo se limita.
| Permiso | Para qué lo usa | Cómo se limita |
|---|---|---|
OnlineMeetingTranscript.Read.All | Leer la transcripción cuando acaba la reunión. | Con la política de acceso de aplicación de Teams: se concede a las personas que elijáis, no a toda la organización. |
OnlineMeetings.Read.All | Leer el asunto y quién asistió. | La misma política de Teams. |
User.Read.All | Sacar el nombre y el correo de los asistentes. | Es solo de lectura del directorio. |
Mail.ReadWrite | Dejar el correo en Borradores del organizador. No se pide Mail.Send: no puede enviar. | Con RBAC para aplicaciones de Exchange: se acota a los buzones que digáis. |
Files.ReadWrite.All | Subir el acta en Word a OneDrive y añadir filas al Excel de seguimiento. | Es el más amplio. Si no lo queréis así, el programa se adapta para escribir en un sitio de SharePoint con Sites.Selected. |
Tasks.ReadWrite.All | Crear una tarea por acción en Planner. | Es opcional. Sin Planner no se concede y el agente sigue funcionando. |
Tal como viene, la política de Teams se concede a toda la organización.
El script politica-acceso.ps1 acaba con -Global. Para dársela solo a unas personas, cambiad esa línea por esta, una vez por persona:
Grant-CsApplicationAccessPolicy -PolicyName Agente-Actas -Identity persona@vuestraempresa.com
Dónde van los datos.
La transcripción sale de Microsoft, pasa por Claude y vuelve a Microsoft convertida en acta. No pasa por ningún servidor mío.
La transcripción va a Claude
Para escribir el acta. Con la suscripción de la persona o con una clave de API de vuestra organización, bajo vuestro contrato con Anthropic.
No se guarda en disco
El agente la lee, la manda y la suelta. En su carpeta solo queda la lista de reuniones ya procesadas, para no repetirlas.
La clave privada no sale
A Entra se sube el certificado público. La clave se queda en la carpeta del agente, en el equipo donde corre.
Sin llamadas a otros sitios
El programa solo habla con el inicio de sesión de Microsoft, con Microsoft Graph y con Claude. Se puede comprobar leyéndolo.
Nada clínico en el acta
Las reglas piden dejar fuera datos de pacientes y anotarlo como tema abierto. Es una instrucción a la IA: revisadlo con quien lleve protección de datos.
Lo que sale lo revisa una persona
El acta, el correo y las tareas quedan preparados. El envío es siempre de quien organiza la reunión.
El alta, en tres pasos.
Se hace una vez. Lo más lento es la espera de Microsoft: hasta 24 horas el acceso a las transcripciones y hasta 30 minutos la política.
Administración de Teams
En Reuniones, Directivas de reunión: la transcripción, activada. En Reuniones, Configuración de reuniones: el acceso de Microsoft Graph a las transcripciones, activado. Sin esto, la API contesta
403 GraphAccessToTranscriptsDisabled.Entra, registro de la aplicación
Un registro nuevo, «Agente de actas», con un certificado, los permisos de la tabla y el consentimiento de administrador. El identificador de la aplicación y el del inquilino van al fichero
.envdel agente.La política de acceso a las reuniones
Con el módulo de PowerShell de Teams, una vez. El script va en la carpeta del agente y lee el identificador del
.env.powershell -ExecutionPolicy Bypass -File politica-acceso.ps1
Cómo se retira, y lo que no es.
Retirarlo son tres cosas
Parar el programa, borrar el registro de la aplicación en Entra y quitar la política de Teams. No instala nada en vuestro Microsoft 365.
Sin soporte ni garantía
Es un punto de partida que se da tal cual. Si lo queréis mantenido, lo monto y lo mantengo yo, con un presupuesto.
Solo reuniones programadas
Microsoft no entrega por la API las transcripciones de «Reunirse ahora». Y tarda unos minutos en cerrar cada una al colgar.
¿Lo repasamos con vuestro IT?
Media hora, con el programa abierto. Vemos los permisos, qué se acota en vuestro caso y dónde lo pondríais a correr.