# Equipo de Agentes

La funcionalidad **Equipo de Agentes** le permite construir una estructura **Multiagente** en Power Omni utilizando el protocolo **A2A (Agent-to-Agent)**. Un **Agente Orquestador** coordina la conversación con el usuario y llama a **Agentes Especialistas** siempre que necesita un conocimiento específico o una integración específica, combinando sus respuestas en una sola respuesta.

En la práctica, el usuario conversa con un único agente, y ese agente decide por sí mismo cuándo consultar al agente de Fabric, al agente de Azure DevOps, al agente de Finanzas o a cualquier otro especialista del equipo.

### Conceptos

<table><thead><tr><th width="233">Término</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>Agente Orquestador</strong></td><td>El agente con el que conversa el usuario. Interpreta la solicitud, decide qué especialistas consultar y consolida sus respuestas.</td></tr><tr><td><strong>Agentes Especialistas</strong></td><td>Agentes que el orquestador puede consultar. Cada uno mantiene sus propias instrucciones, modelo, conectores y permisos.</td></tr><tr><td><strong>A2A (Agent-to-Agent)</strong></td><td>Protocolo de comunicación entre agentes. Un agente solo puede ser consultado por otro agente cuando está habilitado para A2A.</td></tr><tr><td><strong>Equipo de agentes</strong></td><td>Un grupo formado por un orquestador y hasta <strong>10 especialistas</strong>.</td></tr></tbody></table>

### Principales Beneficios

* **Un único punto de conversación:** los usuarios no necesitan saber qué agente atiende cada tema. Simplemente conversan con el orquestador.
* **Especialización:** cada agente se mantiene enfocado en su propio dominio, con sus propias instrucciones y conectores, lo que genera respuestas más precisas.
* **Reutilización:** los agentes existentes pueden combinarse en nuevos equipos sin necesidad de volver a crearlos.
* **Gobernanza preservada:** los permisos de acceso y el seguimiento de uso de cada agente continúan vigentes dentro del equipo.

### Configuración de un Equipo de Agentes

{% stepper %}
{% step %}
#### Acceda al Portal de Administración

Navegue a **Artefactos > Agentes**.
{% endstep %}

{% step %}
#### Seleccione el orquestador

En la fila del agente que será el orquestador, haga clic en el botón **Equipo de agentes** en la columna **Acciones**.
{% endstep %}

{% step %}
#### Confirme el Agente Orquestador

En el panel **Equipo de agentes**, confirme o seleccione el **Agente Orquestador**. Este es el agente con el que conversarán los usuarios.
{% endstep %}

{% step %}
#### Seleccione los agentes especialistas

En **¿Qué agentes puede consultar?**, marque los especialistas que desee. Utilice el campo **Buscar agente por nombre** para encontrar agentes rápidamente.
{% endstep %}

{% step %}
#### Guarde el equipo

Haga clic en **Guardar equipo**. Se mostrará el mensaje **Equipo guardado. Converse con el orquestador para comenzar.**
{% endstep %}
{% endstepper %}

### Reglas del Equipo

* Usted puede seleccionar **hasta 10 especialistas** por orquestador.
* Al guardar, los especialistas seleccionados se **habilitan automáticamente para A2A**.
* A través del orquestador, cada usuario solo puede consultar **agentes a los que ya tiene acceso**. El equipo no otorga acceso a agentes restringidos.
* El uso de tokens se **registra por agente**, es decir, cada especialista que es llamado registra su propio uso.

### Permitir que Otros Agentes Consulten a este Agente (A2A)

En la parte inferior del panel, la opción **Permitir que otros agentes consulten a este agente (A2A)** controla si este agente puede ser llamado como especialista por otros orquestadores.

* **Habilitada:** el agente está disponible para ser consultado vía A2A.
* **Deshabilitada:** el agente no puede ser consultado por otros agentes, a menos que sea seleccionado como especialista en un equipo (lo que lo habilita automáticamente al guardar).

{% hint style="warning" %}
## <mark style="color:$warning;">La descripción del agente es esencial</mark>

