Referencia de herramientas

Estas son las herramientas que ve tu asistente una vez que Teramot está conectado. Rara vez vas a llamar a una por su nombre — pedí lo que necesitás en lenguaje natural y el asistente elige la herramienta — pero conocerlas te ayuda a entender qué puede hacer y qué te va a pedir que apruebes.

En cada herramienta:

• Las herramientas de Solo lectura solo miran tus datos.
• Las herramientas que Hace cambios crean o cambian algo, sin destruir nada.
• Las herramientas que Puede borrar o sobrescribir pueden quitar algo o reemplazar su contenido.
• Las herramientas que Sale de Teramot se conectan con algo fuera de Teramot: leen un sitio web o mandan tus datos a las personas o servicios que indiques.

Rol mínimo es el rol que necesitás en el espacio de trabajo o proyecto sobre el que actúa la herramienta (mirá Permisos). Varios nombres de herramientas contienen la palabra gold: es el nombre fijo de la herramienta, y se refiere a las tablas de resultados.

Espacios de trabajo y sesión

list_workspaces

List Workspaces · Solo lectura

Lista los espacios de trabajo de los que sos miembro, con sus nombres e ids. Rol mínimo: cualquiera.

create_workspace

Create a Workspace · Hace cambios

Crea un espacio de trabajo nuevo, con vos como propietario. Rol mínimo: cualquier usuario con sesión iniciada, dentro del cupo de espacios de trabajo de tu plan.

delete_workspace

Delete a Workspace · Puede borrar o sobrescribir

Borra de forma permanente un espacio de trabajo y todo lo que contiene. El asistente primero muestra qué se borraría y te pide que confirmes. Rol mínimo: Propietario.

switch_context

Switch Active Workspace/Project · Hace cambios

Define el espacio de trabajo, y opcionalmente el proyecto, que usan por defecto los pedidos siguientes. No cambia nada en tus datos. Mirá Elegir o cambiar el espacio de trabajo y el proyecto. Rol mínimo: cualquiera.

Proyectos

list_projects

List Projects · Solo lectura

Lista los proyectos de un espacio de trabajo (o de todos tus espacios de trabajo). De cada uno: cuántas tablas de origen tiene y cuántas de ellas están procesadas, en construcción, fallidas o nunca ingeridas (una tabla que no seleccionaste para cargar cuenta como nunca ingerida); cuántas tablas de resultados tiene y su estado; cuántas fuentes; y cuándo se refrescó por última vez. Las tablas que otros proyectos le comparten se cuentan aparte, así que un proyecto que solo usa tablas compartidas no aparece como vacío. Rol mínimo: Solo lectura.

create_project

Create a Project · Hace cambios

Crea un proyecto en un espacio de trabajo. Rol mínimo: Administrador.

delete_project

Delete a Project · Puede borrar o sobrescribir

Borra de forma permanente un proyecto y todo lo que contiene, después de un paso de confirmación. Rol mínimo: Propietario.

review_project

Review a Project · Solo lectura

Un chequeo de salud de un proyecto en una sola llamada: cada fuente, sus tablas procesadas y de resultados, su estado y qué tan actualizadas están, más las tablas que otros proyectos le comparten y qué proyecto comparte cada una. Rol mínimo: Solo lectura.

project_knowledge

View Project Knowledge · Solo lectura

Lee el documento de conocimiento del proyecto — las notas compartidas sobre qué significan los datos — con el del espacio de trabajo antes. Mirá Conocimiento. Rol mínimo: Solo lectura.

update_project_knowledge

Edit Project Knowledge · Puede borrar o sobrescribir

Crea, edita o borra el documento de conocimiento del proyecto. Todos en el proyecto ven el cambio. Rol mínimo: Analista.

Tablas y consultas

explore_tables

Explore Tables · Solo lectura

Lista las tablas de un proyecto, o muestra una tabla en detalle: sus columnas, cómo se construyó, su estado, de dónde vienen sus datos y cualquier hallazgo de calidad de datos. Incluye las tablas que otros proyectos le comparten, marcadas con el proyecto que las comparte; sus columnas y datos están disponibles acá, mientras que cómo se construyeron y su estado solo se ven en ese proyecto. Mirá Compartir Datos. Rol mínimo: Solo lectura.

preview_table

