# Instrucciones para el agente: Microsoft Agent Framework: coordina agentes en Python y .NET

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/microsoft/agent-framework (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/microsoft-agent-framework

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala el paquete Python

Comprueba que el entorno de tu proyecto tiene Python ≥3.10, pip y venv; en macOS/Linux crea y activa un entorno con `python -m venv .venv` y `source .venv/bin/activate` antes de instalar ([metadatos oficiales](https://github.com/microsoft/agent-framework/blob/main/python/packages/core/pyproject.toml)).

```bash
pip install agent-framework
```

### Paso 2: selecciona proveedor y ejemplo

Esta ruta concreta utiliza Microsoft Foundry, como el [ejemplo del README](https://github.com/microsoft/agent-framework#basic-agent---python). Comprueba que Azure CLI está instalado y que tu cuenta puede usar un proyecto Foundry con un modelo desplegado. Autentica:

```bash
az login
```

Carga `FOUNDRY_PROJECT_ENDPOINT` (dirección del proyecto Foundry) y `FOUNDRY_MODEL` (nombre del despliegue) desde el entorno de ese proyecto. Guarda en `prueba.py` esta adaptación del ejemplo:

```python
import asyncio
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential

async def main():
    agent = Agent(
        client=FoundryChatClient(credential=AzureCliCredential()),
        name="HaikuAgent",
        instructions="Escribes poemas breves en español.",
    )
    print(await agent.run("Escribe un haiku sobre Microsoft Agent Framework."))

if __name__ == "__main__":
    asyncio.run(main())
```

Desde el mismo entorno donde instalaste el paquete:

```bash
python prueba.py
```

La salida debe ser el poema generado. La cuenta Azure y el destino Foundry se configuran antes de llamar; la autenticación por sí sola no elige el proyecto ni el despliegue.

## Comprobación

Ejecuta primero el agente simple y después un flujo pequeño. Verifica las trazas, los datos entre pasos y la recuperación desde un punto de control si la habilitas.

## Si algo falla

Distingue módulos experimentales ausentes de fallos del proveedor. Si el ejemplo usa Foundry, comprueba su autenticación y despliegue de modelo antes de cambiar el flujo.