> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear Piper Agents: Schedule, Scope, Brain y herramientas

> Configura tu Piper Agent en cuatro pasos: define un calendario, delimita el alcance, escribe las instrucciones y elige las herramientas a las que tu agente puede acceder.

Crear un Piper Agent solo toma unos minutos. Recorres cuatro pasos de configuración —Schedule, Scope, Brain y Capabilities— y el agente empieza a ejecutarse automáticamente según la frecuencia que definas. El paso con mayor impacto es escribir instrucciones claras y específicas en la sección Brain, que determina la calidad de todo lo que produce el agente.

<Steps>
  <Step title="Schedule — ¿cuándo trabaja?">
    Define con qué frecuencia se ejecuta tu agente. Puedes configurarlo para activarse con una cadencia recurrente o después de eventos específicos.

    Las opciones de programación comunes incluyen:

    * **After every call** — ideal para coaching en tiempo real o resúmenes inmediatos tras la llamada
    * **Daily** — útil para el seguimiento del pipeline o resúmenes nocturnos
    * **Weekly** — lo mejor para informes consolidados, instantáneas de sentimiento o revisiones a nivel de equipo

    Elige una frecuencia que coincida con cuán a menudo necesitas información fresca. Una cadencia semanal funciona bien para revisiones estratégicas; un disparador posterior a la llamada es mejor para el coaching a nivel de representante.
  </Step>

  <Step title="Scope — ¿a quién observa?">
    Define las llamadas de qué miembros del equipo analiza el agente. Puedes enfocarte en:

    * **All users** de tu workspace
    * **Specific teams** o grupos
    * **Individual reps** o account managers

    Mantener el alcance enfocado mejora la calidad de los resultados. Un agente de coaching enfocado en las llamadas de un solo representante dará un feedback más preciso y accionable que uno que intenta cubrir toda una organización a la vez.

    <Note>
      Una sola ejecución analiza hasta **100 reuniones**, y una ejecución programada cubre hasta **15 usuarios objetivo** a la vez. Si los usuarios del alcance generan más actividad que eso, reduce el alcance o aumenta la frecuencia de ejecución para que no se pierda ninguna reunión.
    </Note>
  </Step>

  <Step title="Brain — instrucciones y principios">
    Escribe las instrucciones que le indican a tu agente qué buscar, cómo analizarlo y qué debe generar como resultado. Esta es la parte más importante de tu agente: la calidad de tus instrucciones determina directamente la calidad de tus resultados.

    Tus instrucciones deben responder:

    * ¿Qué señales o patrones debe buscar el agente?
    * ¿Qué debe señalar, puntuar o resumir?
    * ¿Qué formato debe tener el resultado (lista con viñetas, tabla, narrativa, etc.)?
    * ¿Hay meeting types o periodos específicos que incluir?

    <Tip>
      **Consejos para escribir excelentes instrucciones de agente:**

      * **Sé específico** sobre lo que el agente debe buscar; las instrucciones vagas producen resultados vagos. En lugar de "resume la llamada", escribe "identifica si el representante hizo una pregunta de descubrimiento sobre presupuesto, plazos y responsable de decisión en los primeros 10 minutos".
      * **Define claramente el formato de salida** — especifica si quieres una lista con viñetas, una tabla puntuada, un mensaje estilo Slack o un párrafo narrativo.
      * **Incluye ejemplos** de cómo se ve lo "bueno" y lo "malo" si es relevante; esto ancla el juicio del agente a tus estándares.
      * **Menciona meeting types o periodos** — por ejemplo, "analiza demos y llamadas de descubrimiento de los últimos 7 días" es mucho más preciso que "mira las llamadas recientes".
      * **Un propósito claro por agente** — los agentes con un objetivo único y enfocado superan siempre a los agentes multipropósito. Crea agentes separados para coaching, detección de riesgos y seguimiento competitivo en lugar de combinarlos.
    </Tip>

    Si no sabes por dónde empezar, usa una de las [plantillas predefinidas](./templates) como base y personalízala.
  </Step>

  <Step title="Capabilities — herramientas">
    Selecciona las herramientas y fuentes de datos a las que tu agente puede acceder durante sus ejecuciones. Otorgar las capacidades correctas garantiza que el agente tenga el contexto que necesita sin acceso innecesario.

    Las capacidades disponibles incluyen:

    * **Transcriptions** — leer el texto completo de las llamadas grabadas
    * **CRM Data** — acceder a los registros de negocio, contacto y opportunity de tu CRM conectado (HubSpot, Salesforce o Pipedrive)
    * **Notes** — leer las notas de reunión creadas por ti o tu equipo
    * **Tasks** — ver y crear tareas de seguimiento
    * **Email** — leer hilos de tu propia bandeja de Gmail/Outlook conectada, relacionados con un contacto o negocio. Se obtiene bajo demanda y no se almacena — esto no recupera correos registrados en tu CRM (por ejemplo, registros EmailMessage de Salesforce), y el acceso está limitado únicamente a tu propia bandeja.

    <Note>
      Si no hay ningún CRM conectado, la capacidad CRM Data no tiene nada que leer; los agentes recurren entonces a las transcripciones, notas y tareas almacenadas en Piper.
    </Note>

    Activa solo las capacidades que tu agente necesite. Un agente de coaching enfocado en la calidad de las llamadas solo necesita Transcriptions. Un detector de riesgo de negocio se beneficia de combinar Transcriptions con CRM Data para obtener contexto completo.
  </Step>
</Steps>

## Después de guardar

Una vez que guardas tu agente, comienza a ejecutarse automáticamente según el calendario que definiste. Puedes volver a cualquier agente en cualquier momento para actualizar sus instrucciones, cambiar su alcance o ajustar su calendario.

<Accordion title="¿Cuántos agentes puedo crear?">
  No hay un límite en la cantidad de agentes que puedes crear en Piper. Crea tantos como tu equipo necesite; uno por caso de uso es el enfoque recomendado para mantener cada agente enfocado y sus resultados fáciles de accionar.
</Accordion>

<Accordion title="¿Puedo probar un agente antes de que se ejecute según su calendario?">
  Sí — después de guardar tu agente, puedes activar una ejecución manual para ver cómo se comporta antes de que entre en marcha la cadencia programada. Revisa el resultado y ajusta tus instrucciones en el paso Brain si es necesario.
</Accordion>

<Accordion title="¿Cuál es la diferencia entre un agente y una consulta de Chat?">
  Chat es interactivo: haces una pregunta y recibes una respuesta de inmediato. Los Agents son automatizados: se ejecutan según un calendario y muestran información de forma proactiva, sin que necesites indicarles nada cada vez. Usa Chat para preguntas puntuales y Agents para flujos recurrentes.
</Accordion>