Personaliza Microsoft Copilot con un agente

Microsoft Copilot en Power Apps permite a los usuarios interactuar con agentes personalizados que amplían lo que Copilot puede hacer. Al personalizar un agente, puede crear experiencias adaptadas que se ajusten a los datos y los procesos empresariales de su organización. Para obtener más información, consulte Uso de agentes en Microsoft Copilot.

Este artículo describe los tipos de agentes que puede crear para Microsoft Copilot en Power Apps y le ayuda a elegir el enfoque adecuado para su escenario.

Elección de un tipo de agente

La siguiente tabla compara los tipos de agentes que puedes crear.

Para encontrar la mejor opción para su organización, use estos recursos:

• Obtenga información general e instrucciones sobre cómo elegir qué tipo de agente crear en Introducción a los agentes de Microsoft Copilot.
• Cree un agente declarativo para Microsoft Copilot o un agente de motor personalizado para Microsoft 365.
• Use Microsoft Copilot Studio para conectarse y configurar un agente para Teams y Microsoft 365 para que esté disponible en Microsoft Copilot.
• Revise las instrucciones sobre cómo elegir entre Microsoft Copilot y Copilot Studio para crear el agente.

Una manera de crear un agente declarativo para una aplicación controlada por modelos es activar Microsoft Copilot directamente en la aplicación. Para obtener más información, consulta Habilitar la aplicación para Microsoft Copilot.

Puede crear su propio modo de agente específico de la aplicación en Power Apps combinando un agente predeterminado con las Xrm.Copilot.* API. El agente predeterminado define la experiencia de Microsoft Copilot adaptada que se abre para los usuarios y las API crean la conexión bidireccional entre la aplicación y Microsoft Copilot.

Establecimiento de un agente predeterminado

Si crea un agente personalizado como complemento de su aplicación basada en modelos, puede establecerlo como el agente predeterminado para que se cargue automáticamente cuando se abra la aplicación y el panel lateral de Microsoft Copilot. Esto convierte a tu agente en el punto de partida de la experiencia y es el primer paso para crear tu propio modo de agente.

Al establecer un agente predeterminado:

• El agente se selecciona sin ninguna acción del usuario.
• Los usuarios van directamente a la experiencia personalizada que ha diseñado para la aplicación.
• Los flujos de trabajo y las instrucciones específicos de la aplicación están listos en cuanto se abra Microsoft Copilot.

Un agente predeterminado es especialmente útil para los agentes centrados en escenarios que amplían la experiencia básica de la aplicación y actúan como puerta de entrada a la experiencia de Microsoft Copilot específica de la aplicación que desea que tengan los usuarios.

API de Xrm.Copilot

Las API de cliente de Xrm.Copilot.* permiten a los desarrolladores integrar Microsoft Copilot directamente en experiencias de aplicaciones basadas en modelos. Con estas API, la aplicación puede interactuar directamente con el panel lateral de Microsoft Copilot y responder a acciones controladas por Microsoft Copilot, por lo que puede crear escenarios agénticos de un extremo a otro más enriquecidos.

Al usar estas API con un agente predeterminado, completan el patrón de modo de agente: el agente es el punto de partida, la aplicación puede enviar mensajes y contexto a Microsoft Copilot y Microsoft Copilot puede invocar acciones dentro de la aplicación.

Para obtener la superficie de API completa, consulte Xrm.Copilot (referencia de API de cliente) en aplicaciones controladas por modelos.

Estas API le permiten:

• Envíe mensajes a Microsoft Copilot. Usa sendPromptToM365Copilot para iniciar una interacción de Microsoft Copilot desde la aplicación.
• Abra y controle el panel lateral de Microsoft Copilot. Utilice openM365CopilotPanel para asegurarse de que el panel Microsoft Copilot esté visible cuando sea necesario.
• Pase el contexto de la aplicación a Microsoft Copilot. Usa updateContext (versión preliminar) para enviar señales adicionales de conexión a tierra desde tu aplicación.
• Trabajar con agentes. Use getCurrentAgent para comprobar qué agente está activo.
• Controle las acciones de Microsoft Copilot en la aplicación. Use addActionHandler para registrar controladores personalizados que procesan las acciones enviadas desde las respuestas de Microsoft Copilot.

Juntas, estas API crean una verdadera experiencia bidireccional entre la interfaz de usuario de la aplicación y el agente, por lo que los agentes pueden impulsar las actualizaciones de la interfaz de usuario, desencadenar flujos de trabajo o ejecutar lógica de negocios personalizada.

Controla las acciones de Microsoft Copilot con addActionHandler

Use la addActionHandler API cuando la aplicación necesite controlar las acciones estructuradas que Microsoft Copilot emite.

Cuando cree la carga útil de la acción:

• Establezca type en PowerApps para tener como destino el host de Power Apps.
• Establezca action (por ejemplo, MyNamespace.MyMessage) en el actionId que registra en addActionHandler.
• Use actionData para la carga útil que su código procesa y pasa al host de Power Apps.

En las secciones siguientes se muestran dos escenarios admitidos.

Tarjetas adaptables

Las respuestas de Microsoft Copilot pueden incluir Tarjetas adaptables con botones Action.Submit que envían mensajes de acción al host de Power Apps.

Ejemplo:

{
  "type": "AdaptiveCard",
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Click Go and I will send data to the host to process.",
      "wrap": true,
      "id": "txtSendMessage"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Submit",
          "title": "Go",
          "id": "btnGo",
          "data": {
            "type": "PowerApps",
            "action": "MyNamespace.MyMessage",
            "actionData": {
              "foo": "bar"
            }
          }
        }
      ]
    }
  ]
}

Aplicaciones MCP

Las respuestas de Microsoft Copilot pueden incluir HTML que envía mensajes de acción al host de Power Apps.

Ejemplo:

<Button
  appearance="outline"
  icon={<ArrowLeft24Regular />}
  onClick={() => {
    try {
      const message = {
        eventName: 'powerapps.copilot.chat.action',
        action: 'MyNamespace.MyMessage',
        actionData: {
          foo: 'bar'
        },
      };
      window.parent.parent.postMessage(message, '*');
    } catch (error) {
      // eslint-disable-next-line no-console
      console.error('Error posting HOST_ACTION message to parent window:', error);
    }
  }}
>
  Test
</Button>

Limitations

• Los agentes que haya creado aún no pueden usar el contexto del usuario dentro de la aplicación para adaptar sus respuestas.
• Al establecer un agente predeterminado, los mensajes de inicio del agente no se representan.

Información relacionada

• Agregar Microsoft Copilot para los usuarios de aplicaciones en aplicaciones basadas en modelos
• Uso de Microsoft Copilot en aplicaciones controladas por modelos
• Agregar Microsoft Copilot para los usuarios de aplicaciones en aplicaciones de lienzo (versión preliminar)
• Usar Microsoft Copilot en aplicaciones de lienzo (versión preliminar)
• Personalice Microsoft Copilot con un agente en aplicaciones de Power Apps