<mark style="color:$warning;">El orquestador utiliza la</mark> <mark style="color:$warning;"></mark><mark style="color:$warning;">**descripción**</mark> <mark style="color:$warning;"></mark><mark style="color:$warning;">de cada especialista para decidir a cuál llamar. Los agentes sin descripción se identifican solo por su nombre (muestran "Sin descripción. El agente será identificado por su nombre."), lo que reduce considerablemente la precisión del enrutamiento. Antes de construir un equipo, asegúrese de que cada especialista tenga una descripción clara y objetiva.</mark>
{% endhint %}

### Cómo Escribir una Buena Descripción

Una buena descripción indica **qué puede hacer el agente**, **a qué datos o sistemas accede** y **cuándo debe ser llamado**.

<table><thead><tr><th width="179">Agente</th><th width="183">Descripción débil</th><th>Descripción recomendada</th></tr></thead><tbody><tr><td><strong>Fabric</strong></td><td>Informes en Fabric</td><td>Consulta informes y modelos semánticos de Power Tuning en Microsoft Fabric. Llámelo para preguntas sobre KPIs, crecimiento de clientes, ingresos y métricas de ventas.</td></tr><tr><td><strong>Demand Manager</strong></td><td>Sin descripción</td><td>Consulta y gestiona work items de Azure DevOps. Llámelo para listar tickets abiertos y verificar el estado, los responsables y los plazos de las solicitudes.</td></tr><tr><td><strong>Finanzas</strong></td><td>Agente de finanzas</td><td>Responde preguntas sobre cuentas por pagar y por cobrar, reembolsos y políticas financieras internas. Llámelo para pagos, facturas y plazos financieros.</td></tr></tbody></table>

{% hint style="info" %}
## <mark style="color:blue;">Consejo</mark>

<mark style="color:blue;">**Evite tener especialistas con descripciones similares en el mismo equipo. Cuanto más distinto sea el alcance de cada uno, más fácil será para el orquestador elegir al agente correcto.**</mark>
{% endhint %}

### Identificación de un Agente Orquestador

Los agentes configurados como orquestadores muestran el ícono **Multiagente** (👥) junto a su nombre.

* **En el Portal de Administración:** en la lista de Agentes, al pasar el cursor sobre el ícono se muestra **Agente Orquestador - Multiagente**.
* **En el Portal del Usuario:** el ícono aparece en el menú lateral de Agentes y en la tarjeta del agente en el Hub de Agentes.

### Uso del Equipo en el Chat

Para el usuario, la experiencia es transparente: basta con abrir una conversación con el **Agente Orquestador** y hacer la pregunta como de costumbre.

Cuando el orquestador decide que necesita a un especialista, el chat muestra **Llamando al agente:** seguido del nombre del especialista que está siendo llamado. Al final, el orquestador combina la información y presenta la respuesta.

### Ejemplos

* "Verifique en Fabric cómo ha crecido la base de clientes de Power Tuning" → el orquestador llama al agente **Fabric**.
* "Verifique los tickets abiertos en Azure DevOps" → el orquestador llama al agente **Demand Manager - Azure DevOps**.

### Permisos y Uso

* **Permisos:** el orquestador respeta los permisos de cada usuario. Si el usuario no tiene acceso a un especialista (directamente, a través de un grupo o de un espacio de trabajo), ese especialista no será consultado en su nombre.
* **Uso:** cada agente que es llamado tiene su uso de tokens registrado individualmente, lo cual puede seguirse en Monitoreo y en Auditorías > Uso de Tokens.
* **Presupuesto:** dado que el uso se registra por agente, los límites definidos en Presupuesto también se aplican a los especialistas.

{% hint style="danger" %}
## <mark style="color:$danger;">Cuide el costo</mark>

<mark style="color:$danger;">Una sola pregunta al orquestador puede llamar a varios especialistas, y cada uno consume tokens con su propio modelo. Monitoree el uso del equipo y prefiera especialistas con modelos adecuados al tipo de tarea.</mark>
{% endhint %}