Agente personalizado

How to build a Custom Agent
En este artículo

Con los agentes personalizados, puedes crear flujos de trabajo compartidos que automatizan el trabajo recurrente de tu equipo, ejecutándose exactamente como los necesitas, en segundo plano 🤖

Ir a las preguntas frecuentes

Custom Agents are currently in beta and subject to the beta terms of your agreement.

Los agentes personalizados automatizan flujos de trabajo manuales y recurrentes para todo tu equipo. Se ejecutan automáticamente en segundo plano en activadores configurados utilizando tus documentos y bases de datos existentes como contexto.

Configúralos solo una vez. Puedes crear un flujo de trabajo para tareas repetitivas como informes semanales o clasificación de comentarios, y se convertirá en un recurso compartido en el que todo el equipo puede apoyarse.

¿Qué son los agentes personalizados?

Los agentes personalizados se encuentran dentro de Notion y se ejecutan según tus instrucciones. Una vez que los configures, podrán:

  • Leer contenido de páginas y bases de datos en Notion, así como de determinadas aplicaciones conectadas.

  • Ejecutarse en activadores recurrentes y eventos del espacio de trabajo.

  • Realizar acciones como publicar informes, registrar errores, actualizar registros o enviar mensajes.

A diferencia del agente de Notion, los agentes personalizados están diseñados para ejecutarse automáticamente en segundo plano en función de activadores y programaciones.

Utilizan tus documentos y bases de datos existentes como contexto

Los agentes personalizados están integrados directamente en Notion. Usan tus documentos y bases de datos existentes como contexto y pueden conectarse a través de Slack, lo que aumenta la productividad. Los agentes personalizados pueden:

  • @mencionar agentes en páginas de Notion, propiedades de bases de datos y comentarios.

  • Vincularse a eventos de bases de datos (por ejemplo, cuando se crea o actualiza una página).

  • Supervisar tu espacio de trabajo y las herramientas conectadas según los activadores que configures.

Gestionar el trabajo recurrente automáticamente con activadores

Usa activadores para que los agentes personalizados se ejecuten sin que tengas que iniciarlos manualmente cada vez. Configura un activador una sola vez y el trabajo se realizará de forma continua en segundo plano.

  • Se ejecuta según una programación (diario, semanal, mensual y más).

  • Reaccionar a eventos en Notion y Slack.

  • Continúa ejecutándose en segundo plano una vez publicados.

Esto permite automatizar los flujos de trabajo, como informes periódicos, colas de clasificación y el mantenimiento de la información, ayudándote a recuperar tiempo.

Seguridad y transparencia desde el diseño

Los agentes solo actúan sobre las páginas, bases de datos y aplicaciones externas a las que les otorgues acceso explícitamente. Nunca tienen acceso completo al espacio de trabajo de forma predeterminada, lo que reduce el riesgo.

  • Controla quién puede editar, ejecutar o interactuar con cada agente.

  • Consulta los registros de actividad para ver qué hizo un agente y cuándo lo hizo.

  • Utiliza el historial de versiones para revisar o restaurar configuraciones anteriores.

  • Permite que las ejecuciones se puedan revisar y revertir para iterar de forma segura.

  • Debes contar con el plan Business o Enterprise de Notion.

  • Para crear o editar agentes personalizados, utiliza la versión de escritorio o web. Puedes ver o interactuar con los agentes en la versión de escritorio o web.

    • También puedes ver e interactuar con cualquier contenido que los agentes creen en las páginas y bases de datos de Notion en dispositivos móviles.

    • Puedes consultar las publicaciones de los agentes en Slack desde la app móvil de Slack.

