Personalización de Microsoft 365 Copilot con un agente

Microsoft 365 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 365 Copilot.

En este artículo se describen los tipos de agentes que puede compilar para Microsoft 365 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.

Tipo de agente Description Casos de uso comunes
Agente declarativo Creado con plantillas y herramientas de poco código para una configuración rápida de escenarios comunes en Microsoft 365 Copilot. Automatice las tareas rutinarias, responda a las preguntas más frecuentes y proporcione flujos de trabajo guiados.
Agente de motor personalizado Creado con lógica personalizada e integraciones para funcionalidades avanzadas adaptadas a su negocio. Procesos empresariales complejos, integraciones de datos personalizadas y automatización especializada.
agente de Copilot Studio Integrado y administrado en Microsoft Copilot Studio, con integración con Teams y Microsoft 365 para experiencias conversacionales. Bots de chat interactivos, colaboración en equipo y soporte técnico personalizado en aplicaciones de Microsoft 365.

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

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

API de Xrm.Copilot

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

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 Copilot. Usa sendPromptToM365Copilot para iniciar una interacción de Copilot desde la aplicación.
  • Abra y controle el panel lateral de Copilot. Use openM365CopilotPanel para asegurarse de que el panel Copilot esté visible cuando sea necesario.
  • Pase el contexto de la aplicación a 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 Copilot en la aplicación. Utiliza addActionHandler para registrar controladores personalizados que procesen las acciones enviadas en las respuestas de Copilot.

En conjunto, estas API conectan las respuestas de Copilot con la lógica de su aplicación, de modo que los agentes puedan actualizar la interfaz de usuario, activar flujos de trabajo o ejecutar lógica empresarial personalizada.

Control de acciones de Copilot con addActionHandler

Use la addActionHandler API cuando la aplicación necesite controlar las acciones estructuradas que 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 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 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>

Establecimiento de un agente predeterminado

Si compila un agente personalizado como complemento para la aplicación controlada por modelos, puede establecerlo como agente predeterminado para que se cargue automáticamente cuando se abra la aplicación y el panel lateral del Copilot.

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 Copilot.

Un agente predeterminado es especialmente útil para los agentes centrados en escenarios que amplían la experiencia principal de la aplicación.

Captura de pantalla que muestra cómo establecer un agente predeterminado para Microsoft 365 Copilot en la aplicación controlada por modelos.

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.
  • Last updated on