Saltar al contenido principal
Esta guía se centra exclusivamente en el diseño y la redacción de prompts efectivos para AI Agents y AI Tasks. Para conceptos generales de agentes, estructura, herramientas y configuraciones, revisa la Guía general de AI Agents.

Ejemplos de prompts para un AI Agent

Preguntas Frecuentes

Cuando necesitemos darle contexto adicional sobre una empresa al AI Agent para que pueda responder a las consultas del usuario. Deben usar el nodo AI Agent.

Prompt

Incluso, se puede incluir guías para manejar la interacción, como por ejemplo:

Redireccionar al usuario

Cuando se necesite redireccionar al usuario a una parte del flujo según su intención. Si es el único propósito (como un router) pueden usar un AI Task. Si esto es parte de una interacción, como por ejemplo redireccionar al usuario a un flujo cuando lo solicita, pueden usar un AI Agent. Esto se puede conseguir con una combinación de AI y nodo condicional. Deben guardar la respuesta del AI, que la pueden acceder con {{$memory.nombreVariable}}.

Prompt

Solicitar datos al usuario

Para procesos de registro o flujos en los que se debe pedir información al usuario.

Prompt

Luego, se puede acceder con {{$memory.nombreVariable}} para guardarla en un nodo Datum.

Ejemplos de prompts para un AI Task

Los AI Task son peticiones a OpenAI/LLM preferido. Su prompt es más fácil de escribir y no requiere de utilizar palabras claves para terminar como end_function. Su objetivo siempre será cumplir lo que le dice el prompt y guardar la respuesta en formato JSON.

Redireccionar al usuario

La diferencia es que no se hace uso de end_function.

Resumen de Buenas Prácticas

Tipos de contenido y formato en prompts

  • Mantén un lenguaje consistente en todo el prompt.
  • Especifica claramente el formato de salida (JSON recomendado).
  • Si el flujo requiere terminar, define explícitamente el uso de end_function.ar

Diseño Inteligente de Prompts Condicionales

Para obtener mejores resultados, es clave minimizar la cantidad de decisiones que debe tomar la IA, especialmente cuando no están directamente relacionadas con su objetivo principal. En lugar de cargar el prompt con múltiples instrucciones condicionales, es preferible preprocesar la lógica fuera del AI Agent, manteniendo el prompt limpio, enfocado y más efectivo.

Qué evitar

Evita escribir prompts como este:
Si tienes datos en esta variable {{$memory.variable}}, entonces haz tal cosa, de lo contrario, sigue estas otras instrucciones.
Este tipo de lógica agrega ambigüedad y ruido al prompt, lo cual puede dificultar la comprensión del modelo y disminuir la precisión de la respuesta.

Alternativa recomendada

Usa lógica condicional previa en un nodo de tipo código para definir qué instrucciones debe seguir la IA antes de enviarle el prompt. Ejemplo:
Luego, en tu AI Agent, simplemente haz referencia a la variable procesada:

Beneficios

  • Reduce la carga cognitiva del modelo
  • Disminuye el uso de tokens innecesarios
  • Aumenta la claridad del prompt
  • Mejora la consistencia de las respuestas
Este enfoque ayuda a diseñar agentes más confiables y predecibles, especialmente cuando se combinan múltiples fuentes de entrada o condiciones dinámicas.
Para consideraciones sobre modelos (GPT-4.1, contextos largos, CoT y recordatorios de agente), consulta la Guía general de AI Agents.

Herramienta de Validación de Prompts

Para facilitar la creación de prompts efectivos, puedes usar una herramienta en beta que actúa como asistente de pruebas. Si tu prompt no está funcionando como esperas o necesitas una guía rápida para comenzar, simplemente accede al siguiente enlace, escribe tu prompt u objetivo y sigue las sugerencias del asistente: ChatGPT - Corrector de Prompts AI Agents Esta herramienta está en fase beta, por lo que aún se encuentra en desarrollo. Sin embargo, es útil para detectar errores comunes, refinar instrucciones y validar si el prompt está bien estructurado antes de implementarlo en Brain Studio.

Recursos adicionales

  • OpenAI Platform - Explora recursos de desarrollador, tutoriales, documentación de API y ejemplos dinámicos
  • AI Playground - Compara modelos de IA lado a lado: OpenAI GPT, Anthropic Claude, Google Gemini, Llama, Mistral y más