Puedes crear un Agente personalizado desde varias ubicaciones. El punto de acceso principal es la sección Agentes en la barra lateral.

  1. Ve a la sección Agentes en la barra lateral izquierda y selecciona + para crear un agente personalizado nuevo.

  2. Elige cómo quieres empezar:

    • Crear a partir de una plantilla

      • Elige una plantilla.

      • Revisa el borrador de instrucciones, los activadores y los accesos que genera la IA de Notion, y realiza los ajustes necesarios.

      • Guarda los cambios.

    • Crear con el chat de la IA

      • En el chat, describe lo que quieres que haga el agente usando un lenguaje natural.

      • Revisa el borrador de instrucciones, los activadores y los accesos que genera la IA de Notion, y realiza los ajustes necesarios.

      • Guarda los cambios.

    • Crear desde cero

      • Selecciona la opción Crear en blanco.

      • Comienza con un campo de instrucciones vacío o chatea con el asistente para definirlas.

      • Redacta las instrucciones que quieres de forma manual, siguiendo las prácticas recomendadas para que sean claras y concretas. Define qué debe hacer el agente, cómo debe comportarse y qué tareas debe gestionar.

      • Configura los activadores, el acceso y tu modelo de IA hasta que se ajusten a tu flujo de trabajo.

      • Guarda los cambios.

To create clear instructions for your Agent, start with the job and outcome you want. Then add concrete steps, inputs, and outputs. Use examples when you have them.

Tip: Use our Custom Agent templates as a starting point.

Los activadores determinan cuándo se ejecuta tu agente. Puedes combinar varios tipos de activadores para un mismo agente.

Automatiza los flujos de trabajo con programaciones recurrentes

Utiliza programaciones recurrentes para que los agentes se ejecuten de forma periódica.

  1. Abre la Configuración de tu agente personalizado.

  2. Ve a la sección Activadores.

  3. Agrega un activador recurrente.

  4. Elige cuándo quieres que se ejecute el agente:

    • Selecciona una frecuencia (cada día, semana, mes o año).

    • Define una hora específica, incluida la zona horaria (por ejemplo, “todos los días a medianoche (PST)”).

  5. Revisa la próxima hora de ejecución programada para confirmar que sea correcta.

  6. Guarda el activador.

Cómo usar los activadores de Notion

Los activadores de Notion ejecutan tu agente en función de los eventos que ocurren en tu espacio de trabajo. Puedes hacer que se activen cuando:

  • Se agrega un comentario a una página.

  • Se agrega una página a una base de datos.

  • Se actualiza una página en una base de datos.

  • Se elimina una página de una base de datos.

  • Se @menciona al agente personalizado en una página o comentario.

Para agregar un activador de Notion, sigue estos pasos:

  1. Abre la Configuración de tu agente personalizado y selecciona Activadores.

  2. Elige un tipo de activador de Notion.

  3. Especifica:

    • La página o base de datos que se debe tener en cuenta.

    • El evento (por ejemplo, “Se creó una página en la base de datos”).

    • Cualquier filtro o condición adicional, si está disponible.

  4. Guarda los cambios.

Cómo usar los activadores de Slack

Los activadores de Slack permiten que los agentes supervisen eventos en canales públicos de Slack. Los agentes pueden activarse cuando se publica un mensaje en un canal, se agrega una reacción de emoji a un mensaje, se inicia un hilo en un canal o se menciona a un agente personalizado en un mensaje.

Para agregar un activador de Slack, sigue estos pasos:

  1. Conecta Slack a tu agente durante la configuración, si aún no lo has hecho.

  2. En Activadores, agrega un disparador de Slack.

  3. Selecciona:

    • El tipo de evento.

    • El canal que se desea supervisar.

    • Cualquier filtro o condición adicional, si está disponible.

  4. Guarda los cambios.

Note:

  • If you want to @mention a Custom Agent by name in Slack, your Slack workspace owner needs to allow members to create user groups. This is a Slack requirement (not a Notion setting).

  • Saved or "Later" messages in Slack are not supported.

Los agentes personalizados solo utilizan el contenido al que les otorgues acceso explícitamente para realizar su trabajo. Puedes configurarlo en los ajustes de acceso de cada agente.

Cómo otorgar acceso a un agente personalizado al contenido de tu espacio de trabajo

