Importar un agente a un entorno de destino

Implemente agentes en entornos de espacio aislado o de prueba antes de implementarlos en producción. Este enfoque garantiza que funcionan correctamente y le ayuda a evitar posibles interrupciones en las operaciones empresariales.
En Dynamics 365 Sales, use las funcionalidades de Administración del ciclo de vida de las aplicaciones (ALM) de Power Platform para exportar e importar soluciones de agente entre entornos. Exporte la solución del agente desde un entorno de origen, como un entorno sandbox o de prueba, y después impórtela en el entorno de destino, normalmente en el entorno de producción.

Use este procedimiento para importar una solución de agente de ventas, como Agente de calificación de ventas, Agente de oportunidad de ventas, Agente de cierre de ventas, Agente de acciones recomendadas o Agente de enriquecimiento de datos en un entorno de destino.

procedimientos recomendados

• Cree una solución por perfil de agente para asegurarse de que cada perfil se puede empaquetar e implementar de forma independiente. Incluir varios perfiles en una única solución podría dar lugar a la exportación de cambios no deseados o no probados.

• Use filtros independientes de la organización en criterios de selección para que los perfiles sigan funcionando después de la migración a otro entorno. De lo contrario, es posible que tenga que actualizar manualmente los filtros después de la importación.

Exportar el agente como una solución

Exporte el agente desde el entorno de origen como solución. Durante el proceso de exportación, puede elegir incluir todos los componentes del agente o seleccionar componentes específicos que se van a incluir en la solución. Una vez completada la exportación, tiene un archivo de solución para importarlo en el entorno de destino.

1. En el entorno de origen, vaya al portal Power Apps maker.

2. Seleccione el entorno que contiene el agente que desea exportar.

3. En el panel de navegación izquierdo, seleccione Soluciones.

4. Seleccione Nueva solución para crear una solución y escriba los detalles necesarios, como el nombre, el publicador y la versión.

5. Agregue componentes necesarios.
   Seleccione Agregar existente>Más>Otros y luego agregue los siguientes componentes:

   • SalesAgentProfile. Al crear el agente, se crea automáticamente un perfil de agente correspondiente. En el panel Agregar PerfilDeAgenteDeVentas existente, seleccione un perfil del agente de la lista de perfiles de agente existentes.
   • SalesAgentConfigurationV2. Al crear el agente, las configuraciones de agente correspondientes se crean automáticamente con el mismo nombre que el perfil del agente. En el panel Añadir SalesAgentConfigurationV2 existente, seleccione la configuración del agente que tiene el mismo nombre que el perfil del agente seleccionado.
   • Secuencia (solo para el Agente de Calificación de Ventas). Al crear el Agente de calificación de ventas, se crea automáticamente un registro de secuencia correspondiente en el componente de secuencia. En el panel Agregar secuencia existente , seleccione el registro de secuencia con el nombre AgenticSequence.
   • msdyn_recommendedactionsourceagentconfig (solo para el Agente de acciones recomendadas). Este componente contiene las configuraciones de las acciones recomendadas.

6. Agregue orígenes de conocimiento.

   Nota

   Este paso no es aplicable al Agente de enriquecimiento de datos.

   Seleccione Agregaragente>existente> y, a continuación, agregue agentes que contengan orígenes de conocimiento relevantes para el agente que desea exportar. Por ejemplo, si exporta el Agente de oportunidades de ventas: investigación de cuentas, los orígenes de conocimiento relacionados con la investigación de cuentas se agregan automáticamente como parte del componente del agente. Cada tipo de agente requiere un conjunto específico de agentes en la solución. Para una lista de agentes para añadir para cada tipo de agente, consulta los registros de agentes de Copilot Studio y los registros de la app Entra para agentes de ventas.

   En la imagen siguiente se muestra un ejemplo de los componentes agregados para el Agente de calificación de ventas.
   

7. Guarde y publique las personalizaciones.