Preview a Table · Solo lectura

Muestra las primeras 100 filas y las columnas de una tabla. Rol mínimo: Solo lectura.

query_data

Run a SQL Query · Solo lectura

Ejecuta una consulta SQL de solo lectura sobre las tablas del proyecto y devuelve hasta 100 filas por página (como máximo 500 por consulta). Nombrá las columnas que necesitás: SELECT * se rechaza. Una consulta que tarda más que una respuesta sigue corriendo unos minutos mientras el asistente la espera; si aun así no termina, conviene armarla como tabla de resultados. Rol mínimo: Solo lectura.

sql_tool

Run a Results-Table Query · Solo lectura

Prueba la consulta a partir de la cual se construiría una tabla de resultados nueva y devuelve sus primeras filas y los tipos de columna, sin crear nada. Rol mínimo: Solo lectura.

refresh_tables

Refresh Table Data · Hace cambios

Vuelve a ejecutar una tabla de resultados, o todas las tablas del proyecto, para tomar datos nuevos de las fuentes. No se destruye nada: cada ejecución genera una revisión nueva. Rol mínimo: Administrador.

revise_silver_query

Revise a Processed Table’s SQL · Puede borrar o sobrescribir

Corrige la consulta de limpieza de una tabla procesada: el asistente valida el cambio y te lo muestra. Si el asistente confía en la corrección, no elimina ninguna columna y Teramot verifica que no rompe ninguna de las tablas construidas sobre esta, la aplica — y refresca la tabla — de inmediato. Si no, solo la aplica cuando confirmás, y el asistente te dice qué tablas se romperían, con qué columnas y por qué. En una tabla grande, validar o aplicar puede tardar más de lo que un asistente espera la respuesta de una herramienta: el asistente te avisa que sigue en curso y vuelve a revisar más tarde, sin enviar la corrección dos veces. Rol mínimo: Administrador.

Tablas de resultados

create_gold_table

Create a Results Table · Hace cambios

Construye una tabla de resultados guardada a partir de una consulta SQL. La construcción corre en segundo plano y suele tardar unos minutos. Rol mínimo: Analista.

update_gold_table

Edit a Results Table · Puede borrar o sobrescribir

Cambia lo que calcula una tabla de resultados: el asistente escribe el SQL nuevo de la tabla, lo ejecuta para comprobar el resultado y lo envía con la lista completa de tablas que lee. La tabla se reconstruye a partir de ese SQL y conserva su nombre y los tableros construidos sobre ella. Se rechaza un SQL que lee una tabla que la lista no incluye, o una fuente que ya lee de la tabla, directamente o a través de otras tablas de resultados. Si el SQL nuevo quita columnas que un tablero, una alerta o una presentación todavía usa, no se cambia nada: el asistente te dice cuáles dejarían de funcionar y qué columnas les faltan, y aplica el cambio solo si lo confirmás; después, esos tableros y alertas necesitan que sus consultas pasen a usar las columnas nuevas. Rol mínimo: Analista.

duplicate_gold_table

Duplicate a Results Table · Hace cambios

Copia una tabla de resultados en un borrador nuevo que podés modificar. Rol mínimo: Analista.

delete_gold_table

Delete a Results Table · Puede borrar o sobrescribir

Borra de forma permanente una tabla de resultados, después de un paso de confirmación. Los dashboards construidos sobre ella también se borran; la confirmación nombra además las presentaciones que la leen, que quedan pero no se pueden renderizar hasta que la tabla vuelva a existir. Rol mínimo: Analista.

get_gold_table_download_link

Download a Results Table · Solo lectura

Devuelve un link para descargar una tabla de resultados como CSV. Un link privado (el predeterminado) funciona durante 10 minutos y solo para tu cuenta; un link público funciona durante 15 minutos para cualquiera que lo tenga. Rol mínimo: Solo lectura.

Dashboards

dashboard_authoring_guide

Dashboard Authoring Guide · Solo lectura

Le da al asistente las reglas para escribir un dashboard de Teramot. Rol mínimo: cualquiera.

list_dashboards

List Dashboards · Solo lectura

Lista los dashboards guardados del proyecto que tenés permitido ver, cada uno con un link que lo abre en Teramot. Rol mínimo: Solo lectura.

get_dashboard

Get a Dashboard · Solo lectura