Para controlar qué puede ver un Agente en Notion:

  1. Abre la Configuración de tu agente personalizado.

  2. Ve a la sección Herramientas y acceso.

  3. Agrega las páginas o bases de datos específicas que el agente debe usar como contexto:

    • Otorga acceso al Centro de ayuda para que pueda consultar el contenido de ayuda de Notion.

    • Otorga acceso a las páginas compartidas con todos en Notion si quieres una alcance amplio que abarque contenido en todo el espacio de trabajo.

    • Agrega páginas y bases de datos específicas para flujos de trabajo concretos (por ejemplo, “Tickets de clientes”, “Errores” o “Incidentes”).

  4. Si quieres un alcance más acotado, conserva el acceso en “Ninguno” o limítalo a un grupo reducido de páginas.

Linking to Notion pages in your Instructions doesn’t add them to the connected Tools and Access.

Permitir o bloquear el acceso a la web

Los agentes pueden navegar por la web cuando sea necesario. Usa el acceso web cuando tu flujo de trabajo dependa de información externa. Mantenlo desactivado para flujos de trabajo estrictamente internos o cuando quieras un control más estricto sobre las fuentes. Para controlar el acceso web:

  1. Abre la Configuración de tu agente.

  2. Busca la opción Acceso web .

  3. Activael acceso web para permitir que el agente obtenga información de internet.

  4. Desactiva el acceso web para restringir el agente únicamente a Notion y a las aplicaciones configuradas.

Otorgar acceso a Slack a los agentes personalizados

Los agentes personalizados pueden leer y escribir en Slack a través de una integración específica. Antes de conectar Slack a tu agente personalizado, un administrador debe conectar primero la conexión de la IA de Slack a tu espacio de trabajo a través de la configuración de la IA de Notion. Los agentes pueden hacer lo siguiente:

  • Leer contenido de canales públicos.

  • Publicar mensajes, respuestas y actualizaciones en los canales.

  • Reaccionar en hilos y usar la información de Slack como contexto.

Private messages and Slack grid are currently unsupported.

Para conectar Slack:

  1. Durante la configuración del agente, sigue las indicaciones para conectar Slack.

  2. Asegúrate de que la cuenta de Slack use el mismo correo electrónico que tu cuenta de Notion.

  3. Aprueba los alcances solicitados en el flujo de autorización de Slack.

  4. Elige los canales a los que puede acceder el agente.

Los agentes personalizados pueden ejecutarse en diferentes modelos de lenguaje de gran escala. Esto te permite equilibrar la velocidad, el costo y la calidad. Puedes ajustar el modelo con el tiempo si tu flujo de trabajo cambia o si identificas nuevas necesidades de rendimiento. Los modelos compatibles incluyen Claude, GPT y Gemini. La opción predeterminada recomendada es Auto.

Para elegir un modelo:

  1. Abre la Configuración de tu agente.

  2. Ve a la sección Modelo .

  3. Selecciona un modelo específico si quieres un comportamiento consistente o selecciona Auto para permitir que Notion seleccione el modelo más adecuado en cada solicitud.

  4. Guarda los cambios.

Los agentes personalizados se comportan como páginas de Notion cuando se trata de compartir con otras personas en tu espacio de trabajo, con algunas diferencias.

Compartir agentes con tu equipo

Cuando se comparten, los agentes pueden aparecer en la barra lateral, dentro de la sección Agentes, en los resultados de búsqueda y en cualquier área del espacio de trabajo donde se enumeren o referencien.

Para compartir un agente:

  1. Abre la página Agente personalizado.

  2. Haz clic en Compartir.

  3. Agrega personas, grupos o todo el espacio de trabajo.

Niveles de permiso

Los agentes utilizan un conjunto simplificado de niveles de permisos:

  • Acceso completoLos usuarios con permisos de Acceso completo a un agente pueden configurar las instrucciones, los activadores, los accesos y el modelo, consultar y gestionar el registro de actividad, así como ejecutar o interactuar con el agente.

  • Puede editarLos usuarios conpermisos de edición en un agente pueden modificar las instrucciones y la configuración, así como consultar el registro de actividad.

  • Puede ver e interactuarLos usuarios con permisos para ver e interactuar en un agente puedenejecutar el agente, chatear con él y consultar la página de Configuración (Activadores, Instrucciones, Herramientas y Acceso) en modo de solo lectura. No pueden editar ni compartir el agente.

Users without access may still trigger or interact with agents configured to respond to events like Slack messages in accessible channels.

