AI Agents for Beginners: el curso oficial de Microsoft para construir agentes de IA

Todo lo que hay que saber sobre microsoft/ai-agents-for-beginners: una formación de código abierto, licenciada MIT, de 18 lecciones con vídeos y cuadernos Python/.NET que enseña a diseñar y desplegar agentes de IA sobre el stack propio de Microsoft —Microsoft Agent Framework y Microsoft Foundry—.

Desambiguación: este informe documenta el curso oficial de la organización microsoft en GitHub. No debe confundirse con las varias réplicas y manuales comunitarios que comparten palabras clave (ai-agents, agentic-ai-for-beginners, etc.) y que aparecen en la búsqueda de repositorios; aquí se analiza solo el repositorio de primera parte de Microsoft.

Qué es AI Agents for Beginners

AI Agents for Beginners es un curso de autoformación publicado por Microsoft, no una librería ni un framework en sí mismo. El producto son 18 lecciones escritas (más una lección 00 de instalación), cada una con un vídeo corto, muestras de código Python (y en algunas, C#) y enlaces de profundización. Su objetivo es cubrir «todo lo que hay que saber para empezar a construir agentes de IA», desde qué es un agente hasta el despliegue a producción.

No ejecuta nada por sí solo: es material didáctico cuyo código apoya dos piezas de infraestructura reales de Microsoft —Microsoft Agent Framework (MAF) para orquestar agentes y Microsoft Foundry Agent Service V2 (el Responses API) como servicio de inferencia. En la práctica el repo funciona como la puerta de entrada documentada al stack de agentes de Microsoft, con el mismo formato que su familia de cursos «for Beginners» (Generative AI, MCP, LangChain, AZD, Edge AI).

El origen

El repositorio se creó el 28 de noviembre de 2024 bajo la organización microsoft. Su evolución queda reflejada en sus propias etiquetas (topics), que conservan huellas de varios momentos: autogen, semantic-kernel por un lado y foundry, microsoft-foundry, agent-framework por otro.

El recorrido técnico es coherente con la estrategia de agentes de Microsoft. En 2024 el ecosistema de agentes de la compañía se apoyaba en AutoGen y Semantic Kernel, y el curso nació en ese contexto: el primer envío verificable en Hacker News, de koreyspace el 14 de febrero de 2025, titulaba el curso «A 10 Lesson Course». Desde entonces el curso creció hasta las 18 lecciones actuales y se reescribió para construirse sobre el sucesor unificado: Microsoft Agent Framework, que la documentación oficial de Microsoft describe como «el sucesor directo, creado por los mismos equipos, que combina las abstracciones simples de AutoGen con las capacidades empresariales de Semantic Kernel». El README y el requirements.txt dejan constancia de la transición: los cuadernos usan MAF con FoundryChatClient, y el archivo de dependencias está fijado a agent-framework-core==1.10.0 porque la 1.11.0 introdujo cambios rompedores.

El mantenimiento es un esfuerzo de educación de Microsoft, no un proyecto de un único autor. Los enlaces del README llevan el rastreo WT.mc_id=academic-105485-koreyspace, y el README agradece de forma expresa a Shivam Goyal por las muestras de código de Agentic RAG. Los principales contribuidores son leestott, skytin1004 y koreyspace, además del bot Copilot.

Filosofía y principios

El curso no propone una metodología de ingeniería ni una opinión sobre el estado del arte; su «filosofía» es la de material de adopción: aprender la pila propia de Microsoft de arriba abajo y llegar a producción con los controles que esa pila ofrece. De las lecciones se desprende un conjunto de ideas recurrentes y verificables:

El agente como sistema, no como «chat». La lección 1 define un agente con entorno, sensores y actuadores y distingue tipos (reflejo simple, basado en modelo, por objetivo, por utilidad, de aprendizaje, jerárquico y multiagente). El énfasis es en el «hacer cosas» (llamar herramientas, acceder a memoria), no solo en generar texto.
Patrones de diseño agénticos como unidad didáctica. El curso está estructurado alrededor de patrones reutilizables: tool use, planning, multi-agent, metacognition y agentic RAG, más la ingeniería de contexto y la memoria.
Seguridad y confianza como requisito, no como adorno. Hay lecciones dedicadas a construir agentes fiables (6), a producirlos en entorno de producción (10) y a asegurarlos (18, con recibos criptográficos).
Interoperabilidad y agnosticismo. MAF se presenta como agnóstico de nube y de proveedor, e integrado con estándares abiertos (MCP, A2A) y conectores a Fabric, SharePoint, Pinecone y Qdrant. La lección 17 permite además correr agentes localmente con Foundry Local.

Cómo funciona

El curso sigue una progresión en 18 pasos. Cada lección tiene un README de texto, un vídeo (lecciones 1 a 12) y cuadernos de código etiquetados *-python-agent-framework.ipynb (y en su caso *-dotnet-agent-framework).

Las lecciones, según la tabla del README: 1. Introducción a los agentes de IA y casos de uso. 2. Exploración de frameworks agénticos. 3. Patrones de diseño agéntico. 4. Patrón Tool Use. 5. Agentic RAG (RAG agéntico). 6. Construcción de agentes de IA fiables. 7. Patrón de planificación (Planning). 8. Patrón multiagente. 9. Patrón de metacognición. 10. Agentes de IA en producción. 11. Protocolos agénticos (MCP, A2A y NLWeb). 12. Ingeniería de contexto para agentes de IA. 13. Gestión de la memoria agéntica. 14. Exploración de Microsoft Agent Framework. 15. Agentes de uso de computadora (CUA / browser use). 16. Despliegue de agentes escalables. 17. Creación de agentes de IA locales. 18. Seguridad de los agentes de IA.

El flujo técnico central (lecciones 14 en adelante) se apoya en MAF. Crear un agente consiste en definir el servicio de inferencia, unas instrucciones y un nombre (por ejemplo AzureOpenAIChatClient(...).create_agent(instructions=..., name=...)); el agente se ejecuta con .run() o .run_stream(). MAF documenta orquestaciones secuencial, concurrente, de grupo, de handoff y «magnética» (un agente gestor crea y modifica una lista de tareas y coordina subagentes), y añade observabilidad (OpenTelemetry + paneles de Foundry), durabilidad (pausar/reanudar hilos) y human-in-the-loop.

El repo incluye además un catálogo de pruebas de humo (tests/lesson-01-smoke-tests.json, lesson-04, lesson-05, lesson-16) para los agentes desplegables (TravelAgent, TravelToolAgent, TravelRAGAgent, ContosoSupportAgent), consumidos por la GitHub Action AI Smoke Test mediante el workflow .github/workflows/smoke-test.yml. Son una primera compuerta de «el agente desplegado responde y cumple las expectativas básicas», no el pipeline de evaluación completo de las lecciones 10 y 16.

Seguridad y modelo de confianza

Las lecciones 6, 10 y 18 forman un hilo continuo de fiabilidad: construir agentes fiables, producirlos con controles y asegurarlos con recibos criptográficos. El curso no trata la seguridad como un apéndice: la sitúa como requisito para llegar a producción, coherente con el resto del stack de Foundry (observabilidad, human-in-the-loop, pausas duraderas).

Además, la interoperabilidad forma parte del mismo principio de confianza: MAF se conecta con MCP y A2A como protocolos abiertos, con NLWeb, con agentes de uso de computadora (browser/computer use), y con Foundry Local para correr agentes sin depender de la nube, junto a conectores a Fabric, SharePoint, Pinecone y Qdrant.

Estado oficial y semioficial

Este repositorio es primera parte de Microsoft: vive en la organización microsoft, está licenciado MIT, usa enlaces cortos oficiales aka.ms (p. ej. https://aka.ms/ai-agents-beginners) y es el recurso educativo oficial para aprender el stack de agentes de Microsoft (MAF + Foundry). No existe un «marketplace» ni una certificación en el sentido de los plugins; su estatus oficial se manifiesta en la práctica:

Parte de la familia «for Beginners» de Microsoft, que incluye Generative AI for Beginners, MCP for Beginners, LangChain for Beginners, AZD for Beginners, Edge AI for Beginners, entre otros, todos enlazados desde el README.
Canal académico/desarrollador de Microsoft: los enlaces de rastreo WT.mc_id y la página aka.ms lo sitúan dentro de los materiales oficiales de adopción.
Comunidad respaldada: el curso canaliza a los alumnos al Microsoft Foundry Discord y al foro de desarrolladores de Foundry.
Estándar de facto: al ser la formación oficial para MAF/Foundry, funciona como referencia de facto para quienes quieren aprender ese stack en concreto. Esto no implica una designación formal de «estándar» externa a Microsoft.

El ecosistema

Frameworks y servicios de Microsoft (el «suelo» del curso): microsoft/agent-framework — el framework sobre el que se apoya el curso; «framework para construir, orquestar y desplegar agentes de IA y flujos multiagente en Python y .NET»; 13.048 estrellas, 2.214 bifurcaciones. La documentación oficial lo define como sucesor directo de Semantic Kernel y AutoGen, con guías de migración desde ambos. microsoft/autogen — «un framework de programación para IA agéntica»; 60.570 estrellas. Predecesor que aportó las abstracciones de agentes. microsoft/semantic-kernel — «integrar tecnología de LLM de forma rápida y sencilla en tus apps»; 28.478 estrellas. Predecesor que aportó las capacidades empresariales.

Cursos hermanos de Microsoft (mismo formato): microsoft/generative-ai-for-beginners — «21 lecciones, empieza a construir con IA generativa»; 118.336 estrellas, 62.384 bifurcaciones. El curso hermano más grande y la puerta de entrada que el README recomienda antes de este. microsoft/mcp-for-beginners — currículo sobre el Model Context Protocol en .NET, Java, TypeScript, JavaScript, Rust y Python; 17.043 estrellas. El README enlaza también LangChain for Beginners, LangChain.js for Beginners, LangChain4j for Beginners, AZD for Beginners, Edge AI for Beginners, y la serie completa de cursos de «Núcleo» (ML, Data Science, AI, Cybersecurity, Web Dev, IoT, XR) y de Copilot.

Traducciones y derivados comunitarios: traducciones oficiales (50+ idiomas), listadas en el README como mantenidas «a través de una GitHub Action (automatizada y siempre al día)» por Azure/co-op-translator. Viven en translations/<idioma>/ dentro del propio repo, no como repos separados. Entre los derivados comunitarios verificados: Microsoft-Stores/microsoft-ai-agents-for-beginners (59 estrellas, réplica de 11 lecciones orientada a Azure AI Foundry y Semantic Kernel), DTiapan/ai-agents-handbook (87 estrellas, manual integral de construcción de agentes), UnfoldDataScience/Agentic_Ai_For_Beginner (33 estrellas, código de un curso de Udemy) y Yash-Kavaiya/Agentic-AI-for-Beginners (21 estrellas).

Una búsqueda de repos por «ai-agents-for-beginners» devuelve 362 coincidencias, pero muchas son ruido que solo comparte palabras clave y no son derivados de este curso; solo los listados aquí están verificadamente relacionados.

Números del repo

Medición: 22 de agosto de 2026, API de GitHub.

Métrica	Valor
Estrellas	73.007
Bifurcaciones	24.133
Suscriptores reales	563
Commits	1.983
Incidencias + PR abiertos	9
Lenguaje principal	Jupyter Notebook
Licencia	MIT
Creación	28 de noviembre de 2024
Último push	18 de agosto de 2026
Número de lecciones	18 (más la lección 00 de instalación)

watchers_count replica las estrellas, por lo que se informa subscribers_count como suscriptores reales. La API de releases devolvió una lista vacía: el curso no publica releases formales en GitHub; la «versión» de referencia la marcan los pins de requirements.txt (agent-framework-core==1.10.0) y el conjunto de 18 lecciones. El clonado completo pesa ~3 GB por las 50+ traducciones; la guía indica clonado sparse/shallow para aligerarlo.

Top contribuyentes por contribuciones: leestott (570), skytin1004 (509), koreyspace (285), hyoshioka0128 (114), Copilot (bot, 60), ShivamGoyal03 (56), marietta-a (46). La presencia del bot Copilot y de varios colaboradores de Microsoft refleja un proyecto mantenido por el equipo de educación de la compañía.

Guía rápida de uso

Instalación y primer arranque

El «arranque» no es ejecutar una app, sino clonar el curso y poder correr sus cuadernos. Prerrequisitos documentados en la lección 00: Python 3.12+ (crear el entorno virtual con python3.12), .NET 10+ solo para las muestras C#, Azure CLI y una suscripción de Azure con un proyecto de Microsoft Foundry (un hub + project con un modelo desplegado, p. ej. gpt-5-mini).

# Clonado completo (o usa clonado --depth 1 / --sparse para ahorrar los ~3 GB)
git clone https://github.com/microsoft/ai-agents-for-beginners.git
cd ai-agents-for-beginners

python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate

pip install -r requirements.txt

Luego se autentica con el CLI de Azure y se crea el .env:

az login                         # o: az login --use-device-code (sin navegador)
az account show                  # verificar
cp .env.example .env             # Windows: Copy-Item .env.example .env

En .env se rellenan (como mínimo) AZURE_AI_PROJECT_ENDPOINT y AZURE_AI_MODEL_DEPLOYMENT_NAME. En el primer arranque los cuadernos se autentican a través de az login, de modo que no hacen falta claves API para la mayoría de las lecciones.

Flujos de trabajo habituales

Seguir el curso en orden (o por tema). Abrir 00-course-setup/README.md; después, cada lección NN-.../README.md contiene texto + vídeo + cuaderno. El resultado es un agente ejecutado localmente contra tu proyecto de Foundry.
Construir y verificar un agente desplegable. Para la lección 16, desplegar el agente como hosted agent en Foundry; luego ejecutar el workflow Smoke-test hosted agents eligiendo tests_file, agent_name y el project_endpoint.
Correr un agente local sin nube (lección 17). Instalar Foundry Local (winget install Microsoft.FoundryLocal o brew install foundrylocal), ejecutar foundry model run phi-4-mini y pip install foundry-local-sdk.
Migrar a un proveedor alternativo (MiniMax). Definiendo MINIMAX_API_KEY, MINIMAX_BASE_URL y MINIMAX_MODEL_ID en .env, las muestras que usan OpenAIChatClient detectan esa configuración y la usan como reemplazo.

Configuración esencial

Los archivos y ajustes que un usuario nuevo va a tocar primero: .env (variables de conexión; mínimo AZURE_AI_PROJECT_ENDPOINT y AZURE_AI_MODEL_DEPLOYMENT_NAME), requirements.txt (fijado a agent-framework-core==1.10.0 deliberadamente), la configuración del proyecto en Foundry (ai.azure.com), el intérprete de Python en VSCode (debe ser el del venv 3.12+) y las carpetas de lecciones (NN-.../code_samples/).

Trampas frecuentes y soluciones

agent-framework 1.11 rompe los cuadernos. El comentario de requirements.txt lo declara: la 1.11.0 eliminó ChatMessage y HostedWebSearchTool, cambió el constructor de Message y descartó el argumento model= de Agent.run(). Solución: quedarse en agent-framework-core==1.10.0 fijado.
Clonado de ~3 GB. Solución: clonado shallow (git clone --depth 1 ...) o sparse, o usar GitHub Codespaces.
Error SSL en macOS. Soluciones documentadas, en orden: ejecutar Install Certificates.command; instalar e importar truststore; o, solo temporalmente en desarrollo, desactivar la verificación (reduce la seguridad, no usar en producción).
Lección 16 usa autenticación por clave para Azure AI Search. A diferencia del resto del curso (que va por az login), el cuaderno solo cambia a Azure AI Search si se definen ambas AZURE_SEARCH_SERVICE_ENDPOINT y AZURE_SEARCH_API_KEY.
Lecciones 6 y 8 llaman a Azure OpenAI directamente (por el Responses API) y necesitan AZURE_OPENAI_ENDPOINT/AZURE_OPENAI_DEPLOYMENT (la API de GitHub Models está deprecada y no soporta el Responses API).
No todo se puede probar con pruebas de humo. La lección 17 (local) y las lecciones teóricas (2, 3, 6, 7, 9, 12) quedan excluidas a propósito; se validan ejecutando el cuaderno localmente.

Integraciones y migración

Con Microsoft Foundry / Azure: el curso entero se ejecuta contra un proyecto de Foundry; el despliegue de agentes hosted (lección 16) es el puente hacia producción.
Con CI (GitHub Actions): el workflow .github/workflows/smoke-test.yml consume la GitHub Action AI Smoke Test sobre los catálogos tests/*.json; requiere los secretos AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_SUBSCRIPTION_ID con el rol Azure AI User.
Con estándares abiertos: MAF se integra con MCP (mcp[cli]) y A2A (a2a-sdk), y con conectores a Microsoft Fabric, SharePoint, Pinecone y Qdrant.
Con proveedores alternativos: el OpenAIChatClient de MAF funciona con cualquier endpoint compatible con OpenAI, lo que permite MiniMax y Foundry Local como sustitutos drop-in.
Migración dentro del stack de Microsoft: la documentación oficial de MAF incluye guías de migración desde Semantic Kernel y desde AutoGen.

Cómo contribuir

No existe un CONTRIBUTING.md; el proceso se documenta en el README: abrir una incidencia para sugerencias o errores; crear una solicitud de cambios; aceptar el CLA de Microsoft (cla.opensource.microsoft.com, un bot comprueba si hace falta); y adoptar el Microsoft Open Source Code of Conduct. Cada lección vive en su carpeta con su README, images/ y code_samples/; las pruebas de humo están en tests/; las traducciones están coordinadas por Azure/co-op-translator.

Cómo lo recibió la comunidad

La evidencia recuperada muestra algo claro: al ser un curso corporativo de adopción de Microsoft, no genera la discusión viral que sí producen otras herramientas. Los hilos de Hacker News son pocos, de baja puntuación y sin comentarios, y en Reddit predominan las menciones de agregadores de cursos.

En Hacker News, el envío de mayor tracción encontrado es «Lessons to Get Started Building AI Agents», de thunderbong (4 de julio de 2025, 10 puntos, 0 comentarios). Le siguen «AI Agents for Beginners» de aymenfurter (14 de abril de 2025, 2 puntos, 0 comentarios) y «AI Agents for Beginners – A 10 Lesson Course» de koreyspace (uno de los principales contribuidores del repo, 14 de febrero de 2025, 2 puntos, 0 comentarios) — este último es también la prueba datada del paso de 10 a 18 lecciones. No se encontró un hilo de Hacker News con discusión amplia verificable; los tres envíos son en realidad presentaciones sin debate.

En Reddit, r/learnmachinelearning y r/AgentsOfAI tienen publicaciones de una cifra de puntos cada una (1 punto, 0 comentarios), y r/Udemy lista el curso entre agregados de cursos gratuitos sin valoraciones de alumnos. En conjunto: el repositorio es muy usado como material curricular y de adopción (73.007 estrellas, 24.133 bifurcaciones, 563 suscriptores), pero su huella en foros es de mención de referencia más que de debate técnico.

AI Agents for Beginners frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable
`microsoft/generative-ai-for-beginners` (118.336 ⭐)	Mismo formato «for Beginners» de Microsoft: lecciones + vídeo + cuadernos.	Se centra en IA generativa en general (21 lecciones), no específicamente en agentes; el README lo recomienda como paso previo.
`microsoft/mcp-for-beginners` (17.043 ⭐)	Mismo formato y organización; multi-lenguaje (.NET, Java, TS, JS, Rust, Python).	Cubre solo el Model Context Protocol; este curso cubre el ciclo completo de agentes (MCP aparece como una lección, la 11).
`DTiapan/ai-agents-handbook` (87 ⭐)	Manual de agentes de IA, de básico a avanzado, con código y tutoriales.	Proyecto comunitario independiente, no oficial de Microsoft ni atado a Foundry/MAF.
`UnfoldDataScience/Agentic_Ai_For_Beginner` (33 ⭐)	Curso de IA agéntica para principiantes con código.	Acompaña un curso de Udemy, no es material de Microsoft.

La comparación más útil no es por popularidad: este repositorio destaca cuando se quiere aprender el stack específico de Microsoft (MAF + Foundry) de principio a producción, con material oficial, gratuito y multiidioma. Para un recorrido agnóstico de proveedor, un curso como el de LangChain puede ser más adecuado; para solo protocolos MCP, mcp-for-beginners es el punto de entrada.

Casos de uso y a quién puede ayudar este repositorio

Desarrolladores y equipos que adoptan la pila de agentes de Microsoft pueden usar las 18 lecciones como ruta completa: entender qué es un agente, elegir patrones (tool use, planning, multiagente), implementar con MAF y desplegar con Foundry.
Ingenieros de datos / IA que necesitan RAG agéntico pueden partir de la lección 5 y su muestra (TravelRAGAgent), con la opción documentada de pasar de una base de conocimiento en memoria a un índice real de Azure AI Search.
Equipos que despliegan agentes a producción pueden reutilizar los catálogos de pruebas de humo (tests/*.json) con la GitHub Action AI Smoke Test para verificar, en CI, que un agente hosted en Foundry responde antes de cada despliegue.
Quienes no quieren depender de la nube pueden seguir la lección 17 y usar Foundry Local (o el OpenAIChatClient apuntado a un proveedor compatible como MiniMax).
Profesores, formadores y comunidades de aprendizaje pueden aprovechar las 50+ traducciones oficiales para impartir el curso en su idioma.

Recursos

Repositorio: https://github.com/microsoft/ai-agents-for-beginners
Página oficial: https://aka.ms/ai-agents-beginners
Instalación / lección 00: https://github.com/microsoft/ai-agents-for-beginners/blob/main/00-course-setup/README.md
Framework del curso (MAF): https://github.com/microsoft/agent-framework
Cursos hermanos: https://github.com/microsoft/generative-ai-for-beginners · https://github.com/microsoft/mcp-for-beginners
Comunidad / Discord: https://aka.ms/ai-agents/discord

Nota: este artículo combina el README, la lección 00 de instalación, requirements.txt, la carpeta tests/, la API de GitHub y la documentación oficial de Microsoft Agent Framework, junto con los resultados de Hacker News y Reddit consultados el 22 de agosto de 2026. Las cifras de estrellas, bifurcaciones, contribuciones y commits cambian con el tiempo.