MCP tools del agente
El agente expone estas herramientas al asistente de escritorio que elegiste, vía MCP. Esa app decide cuál usar según tu pregunta. Tú no las invocas directamente. Todas son solo SELECT y respetan la política de tu organización (lista permitida, límites de tasa, máximo de filas).
list_tables
Lista las tablas que el agente puede ver, filtradas por la lista permitida de la política. El asistente la usa al inicio de una conversación nueva para entender qué hay disponible.
Ejemplo: "¿Qué tablas de SAP están disponibles?"
describe_table
Devuelve columnas, tipos y relaciones de una tabla. El asistente la usa para entender la estructura antes de armar una consulta.
Ejemplo: "¿Qué campos tiene la tabla OINV?"
query
Ejecuta un SELECT contra una tabla del allowlist. Tiene rate limit (queries/min) y max-rows configurables por la policy. Si el SELECT excede el límite, devuelve sample + un mensaje.
Ejemplo: "Top 5 facturas de venta de este mes"
sample_data
Devuelve las primeras N filas de una tabla. Sirve para que el asistente entienda el formato real de los datos antes de pedir más.
Ejemplo: "Muéstrame ejemplos de OITM"
count_rows
Cuenta filas con un WHERE opcional. Más eficiente que query cuando solo quieres un número.
Ejemplo: "¿Cuántos clientes activos hay?"
search_columns
Busca columnas por nombre o tipo en todas las tablas allowlisteadas. Útil cuando no sabes en qué tabla vive un dato.
Ejemplo: "¿Dónde guarda SAP el CUIT del cliente?"
get_table_relationships
Devuelve las llaves foráneas entre tablas. El asistente las usa para encadenar joins.
Ejemplo: "¿Cómo se relacionan OINV y OCRD?"
Cómo el agente respeta tu policy
Antes de ejecutar cualquier tool, el agente lee la policy de tu organización del cache local (refrescado a cada heartbeat). Si una tabla no está en el allowlist, list_tables y describe_table la excluyen y query la rechaza.