Prácticas recomendadas para instrucciones de acción de agentes
Las instrucciones de acción indican a un agente qué hace su acción y cuándo utilizarla. Cuando cree una acción personalizada, planifique y pruebe cuidadosamente sus instrucciones para asegurarse de que su acción tiene el rendimiento esperado.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition. Las licencias complementarias requeridas varían según el tipo de agente. |
Los nombres y las instrucciones para las acciones de agentes y sus entradas y salidas determinan cuándo y cómo se utiliza una acción. Los agentes de IA utilizan un modelo de idioma grande (LLM) y el motor de razonamiento para buscar en todos los subagentes y acciones asignados a un agente y seleccionar uno o más para ejecutar en la conversación, basándose en la pregunta o solicitud del usuario. Cuanto más efectivas sean las instrucciones, más previsible será el rendimiento de la acción.
Las instrucciones efectivas varían según la acción y el caso de uso. Para obtener los mejores resultados, pruebe su acción en Agentforce Builder e itere hasta que su acción cumpla sus requisitos.
Instrucciones para acciones
Las instrucciones de acción describen lo que hace su acción y cuándo utilizarla en una conversación. El elemento más importante de las instrucciones de acción es una descripción concisa del lenguaje natural de lo que hace su acción, normalmente de una a tres frases escritas como una instrucción al LLM. La descripción puede incluir el objetivo o la tarea de la acción, cualquier caso de uso para la acción y los objetos o registros que utiliza o modifica. En general, cuantos más detalles relevantes incluya en sus instrucciones, más fácil será para el LLM diferenciar entre acciones.
| Acción de agente de ejemplo | Descripción menos efectiva | Descripción más efectiva |
|---|---|---|
| Actualizar número de teléfono del contacto | Actualiza un número de teléfono. | Actualiza el número de teléfono del usuario asociado con su registro de contacto. Si no existe ningún contacto coincidente, crea un nuevo registro de contacto. |
| Registros de consulta | Proporciona la capacidad de utilizar lenguaje natural para consultar información acerca de registros de Salesforce CRM. | Busca y recupera registros de Salesforce CRM basándose en entrada de usuario y condiciones específicas, como valores de campo. Esta acción identifica automáticamente los registros y el tipo de objeto correctos. |
| Realizar seguimiento de pedido | Acción para obtener información de seguimiento para un pedido. | Devuelve información de seguimiento para un pedido de cliente basándose en el número de seguimiento y el código postal de destino. |
En muchos casos, la descripción del lenguaje natural es todo lo que se requiere para que un agente utilice su acción como se espera. Sin embargo, algunas acciones requieren más detalles después de la prueba. Estas son algunas opciones para refinar su descripción de acción.
| Qué incluir | Cuándo utilizar | Ejemplos |
|---|---|---|
| De una a tres expresiones, o entradas de cliente de ejemplo | Incluya ejemplos de mensajes de clientes que espera que desencadenen su acción para ayudar al LLM a hacer coincidir una entrada de cliente concreta con su acción. Si incluye múltiples expresiones, minimice la superposición.
|
|
| Acciones dependientes | Algunas acciones utilizan otras acciones, a menudo acciones del sistema, para obtener la información requerida. Si falta una acción obligatoria en un plan o no se están llamando acciones en el orden correcto, puede especificarlas por nombre de API. | La acción IdentificationRecordByName debe llamarse directamente antes de esta acción para obtener un Id. de registro único como entrada. Si la acción IdentificationRecordByName forma parte del plan, debe ejecutarse antes de GetRecordFieldsAndValues. |
| Ejemplos de cómo desea que funcione la acción | Los ejemplos no generalizan bien, pero pueden ser útiles cuando un agente comete un error coherente. En general, los LLM comprenden ejemplos de qué hacer mejor que ejemplos de qué no hacer, pero puede probar con cualquiera de ellos. |
Esta acción debe llamarse solo cuando una acción de resumen más específica no está disponible. |
Instrucciones para entradas y salidas
Las instrucciones para entradas y salidas describen cómo dar formato y utilizar el parámetro. En las instrucciones para una entrada, especifique qué información se requiere para completar la acción. En las instrucciones para una salida, especifique el resultado de la acción y lo que un agente devuelve al usuario.
Los LLM no tienen una comprensión completa del contexto, incluyendo el contexto de Salesforce. En otras palabras, un LLM no siempre conoce el número de caracteres en un Id. de registro de Salesforce o los nombres de objetos de Salesforce. Las instrucciones concisas pero detalladas ayudan a un agente a recuperar la información necesaria y devolver resultados relevantes. La mejor forma de determinar el nivel de detalle correcto es probar e iterar en sus instrucciones.
Al redactar instrucciones para una entrada o una salida, considere:
- El tipo de datos de la información: “un Id. de 18 caracteres”, “una respuesta de texto enriquecido a la pregunta del usuario”.
- Cualquier valor o campo específico: “contiene el Id. de contacto y la fecha de entrega prevista”.
- Cómo se recupera o se genera la información: “Para un nuevo correo electrónico, recupere el Id. de la entrada del usuario. Para un correo electrónico revisado, recupere el Id. del historial de conversaciones”.
- Cualquier regla especial sobre cómo espera que se utilice la acción: “No genere SQL o SOQL.”, “Obligatorio solo cuando el usuario desea revisar un borrador anterior.”, “El nombre de API se utiliza para identificar pares campo-valor de registro de Salesforce desde la solicitud del usuario.”
Estos son algunos ejemplos de instrucciones efectivas para entradas y salidas.
| Parámetro Entrada o Salida | Instrucciones |
|---|---|
| recordId | El Id. único del registro de Salesforce CRM para el que crear el resumen. Por ejemplo: recordId, record_id, recordIds[0], accountId. |
| objectApiName | El nombre de API del objeto de Salesforce (como Cuenta u Oportunidad) asociado con el registro que desea encontrar el usuario. El nombre se puede obtener del contexto y no requiere la acción IdentificarObjetoPorNombre. |
| resumen | El resumen de texto enriquecido creado para el registro especificado. |
| searchResults | Una lista de los Id. de registro de Salesforce CRM coincidentes en orden descendente de relevancia. |
| generatedEmail | Un objeto JSON que contiene el Id. del destinatario, la línea de asunto y el cuerpo del correo electrónico. |
