Añadir instrucciones a los agentes
Los agentes de IA operan basándose en un conjunto de instrucciones de comportamiento que definen cómo responden a las entradas de los usuarios, realizan tareas e interactúan a través de diferentes canales. Estas instrucciones sirven como directrices internas del agente, ayudándole a actuar de forma coherente y eficaz en diversos escenarios.
Configurando estas instrucciones, puede asegurarse de que el agente se alinea con el tono de su organización, los objetivos empresariales y las expectativas de los usuarios. Tanto si el agente está respondiendo a una pregunta, activando una herramienta o colaborando con otro agente, estas reglas ayudan a mantener una experiencia fluida y profesional.
Las instrucciones se añaden en la sección Comportamiento de Agent Builder. Una vez añadidos, se aplican globalmente en todos los canales y tareas, lo que significa que el agente los sigue independientemente de dónde o cómo se le llame.
¿Qué son las instrucciones?
Las instrucciones son reglas configurables que configuran el comportamiento del agente. Determinan cómo responde el agente, cuándo activa las herramientas y cómo colabora con otros agentes. Las instrucciones se añaden en la sección Comportamiento de Agent Builder y se aplican globalmente a todos los canales y tareas.
Instrucciones de uso
Utiliza las instrucciones cuando quieras:
- Alinee el tono del agente con su marca.
- Controla cómo el agente maneja escenarios específicos.
- Garantizar un comportamiento coherente en todos los canales y tareas.
- Permitir la colaboración con herramientas u otros agentes.
Antes de empezar
Antes de añadir instrucciones al agente, es importante entender cómo funcionan y qué impacto tienen:
Las instrucciones sobrescriben las existentes: Al introducir nuevas instrucciones, éstas sustituyen a cualquier regla definida previamente. No se admiten versiones ni retrocesos, así que revise los cambios cuidadosamente antes de guardarlos.
Los cambios se guardan automáticamente: Cuando introduces o modificas instrucciones, se aplican al instante.
Los valores por defecto se aplican cuando faltan instrucciones: Si deja el campo de instrucciones en blanco, el agente confía en su lógica incorporada. Aunque puede funcionar para casos de uso general, es posible que no se ajuste a las necesidades específicas de su empresa.
Las instrucciones se aplican globalmente: Cualquier instrucción que añadas se aplica en todos los canales (por ejemplo, chat, Slack) y en todas las tareas que realice el agente. Actualmente, no se pueden establecer instrucciones condicionales basadas en el contexto del usuario, el canal o el tipo de tarea.
Pasos para añadir instrucciones
Para definir o actualizar el comportamiento de su agente:
- En el menú principal, vaya a Construir.
- Haga clic en Crear agente > Crear desde cero.
- Introduzca un Nombre y una Descripción.
- Vaya a la sección Comportamiento.
- En el campo Instrucciones, introduzca normas claras y aplicables.
Repase primero las Recomendaciones para redactar instrucciones eficaces. Es esencial para asegurarse de que su agente se comporta como se espera de él. - Los cambios se guardan automáticamente.
Cuando se añaden instrucciones, el agente empieza a utilizarlas de inmediato en todas las conversaciones. Estas reglas influyen en la forma en que el agente responde a las peticiones de los usuarios, en todas las tareas y canales conectados.
Personalización de las respuestas de los agentes con variables contextuales
Los agentes de IA pueden adaptar las respuestas en función del usuario con el que interactúan y de la información disponible. Las variables de contexto permiten respuestas dinámicas y personalizadas que reflejan la situación actual y el perfil del usuario.
Las variables de contexto actúan como marcadores de posición para datos específicos del usuario, como el ID de correo electrónico, la ubicación o el ID de miembro que puede pasar al comportamiento del agente. Con ellos, su agente se vuelve más inteligente, receptivo y relevante.
Ventajas de utilizar variables contextuales
- Respuestas personalizadas: Salude a los usuarios por su nombre, haga referencia a su ubicación o adapte las respuestas en función de su función o preferencias.
- Continuidad de la sesión: Llevar la información a través de múltiples pasos o tareas sin pedir al usuario que se repita.
- Integraciones más inteligentes: Comparta datos de usuario con herramientas u otros agentes para realizar acciones como la obtención de registros o la activación de flujos de trabajo.
Cómo instalarlo
Para utilizar variables de contexto, primero debe definirlas utilizando el Kit de Desarrollo de Agentes (ADK). El ADK proporciona una forma de especificar el tipo de datos que reconoce su agente y cómo acceder a ellos. Para más información, consulte Proporcionar acceso a variables de contexto.
Cómo utilizarlas en las instrucciones
Una vez definidas las variables en el ADK, puede hacer referencia a ellas directamente en la sección Behavior de Agent Builder utilizando llaves {}.
A continuación se muestran ejemplos de instrucciones que utilizan variables de contexto:
- Always respond with watsonx Orchestrate email ID as {wxo_emailid}, wxo user name as {wxo_userid}, wxo tenant ID as {wxo_tenantid}, location as {location}, and member ID as {memberid}.
- Make a tool call when user input matches the tool description and respond to the user.
- Make a call to a collaborator agent when the user input matches its description. Pass {wxo_emailid}, {wxo_userid}, {wxo_tenantid}, {location}, and {memberid} to the collaborator agent so it returns the values back to you.
Recomendaciones para redactar instrucciones eficaces
Cuando redacte instrucciones para su agente de IA, es importante seguir unas directrices claras y eficaces que garanticen que el agente se comporta de forma coherente, profesional y alineada con sus objetivos empresariales. Unas instrucciones bien definidas determinan la forma en que el agente responde a los usuarios, gestiona las tareas y mantiene un tono profesional en todas las interacciones.
A continuación se ofrecen recomendaciones categorizadas para redactar instrucciones eficaces y evitar los errores más comunes.
Qué hacer
| Categoría | Instrucción recomendada |
|---|---|
| Sea específico | "Escalar los problemas no resueltos a un agente humano" "Utiliza un tono cortés en todas las respuestas" "Pide aclaraciones si la petición es vaga" |
| Centrarse en el comportamiento | "No hagas suposiciones si la intención del usuario no está clara" "Resume las respuestas largas cuando sea posible" |
| Definir los límites | "No dar consejos legales, financieros o médicos" |
Estas instrucciones ayudan al agente a no salirse del camino, mantener un tono profesional y evitar extralimitarse en sus funciones.
Qué evitar
| Categoría | Instrucción recomendada |
|---|---|
| No sea impreciso | "Esfuérzate siempre al máximo" "Sé servicial" "Sé amable" (a menos que forme parte de una tarea, como un saludo) |
| No utilice lógica sin fundamento | "Responda así sólo si el usuario parece confuso" "Ajuste el tono en función de la emoción del usuario" |
| No incluya normas contradictorias | "Respuestas breves" + "Respuestas detalladas" |
Evite las instrucciones vagas o contradictorias, ya que pueden confundir al agente y provocar un comportamiento incoherente.
Ejemplo de instrucciones para agentes eficaces
Utilice el siguiente ejemplo como referencia cuando defina su propio comportamiento de agente. El ejemplo ilustra cómo redactar instrucciones claras, orientadas a los objetivos y alineadas con la marca, que ayuden a su agente a responder con precisión.
Ejemplo: Agente de soporte informático
Las siguientes instrucciones de ejemplo definen el comportamiento de un agente de soporte técnico que ayuda a los usuarios a solucionar problemas del sistema o del entorno, gestionar tickets y proporcionar orientación sobre la configuración.
- Always greet the user courteously. Include their name if available.
Example: Hello {wxo_userid}, how can I assist you with your system issue today?
- Maintain a clear, professional, and solution-oriented tone in all responses.
- When a user describes an issue, summarize their request before taking action to confirm understanding.
Example: You’re facing a login failure on the staging environment, correct?
- If the issue matches a known error pattern, retrieve and summarize the related troubleshooting article from the knowledge base.
- When a tool or workflow is available for remediation (for example, Restart Server or Create Ticket), trigger it automatically and confirm the outcome to the user.
- Include relevant details such as environment name, ticket number, and affected component using context variables.
- If the issue cannot be resolved automatically, escalate it to the DevOps team with all collected diagnostic details.
- Never make changes to production systems without explicit user confirmation.
Example: Do you want me to apply the configuration fix to the production environment?
- Close the conversation by confirming resolution or next steps.
Example: Your ticket {ticket_id} has been created. The DevOps team will review it shortly.
Qué hacer a continuación
Cuando termine de añadir instrucciones, siga los siguientes pasos para validar y perfeccionar el comportamiento de su agente:
- Pruebe su agente en la página de chat para observar cómo aplica las nuevas instrucciones.
- Conecte su agente a un canal compatible (por ejemplo, Slack, Microsoft Teams) para evaluar las respuestas en escenarios reales. Para más información, consulta Conexión a canales.
- Despliegue su agente. Para más información, consulte Despliegue del agente.
- Revise y actualice las instrucciones periódicamente para reflejar los cambios en sus objetivos empresariales, las expectativas de los usuarios o las tareas compatibles.