Devuelve un dashboard completo, con un link que lo abre en Teramot. Con un número de versión, devuelve en cambio lo que mostraba esa versión anterior. Rol mínimo: Solo lectura.

list_dashboard_versions

List a Dashboard’s Versions · Solo lectura

Lista las versiones de un dashboard, de la más nueva a la más vieja: cuándo se guardó cada una, por qué (creado, editado o restaurado) y cuál muestra ahora. Rol mínimo: Solo lectura.

preview_dashboard

Preview a Dashboard · Solo lectura

Muestra un dashboard en el chat sin guardarlo, para que puedas revisarlo primero. Rol mínimo: Solo lectura.

save_dashboard

Create Dashboard · Hace cambios

Guarda un dashboard nuevo en el proyecto, construido sobre una o más tablas de resultados, y devuelve un link que lo abre en Teramot. Primero corre su consulta: si falla, no se guarda nada y el asistente recibe el error para corregirlo. Rol mínimo: Analista.

update_dashboard

Edit a Dashboard · Puede borrar o sobrescribir

Reemplaza el título, el contenido, la consulta de un dashboard o el rol mínimo que puede verlo. Una consulta nueva que falla se rechaza y el dashboard queda como estaba. Cada cambio en lo que muestra el dashboard se guarda como una versión que podés restaurar. Rol mínimo: Analista.

restore_dashboard_version

Restore a Dashboard Version · Hace cambios

Trae de vuelta una versión anterior de un dashboard, guardada como su versión más nueva, así la que reemplaza también se puede restaurar. Una versión cuya consulta ya no corre, por ejemplo porque cambiaron las columnas de su tabla de resultados, se rechaza y no cambia nada. Rol mínimo: Analista.

delete_dashboard

Delete a Dashboard · Puede borrar o sobrescribir

Borra un dashboard. Cualquiera que tuviera su link pierde el acceso. Rol mínimo: Administrador.

Presentaciones

Las presentaciones son decks e informes que se vuelven a renderizar para un mes o con los datos tal como están hoy. Los nombres de las herramientas dicen studio: es su nombre fijo.

studio_authoring_guide

Presentations Authoring Guide · Solo lectura

Le da al asistente las reglas para escribir una presentación: los bloques de página, los gráficos, cómo una consulta nombra el mes, qué imprime un mes sin datos, cómo se validan sus frases (cada número, en cifras o en palabras y con su unidad, y cada mes que nombran) y cómo se mueven las páginas. Rol mínimo: cualquiera.

studio_render_document

Render a Draft Presentation · Solo lectura

Renderiza una presentación sin guardarla, para un mes o, cuando sus consultas no nombran ninguno, con los datos tal como están hoy. Devuelve un link para verla, el PDF, una imagen de cada página y las páginas cuyo contenido no entra. Rol mínimo: Solo lectura.

studio_list_documents

List Presentations · Solo lectura

Lista las presentaciones del proyecto que tenés permitido ver. Rol mínimo: Solo lectura.

studio_get_document

Get a Presentation · Solo lectura

Devuelve una presentación con su versión actual: sus páginas, consultas y frases. Rol mínimo: Solo lectura.

studio_save_document

Save a Presentation · Hace cambios

Guarda una presentación nueva en el proyecto, dentro de lo que permite tu plan. Rol mínimo: Analista.

studio_save_version

Save a New Version of a Presentation · Hace cambios

Guarda contenido nuevo para una presentación como su próxima versión; las anteriores se conservan. Rol mínimo: Analista.

studio_update_document

Update a Presentation’s Settings · Hace cambios

Cambia el título, el estado o el rol mínimo que puede ver una presentación. Rol mínimo: Analista.

studio_refresh_document

Render a Saved Presentation · Solo lectura

Renderiza una presentación guardada, como Renderizar o Generar en la app: para un mes, o con los datos tal como están hoy cuando sus consultas no nombran ninguno, con las mismas imágenes y verificaciones. Rol mínimo: Analista.

studio_delete_document

Delete a Presentation · Puede borrar o sobrescribir

Borra una presentación y sus versiones. Rol mínimo: Administrador.

studio_get_brand

Get the Client Studio Brand · Solo lectura