8. Seleccione Exportar para exportar la solución y guardarla en una ubicación del equipo.
   Durante el proceso de exportación, elija la solución como solución administrada. Normalmente, se usa una solución administrada para entornos de producción. Para obtener más información sobre cómo exportar soluciones, consulte Exportación de soluciones.

Importe la solución del agente en el entorno de destino

Importe el archivo de solución exportado en el entorno de destino. Durante el proceso de importación, puede optar por sobrescribir los componentes existentes en el entorno de destino que tengan el mismo nombre que los de la solución. Una vez completada la importación, el agente está disponible en el entorno de destino.

Importar la solución

1. Vaya al portal de Power Apps maker en el entorno de destino.
2. Seleccione el entorno de destino en el que desea importar la solución del agente.
3. En el panel de navegación izquierdo, seleccione Soluciones. Para obtener más información, consulte Importar soluciones.
4. Siga las indicaciones para completar el proceso de importación. Durante la importación, elija sobrescribir los componentes existentes en el entorno de destino que tengan el mismo nombre que los de la solución. Esta opción garantiza que los componentes del agente se actualicen con los del entorno de origen. La solución se importa al entorno de destino y se muestra en la página agentes de IA del entorno.

Configuración e inicio del agente

Después de importar la solución, el agente se importa en estado de borrador. Abra el agente y configure las opciones específicas del entorno antes de iniciar el agente. La configuración e inicio del agente es diferente para el agente de calificación de ventas, el agente de oportunidades de ventas, el agente de cierre de ventas, el agente de enriquecimiento de datos y el agente de acciones recomendadas. Siga los pasos correspondientes en función del tipo de agente que importó.

Para el agente de calificación de ventas, el agente de oportunidades de ventas y el agente de cierre de ventas

1. Cree los siguientes componentes manualmente en el entorno de destino, ya que son específicos del entorno y no se incluyen en la solución exportada:

   • Usuario de aplicación de Dataverse
   • Registros de aplicaciones necesarios

2. Configure los requisitos previos. La solución exportada no incluye requisitos previos porque a menudo contienen valores específicos del entorno que pueden diferir entre los entornos de origen y de destino.

   • Para el Agente de calificación de ventas, consulte Configuración de los requisitos del Agente de calificación de ventas.
   • Para el Agente de oportunidades de ventas, consulte Configuración de los requisitos del Agente de oportunidades de ventas.
   • Para Sales Close Agent, consulte Configure requirements for Sales Close Agent(Configurar requisitos para Sales Close Agent).

3. Seleccione el usuario de la aplicación. Los usuarios de la aplicación difieren entre los entornos de origen y de destino.

   1. Vaya a la página de configuración del agente importado.
   2. En la página de configuración del perfil del agente, seleccione el usuario de aplicación de Dataverse creado para este agente.

4. Revise las reglas de asignación o los criterios de selección. Es posible que algunos valores relacionados con la asignación configurados en el entorno de origen no se resuelvan correctamente en el entorno de destino. Por ejemplo, si la regla de asignación se basa en un equipo o usuario que no existe en el entorno de destino, actualice la regla para asegurarse de que funciona correctamente.

   1. Abra la página Configuración de reglas de asignación .
   2. Actualice los valores y texto no resueltos o incorrectos para asegurarse de que las reglas de asignación funcionan según lo previsto en el entorno de destino.

5. Compruebe los orígenes de conocimiento. Las fuentes de conocimiento aparecen automáticamente tras la importación de la solución si fueron añadidas a los bots correspondientes en el entorno de origen. Sin embargo, el contenido de esos orígenes de conocimiento puede diferir entre entornos. Por ejemplo, si se usó una biblioteca de documentos SharePoint como origen de conocimiento en el entorno de origen, es posible que la misma biblioteca de documentos no esté disponible en el entorno de destino. Actualice los orígenes de conocimiento para que apunten al contenido correcto en el entorno de destino.

   1. Abra la página Configuración de orígenes de conocimiento .
   2. Compruebe que todos los orígenes de conocimiento configurados están disponibles. Si falta algún origen de conocimiento o no está configurado correctamente, actualícelo para asegurarse de que el agente tiene acceso a la información necesaria.

