Implementación de su migración

Migrar su agente por etapas

Aborde su migración por etapas de modo que sea más fácil estabilizarla y solucionar problemas más adelante.

1. Migre a su agente tal cual.

   Comience con una migración de línea base de todos los subagentes, instrucciones y acciones. Levante el diseño de agente heredado en el nuevo generador y verifique que funciona de extremo a extremo.

2. Identifique y solucione cualquier regresión.

   Para identificar regresiones, verifique la sintaxis de la secuencia de comandos de agente de su agente y compruebe si hay errores en el generador. Luego ejecute las mismas pruebas manuales y por lotes que ejecutó anteriormente para establecer la línea base previa a la migración de su agente.

   • Cualquier cosa que estaba funcionando en el agente en el generador heredado y no está funcionando en el nuevo generador es una regresión.
   • Cualquier otra cosa es una mejora o una mejora.

   Solucione cualquier regresión antes de realizar otros cambios, de modo que pueda aislar y solucionar problemas. Si algo se rompe después de la migración de línea base, sabe que es un resultado de la migración y no un cambio que realizó.

   

   Sugerencia Utilizar Agentforce para actualizar su agente reduce la probabilidad de problemas como errores de validación. Sin embargo, cualquier cambio en el razonamiento puede afectar al desempeño de los agentes. Es importante probar su agente de extremo a extremo debido a las diferencias en el modelo de datos y el motor de razonamiento subyacente entre los constructores heredados y los nuevos.
3. Adure y mejore su agente con la secuencia de comandos de agente.

   Después de que su agente de línea base sea estable en el nuevo generador, puede empezar a realizar cambios para mejorar la fiabilidad y el desempeño de su agente. En este punto, puede aprovechar las funciones que Agent Script tiene para ofrecer para solucionar cosas que nunca funcionaron del todo en el generador heredado e introducir determinismo estratégicamente para agregar previsibilidad y coherencia.

4. Amplíe su agente.

   En algún momento de su migración de agentes, es posible que escuche el canto de sirena de su lista de deseos de agentes y piense en ampliar las funciones de su agente a nuevos subagentes, casos de uso o integraciones. Resista la necesidad de ampliar demasiado pronto. Céntrese en su migración de agentes antes de presentar nuevas funciones. Hacer demasiado a la vez, especialmente antes de que su agente sea estable en el nuevo generador, corre el riesgo de enturbiar la arquitectura de su agente y hacer que los problemas sean más difíciles de seguir, aislar y solucionar.

Realizar cambios en lotes pequeños y probar después de cada lote

Si está solucionando regresiones o endureciendo su agente con Script de agente, evite realizar muchos cambios de una vez. Esto puede hacer que sea más difícil aislar y probar cualquier problema que puedan crear sus cambios (por ejemplo, un error de compilación), especialmente si está utilizando herramientas de codificación de IA externas. Aborde sus cambios de forma iterativa para medir mejoras, documentar resultados y minimizar regresiones.

• Realice cambios estructurales y arquitectónicos primero, luego ajuste y finalice los cambios después.
• Pruebe después de cada cambio y realice un seguimiento de sus mediciones con respecto a su línea base.
• Compruebe su agente y cree nuevas versiones después de cambios significativos, no pequeñas soluciones. Obtenga más información acerca del ciclo de vida de modificación y versión de agentes en el nuevo generador.

Sugerencias para pruebas

Las pruebas son fundamentales para establecer una línea base, medir objetivamente resultados y mejoras y minimizar las regresiones. Cuando migra, existen cambios en el razonamiento y las instrucciones de su agente, que pueden afectar al comportamiento del agente. Independientemente de la herramienta o herramientas de migración que utilice, planifique probar, ajustar y probar cuidadosamente de nuevo para asegurarse de que su agente tiene el desempeño esperado.

• Pruebe al principio de cada etapa de su migración de agentes y de nuevo después de cada lote de cambios. Planifique realizar pruebas de forma temprana y frecuente, incluyendo:
  • Antes de migrar, establezca una línea base inicial e identifique problemas.
  • Tras su migración inicial, establezca una línea base en el nuevo generador e identifique regresiones.
  • Después de cada cambio importante o lote de pequeños cambios
• Cree un plan de pruebas que incluya pruebas manuales en Agentforce Builder y pruebas por lotes en Centro de pruebas de Agentforce. Ejecute el mismo plan para realizar un seguimiento de su línea base. Como mínimo, un buen plan de pruebas cubre:
  • Funciones principales de agentes, como la creación de casos, la reserva de citas, el seguimiento de pedidos o las preguntas más frecuentes con la acción Responder a preguntas con Knowledge.
  • Personas basadas en comportamiento de usuario real, como usuarios autenticados, usuarios no autenticados, usuarios impacientes o infelices, usuarios que participan en muchas pláticas pequeñas.
  • Una gama de escenarios sencillos y más complejos, incluyendo pláticas de múltiples turnos, casos de uso de múltiples subagentes y casos extremos.
