En Microsoft Agent Framework, Harness permite envolver un cliente de chat con capacidades para ejecutar tareas de varios pasos, como invocar herramientas, conservar el contexto y gestionar aprobaciones. En C#, el punto de entrada documentado es chatClient.AsHarnessAgent(). La muestra oficial de investigación combina planificación, búsqueda web y ejecución de tareas pendientes con un límite de iteraciones; no convierte al agente en una fuente infalible ni en un proceso ilimitado.
Qué es Harness en Microsoft Agent Framework
Microsoft define un agent harness como “the runtime scaffolding that turns a language model into an agent that can perform work”. En la práctica, Harness coordina llamadas al modelo y a herramientas, el estado de la conversación, el contexto y las políticas de aprobación durante tareas de varios pasos. Su arquitectura puede incluir un cliente y un pipeline de chat, agentes, proveedores de contexto y middleware, además de una experiencia de aplicación que presenta el progreso o pide aprobación.
As an Amazon Associate I earn from qualifying purchases.
En .NET, HarnessAgent deriva de AIAgent: el resultado sigue siendo un agente de Agent Framework, no un tipo de aplicación aparte. Consulta la documentación de Agent Harness para conocer las capacidades y su estado.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallCómo crear un Harness Agent en C#
La guía de inicio muestra el paquete Microsoft.Agents.AI.Harness, que expone HarnessAgent en el namespace Microsoft.Agents.AI. Puedes crear el agente a partir de una implementación compatible de IChatClient con AsHarnessAgent() y ejecutarlo así:
#1 Best Overall
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;
AIAgent agent = chatClient.AsHarnessAgent();
AgentResponse response = await agent.RunAsync("Investiga este tema y resume fuentes verificadas.");
Console.WriteLine(response.Text);El ejemplo presupone que chatClient ya está configurado. La guía de inicio no establece una versión actual de NuGet, una matriz de compatibilidad por versión de .NET ni pasos de credenciales que sirvan para cualquier proveedor; comprueba esos requisitos en la documentación del proveedor y del paquete que elijas. El ecosistema admite distintas integraciones de clientes, pero la disponibilidad concreta depende de la integración y las versiones vigentes.
Conservar estado entre turnos
Para una conversación interactiva de varios turnos, conserva una AgentSession y reutilízala en las invocaciones. Así, el estado del Harness —incluidos el plan, las tareas y el historial— puede persistir entre turnos. La guía de inicio de Harness, actualizada el 25 de agosto de 2026, muestra una conversación en streaming dentro de un bucle. La sesión es relevante cuando el usuario y el agente deben continuar una investigación, no solo recibir una respuesta aislada.
Cómo organizar una investigación con Harness
La muestra oficial Harness research assistant ilustra una secuencia de planificación y ejecución. El agente prepara una lista de tareas, puede usar búsqueda web y pasa de planificación interactiva a ejecución autónoma de las tareas abiertas. La muestra permite volver a invocarlo mientras queden tareas pendientes y fija un máximo de iteraciones.
Un diseño responsable para un agente de investigación puede estructurar ese ciclo de este modo:
- Definir el encargo: recibir el tema y precisar qué tipo de respuesta o evidencia se necesita.
- Hacer visible el plan: dividir el encargo en subtareas que puedan revisarse y marcarse como pendientes o completadas.
- Recopilar evidencia: ejecutar las búsquedas y herramientas habilitadas, conservando resultados relevantes en el contexto o la memoria de la sesión.
- Verificar antes de redactar: comprobar que las afirmaciones importantes tengan respaldo y distinguir los hechos confirmados de las incertidumbres.
- Respetar el límite: reintentar tareas pendientes solo dentro del máximo de iteraciones configurado y exponer lo que no se pudo resolver.
La planificación, la búsqueda y el bucle limitado aparecen en la muestra; la verificación editorial es una recomendación de diseño, no una garantía automática del framework. Un resultado generado debe revisarse frente a sus fuentes.
Harness o workflows: cuál encaja mejor
Microsoft distingue Harness de workflows por el nivel de estructura y control que aportan. Harness ofrece una configuración más opinada para tareas largas; los workflows permiten definir rutas de ejecución explícitas para conectar agentes y funciones. La documentación describe orquestaciones secuenciales, concurrentes, handoff, group chat y Magentic, además de mecanismos para aprobación humana o solicitudes de información.
Rank #4
| Necesidad | Opción que conviene evaluar | Motivo |
|---|---|---|
| Tarea larga con pasos variables, planificación y seguimiento | Harness | Integra capacidades del ciclo de trabajo que, de otro modo, habría que ensamblar. |
| Orden fijo, ramas explícitas o coordinación definida entre especialistas | Workflows | Permiten modelar rutas y orquestaciones de forma explícita. |
| Proceso que requiere intervención humana | Workflows o Harness con aprobación, según el diseño | El framework contempla aprobaciones y solicitudes de información; el punto de control concreto depende de la implementación. |
Esta distinción describe el enfoque de cada opción, no una comparación de rendimiento. La decisión también depende de cuánto control de recuperación y observabilidad necesite la aplicación. Consulta el overview de Microsoft Agent Framework y la guía de orquestaciones de workflows.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Límites y estado de las capacidades
La documentación de Harness marca como experimentales los agentes en segundo plano, el acceso a archivos y el looping; el tooling de shell procede de un paquete preliminar. El estado puede variar, por lo que conviene revisar la documentación correspondiente a las versiones concretas que se vayan a desplegar. Harness permite desactivar capacidades integradas: habilita solo las necesarias y evalúa su madurez antes de llevarlas a producción.
“Autónomo” no significa ilimitado ni supervisado automáticamente. La muestra acota las iteraciones y separa la planificación interactiva de la ejecución; además, las herramientas sujetas a aprobación pueden detenerse para revisión humana. El concepto de Harness y la documentación de orquestaciones describen estos aspectos.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
