Administra agentes personalizados con la Admin API
Aprende cómo los admin de Enterprise pueden usar la Admin API para gestionar agentes personalizados, realizar un seguimiento del uso de créditos y aplicar controles en todo el espacio de trabajo.
Ir a las preguntas frecuentesSi eres admin en el plan Enterprise, puedes administrar los Custom Agents en tu espacio de trabajo con la Admin API. En lugar de hacer un clic en la configuración de cada agente, tu equipo puede incorporar información sobre los agentes y su uso a sus propias herramientas y aplicar las mismas reglas a muchos agentes a la vez. La Admin API solo está disponible para admins de organizaciones Enterprise que utilicen un token de admin propiedad de la organización.
Ve todos los Custom Agents en tu espacio de trabajo. Obtén una lista de todos los agentes, incluyendo quién creó cada uno, si está activo, qué modelo utiliza, cuándo se ejecutó por última vez y a qué tiene acceso.
Realiza un seguimiento de quién tiene acceso a un Custom Agent. Actualiza los permisos de un agente.
Realiza un seguimiento del uso de créditos. Observa cuántos créditos ha usado cada agente y realiza un seguimiento del uso de créditos en conjunto.
Establece límites de crédito. Establece o cambia el límite de crédito para un solo agente, o establece el /predeterminado de tu espacio de trabajo para todos los Custom Agents.
Elige quién puede crear agentes. Establece la política de creación de agentes en tu espacio de trabajo y pausa todos los agentes en él si lo necesitas.
Enciende o apaga un agente. Detén la ejecución de un agente específico sin eliminar su configuración y vuelve a encenderlo más tarde.
/eliminar un agente. Elimina un agente de uso. Su configuración se conserva para que pueda recuperarse si es necesario.
El espacio de trabajo debe pertenecer a un plan Enterprise.
La Admin API utiliza acceso de admin a nivel de organización que tu organización configura, no tokens de integración personales. Para conocer los pasos de configuración, consulta la documentación para desarrolladores →
Todo lo que hace la Admin API tiene un control correspondiente en Notion:
El directorio de agentes (
Configuración→Notion AI→Agentes) muestra y administra los agentes en tu espacio de trabajo.El panel de control de créditos de Notion muestra el uso de créditos de los agentes.
Los controles de creación establecen quién puede crear agentes.
Utiliza Configuración para cambios únicos. Usa la API de admin cuando quieras automatizar estas tareas, administrar muchos agentes a la vez o incorporar datos de uso a tus propias herramientas de informes.
Incorpora el uso de créditos en los informes internos, para que cada equipo pueda ver cuánto cuestan sus Agentes personalizados.
Aplica los mismos límites o reglas a muchos agentes a la vez.
Transfiere la propiedad de los agentes que deben continuar. Apaga o elimina los agentes que ya no necesites.
Preguntas frecuentes
¿La API de admin aparece en el registro de auditoría?
¿La API de admin aparece en el registro de auditoría?
Los cambios realizados a través de la API de admin se atribuyen al acceso de admin de tu organización, por lo que puedes hacer seguimiento de lo que cambió y cuándo. Descubre más sobre los registros de auditoría →
¿Dónde puedo encontrar la referencia completa de la API?
¿Dónde puedo encontrar la referencia completa de la API?
La referencia completa, incluidos los pasos de configuración, se encuentra en la documentación para desarrolladores →