• Si implementó la verificación de clientes, incluyendo cualquier filtrado basado en las variables verifiedCustomerId o isVerified, pruebe explícitamente el comportamiento de su agente como un usuario final no verificado y como un usuario final verificado. En el nuevo generador, realice una vista previa de su agente en modo de prueba en vivo. Para simular usuarios verificados y no verificados, en la ficha Variables, sustituya los valores de cualquier variable que utilice para almacenar los resultados de la verificación de clientes o los Id. de clientes verificados.
• Pruebe explícitamente cambios bruscos en la plática del agente. Los usuarios pueden cambiar de solicitudes a pequeñas pláticas, realizar nuevas solicitudes antes de que se complete su solicitud actual o cambiar el tema de la plática. Aunque los agentes son adaptables, los problemas con el cambio de tema pueden perderse fácilmente si no los está buscando. Para probar de forma efectiva, cambie el asunto tres o cuatro veces en una plática de vista previa para verificar el comportamiento fiable de los agentes.
• Las funciones de prueba varían entre el generador heredado y el nuevo generador, tanto para pruebas manuales como por lotes. Conozca las herramientas de prueba disponibles para cada una. Planifique probar las mismas funciones, personas y escenarios en las herramientas heredadas y nuevas de modo que pueda comparar mediciones con la mayor precisión posible.

Sugerencias para trabajar con herramientas de IA externas

Los agentes son metadatos y la secuencia de comandos de agente es altamente portátil, de modo que tiene la flexibilidad de utilizar herramientas de código bajo, procódigo y externas para migrar y mejorar su agente. Utilice una combinación de todas las herramientas que funcionen mejor para usted, pero tenga en cuenta estas sugerencias para trabajar con herramientas externas.

• Las herramientas de codificación de IA externas no siempre aciertan la sintaxis de secuencias de comandos de agentes, incluso con habilidades Agentforce cargadas. Descargue la documentación oficial de secuencias de comandos de agentes y compártala con su agente de codificación. Revise siempre manualmente los cambios generados por la IA antes de aceptarlos y vuelva a factorizar los cambios en sintaxis de secuencia de comandos de agente válida, si es necesario. En caso de duda, consulte la documentación de Script de agente en la Guía del desarrollador Agentforce y utilice la IA para una segunda opinión.
• Saque el máximo provecho de Claude, Cursor y otras herramientas de IA definiendo restricciones y objetivos claros. La claridad sobre los criterios de éxito ayuda a estas herramientas a proporcionar resultados con capacidad de acción. Por ejemplo, las solicitudes generales como “mejorar mi agente” no tienen probabilidad de obtener resultados efectivos por sí solas. Es más probable que obtenga un mejor resultado si realiza una solicitud más específica (por ejemplo, “asegúrese de que el agente siempre comprueba la aptitud del pedido antes de intentar procesar una devolución”). Además, compartir esta guía de migración como contexto puede ayudar a las herramientas de IA a comprender sus requisitos y sugerir enfoques efectivos.
• Hay más de una forma de trabajar con herramientas de IA, y no tiene que optimizar todo su agente a la vez. Si no está obteniendo los resultados que desea o le resulta difícil comprender los cambios generales en el diseño y el comportamiento de su agente, trate las herramientas de IA más como socios estratégicos y colaboradores que como contratistas independientes. Puede utilizarlos de forma iterativa para diagnosticar problemas específicos y discretos, validar enfoques e implementar soluciones. Estos son algunos ejemplos de flujos de trabajo efectivos y de gran tamaño.
  • Cuando utiliza una herramienta de codificación de IA con habilidades precargadas para realizar un cambio, revise el cambio en el modo de plan. Solicite que explique por qué realizó cambios específicos para impugnar y validar decisiones de diseño y determinar la mejor ruta a seguir. Luego ejecute el cambio en modo de agente.
  • Revise una instrucción manualmente y anote los cambios recomendados. En modo pregunta, solicite una perspectiva de IA sobre sus cambios: ¿está de acuerdo la IA, qué haría diferente y por qué? Utilice este proceso para decidir qué cambios mantener. Luego ejecute los cambios en modo de agente en pequeños lotes.

Sugerencias para trabajar en equipos

Actualmente, no recomendamos colaborar en el mismo agente en el generador al mismo tiempo. Pero existen formas de trabajar juntos de forma efectiva en su migración de agentes.

• Además de la revisión de IA de cualquier cambio, considere la revisión de colegas como una comprobación de calidad antes de confirmar cambios de agentes.
• Limite la colaboración multijugador a problemas y soluciones sencillos e independientes.
• Cada generador debe trabajar en su propia copia del agente. A continuación difunda manualmente y combine las copias. Al igual que muchos otros pasos en esta guía, puede utilizar la IA puede ayudar con esto.