Una vez que se cree tu agente personalizado, aparecerá en la barra lateral. Cada página de agente personalizado incluye tres pestañas principales. Usa estas pestañas juntas para diseñar, probar y mantener un agente a lo largo del tiempo.

  1. Chat Un espacio de conversación individual, privado o compartido, con ese agente específico.

    • Es útil para probar nuevas instrucciones, solicitar tareas puntuales al agente e iterar su comportamiento.

  2. Actividad Un registro de cada ejecución del agente, visible para los usuarios con acceso completo.

    • Los registros incluyen los activadores que iniciaron la ejecución, las acciones realizadas y cualquier error o falla.

  3. Configuración El centro de control del agente.

    • El panel Configuración incluye instruccionesdel agente, activadores, permisos de acceso y selección de modelos.

Treat configuration as a conversation. Use Custom Agent Chat to test, debug, and iterate on your instructions. Ask the agent to run one-off tasks, provide context on errors, and test different scenarios.

Usa la pestaña Configuración para editar un agente

  1. Abre la página del Agente.

  2. Ve a la pestaña Configuración.

  3. Actualiza las instrucciones, los activadores, el acceso a páginas, bases de datos y herramientas externas, o la selección de modelos.

  4. Guarda y publica tus cambios.

  5. Utiliza las pestañas Chat y Actividad para verificar que el agente se comporta como se espera después de realizar modificaciones.

Cómo revertir un cambio con el historial de versiones

Para restaurar una versión anterior de tu agente personalizado:

  1. Abre la página del Agente.

  2. Accede al historial de versiones.

  3. Revisa las versiones anteriores para ver:

    • Quién realizó los cambios.

    • Cuándo se realizaron los cambios.

    • Qué cambió en cada versión.

  4. Selecciona la versión que quieras restaurar.

  5. Confirma para revertir el agente a esa versión.


Preguntas frecuentes

How is this different from Notion Agent in the bottom right corner?

Notion Agent helps you:

  • Draft, edit, and summarize content.

  • Answer questions about pages and databases.

  • Perform one-off tasks while you work.

Custom Agents:

  • They follow precise instructions you define.

  • They can run autonomously in the background via triggers and schedules.

  • They operate only on the pages, databases, and external tools you explicitly grant.

Notion Agent is on-demand, whereas Custom Agents are autonomous.

If a run fails, how can I debug it?

To debug a run:

  1. Open the agent page.

  2. Go to the Activity tab in the agent's Settings or from the agent chat view.

  3. Find the failing run in the list.

  4. Open it to see:

    • What triggered the run.

    • What the agent "thought" and did at each step.

    • Any error messages or explanations.

If the agent behaved incorrectly:

  • Adjust its instructions or triggers.

  • Re-run with updated configuration.

  • If something looks wrong or suspicious, provide a thumbs-down and a detailed description where available so the team can improve the system.

What Slack app do I need to connect?

To use Slack with Custom Agents:

  1. Make sure Slack is connected with the same email address you use for Notion.

  2. When prompted during agent setup, connect the Slack app even if you already use Slack elsewhere in Notion.

  3. Approve access and configure which channels the agent can read or write to.

Who can create and see Custom Agents?

  • Custom Agents are available to everyone in the workspace by default.

    • Enterprise plan Admins can restrict access by going to Settings > Notion AI >

      Agents > Control who can create agents.

  • For each agent:

    • The creator decides who can access it and at what level (Full access, Can edit, Can interact).

    • In Slack, anyone in a channel can see messages posted by that channel's agents.

How will I know where this agent is going to run?

While configuring an agent, check:

  1. Triggers to see:

    • Which schedules are active.

    • Which Notion databases or pages are watched.

    • Which Slack channels or other apps are connected.

  2. Access / Permissions to see:

    • Which pages, databases, and external sources the agent can use.

  3. Activity to see:

    • Where the agent has already run and what it did.

After you publish:

  • Use the Activity tab and logs to confirm agents are running only where expected.

  • Review runs regularly to keep behavior aligned with your workflows.

¿Todavía tienes preguntas? Contacta al equipo de soporte

Cuéntanos tu opinión

¿Te resultó útil este recurso?