6. Guarda y activa el agente. Después de actualizar la configuración específica del entorno, guarde e inicie el agente.

Para el agente de enriquecimiento de datos

1. Configure los requisitos previos. La solución exportada no incluye requisitos previos porque a menudo contienen valores específicos del entorno que pueden diferir entre los entornos de origen y de destino. Consulte Configuración de requisitos previos para obtener más información.

2. Revise las reglas de selección de registros. Es posible que algunos valores de las reglas de selección de registros no se resuelvan correctamente en el entorno de destino. Por ejemplo, si la regla se basa en un equipo o usuario que no existe en el entorno de destino, actualice la regla para asegurarse de que funciona correctamente.

   1. En la página de configuración, vaya a la página Configuración de selección de registros .
   2. Actualice los valores no resueltos o incorrectos para asegurarse de que las reglas de selección de registros funcionan según lo previsto en el entorno de destino.
      Para más información sobre la selección de registros, consulte Seleccionar registros para el enriquecimiento.

3. Compruebe el acceso del usuario. El acceso de usuario al agente puede diferir entre los entornos de origen y de destino. Asegúrese de que los usuarios del entorno de destino tengan los permisos necesarios para acceder y usar el agente.

   1. En la página de configuración, vaya a la página Configuración de acceso de usuario.
   2. Compruebe que todos los usuarios que necesitan acceso al agente tengan los permisos adecuados.
      Para obtener más información sobre el acceso de usuario, consulte Configuración del acceso de usuario.

4. Compruebe el ámbito del campo. Es posible que los campos seleccionados para el enriquecimiento en el entorno de origen no sean los mismos que los del entorno de destino. Revise los campos seleccionados para asegurarse de que se alinean con los requisitos del entorno de destino.

   1. En la página de configuración, vaya a la página Configuración del comportamiento del agente .
   2. En la sección Ámbito de campo, revise los campos seleccionados y actualícelos si es necesario para asegurarse de que el agente enriquece los datos correctos en el entorno de destino.
      Para más información sobre el ámbito de campo, consulte Configuración del comportamiento del agente.

5. Guarda y activa el agente. Después de actualizar la configuración específica del entorno, guarde e inicie el agente.

Para el agente de acciones recomendadas

1. Seleccione el usuario de la aplicación. Los usuarios de la aplicación difieren entre los entornos de origen y de destino.

   1. Vaya a la página de configuración del agente importado.
   2. En la página de configuración del perfil del agente, seleccione el usuario de aplicación de Dataverse creado para este agente.

2. En función de los orígenes que haya configurado para el Agente de acciones recomendadas en el entorno de origen, es posible que tenga que realizar pasos adicionales para asegurarse de que esos orígenes están configurados correctamente en el entorno de destino. Configure los orígenes en función del tipo de agentes que haya configurado como orígenes en el entorno de origen.

   • Si ha configurado el Agente de oportunidades de ventas o el Agente de enriquecimiento de datos, no es necesario realizar ninguna acción. Estos agentes forman parte de la solución y se importan junto con el Agente de acciones recomendadas y se configuran automáticamente como orígenes.
   • Si usas agentes personalizados como fuentes para el Agente de Acciones Recomendadas, asegúrate de importar y configurar también esos agentes personalizados en el entorno objetivo. La API msdyn_PushActionDataToRecommendedActionAgent envía información accionable de agentes personalizados al Agente de Acciones Recomendadas. Debes configurar correctamente a los agentes personalizados para que sus ideas aparezcan en la experiencia de acciones recomendadas.

3. Guarda y activa el agente. Después de actualizar la configuración específica del entorno, guarde e inicie el agente.

Información relacionada

agentes de IA en Dynamics 365 Sales