Lee la marca con la que se imprimen las presentaciones del workspace: sus colores, tipografías, línea al pie y si tiene logo. Los campos vacíos mantienen el estilo de Teramot. Rol mínimo: Solo lectura.

studio_set_brand

Set the Client Studio Brand · Hace cambios

Define la marca con la que se imprimen todas las presentaciones del workspace: el logo del cliente, hasta cuatro colores, los archivos de las tipografías del cliente y las tipografías que los usan, y una línea al pie. Cada página mantiene el logo de Teramot, con el del cliente al lado. Rol mínimo: Administrador.

studio_brand_from_site

Propose the Client Studio Brand From a Website · Sale de Teramot

Lee el sitio web del cliente y propone su marca: los colores, las tipografías de títulos y texto, y el logo, cada uno con dónde se encontró. No se guarda nada hasta que confirmás la propuesta. Las tipografías abiertas, como las de Google Fonts, se toman con sus archivos; las que el sitio aloja por su cuenta, solo cuando confirmás que el cliente tiene la licencia; las de Adobe Fonts o Monotype nunca, así que el asistente te pide los archivos de las tipografías del cliente. Rol mínimo: Administrador.

Alertas

Una alerta es una consulta que Teramot ejecuta por su cuenta y te envía por email (o publica en Slack) cuando el resultado vale la pena. Tiene uno de tres modos:

• Resumen envía el resultado a una hora fija, por ejemplo todas las mañanas.
• Incidente envía solo las filas nuevas, o las que siguen apareciendo pasado un período de espera, y puede avisarte cuando una fila deja de aparecer.
• Umbral vigila un número contra un límite y puede avisarte cuando vuelve.

Una alerta se revisa cuando termina de actualizarse una tabla que lee, o a su hora programada. Tu plan puede limitar cuántas alertas tiene un espacio de trabajo y cada cuánto se revisa cada una.

list_alerts

List Alerts · Solo lectura

Lista las alertas del proyecto: la consulta de cada una, su modo, sus destinatarios y si está pausada. Para una alerta, devuelve también sus últimas revisiones — si se disparó, qué encontró y, para cada destinatario, si el mensaje salió o por qué no (por ejemplo, porque sigue en su período de espera). Rol mínimo: Solo lectura.

set_alert

Save Alert · Sale de Teramot

Crea una alerta, reemplaza una (conservando su historial), o la pausa y la reanuda. Los destinatarios no necesitan una cuenta de Teramot. El mensaje puede llevar tus propias palabras — una descripción, una frase de apertura, un pie — y usar el formato tarjeta: un encabezado de color con el nombre de la alerta, las tablas, el id y la prioridad de la alerta. La prioridad (baja, media, alta o crítica) la elegís vos y, si no elegís un color, también define el del encabezado. Un resumen puede mostrar varias tablas, cada una de su propia consulta y adjunta como su propio CSV, y el CSV puede traer más filas que las que muestra el mensaje. Cambiar una alerta conserva su webhook de Slack y su fecha de revisión, salvo que los reemplaces o los quites. Un asistente que admite confirmaciones te pide que lo apruebes antes. Rol mínimo: Analista.

test_alert

Test Alert · Sale de Teramot

Prueba una alerta y dice si se dispararía, cuántas filas encontró y una muestra, sin enviar nada. Si le pedís que la ejecute de verdad, revisa la alerta como lo haría una actualización y envía el mensaje si la alerta lo decide, y por eso un asistente que admite confirmaciones te pide que lo apruebes antes. Una prueba espera una sola vez, menos de lo que query_data puede esperar una consulta, así que conviene que una alerta sobre una consulta pesada lea de una tabla de resultados. Rol mínimo: Analista.

remove_alert

Remove Alert · Puede borrar o sobrescribir

Quita una alerta, así sus destinatarios dejan de recibirla. Sus revisiones anteriores se conservan. El asistente te pide confirmación antes. Rol mínimo: Administrador.

Documentación

search_docs

Search Teramot Documentation · Solo lectura

Busca en esta documentación y devuelve las secciones más relevantes, cada una con un link a su página, para que el asistente pueda responder preguntas sobre cómo usar Teramot — dónde está un botón, qué necesita un conector, qué significa un error. Entiende preguntas en inglés o en español; para español, cada botón se da también con el nombre en español que muestra la app. Rol mínimo: cualquiera.