Referencia de herramientas MCP
Última actualización · Ver como markdown
Su asistente de IA selecciona estas herramientas por usted, para que no tenga que llamarlas manualmente. Utilice esta página para ver qué puede hacer el asistente y comprobar su trabajo. Para la configuración, consulte Servidor AMMP MCP.
ID y nombres
AMMP utiliza identificadores cortos (UID) que comienzan con una letra para el tipo: O para organizaciones, G para grupos de activos, A para activos (sitios) y D para dispositivos, por ejemplo D3N1P6RWM0. La mayoría de las herramientas también aceptan el nombre de un sitio y lo reconocen aunque no esté escrito con exactitud.
Las horas utilizan ISO 8601 con un desfase UTC, como 2026-10-01T00:00:00Z.
Buscar organizaciones, plantas y dispositivos
| Herramienta | Qué devuelve |
|---|---|
list_orgs | Organizaciones a las que puede acceder su cuenta, incluidas las suborganizaciones |
list_asset_groups | Grupos de activos, con búsqueda opcional por nombre |
list_assets | Sitios, filtrados por nombre o grupo, con ubicación, país y capacidad FV (kWp) |
get_asset_detail | Zona horaria, tipo de red, coordenadas, capacidad fotovoltaica, PR esperado, pérdidas modeladas, inclinación, azimut y etiquetas de un sitio |
list_devices | Los inversores, medidores, baterías y grupos electrógenos de un sitio, con modelo, fabricante, número de serie, capacidad nominal y cuándo llegaron los datos por última vez |
list_edge_xnodes | Pasarelas de datos de terceros vinculadas a un sitio (los registradores de datos AMMP Edge no aparecen aquí) |
Series temporales, KPI y alertas
| Herramienta | Qué devuelve |
|---|---|
query_time_series | Datos de potencia, energía, batería o entorno para uno o más sitios o grupos |
get_kpis | KPIs para uno o más sitios o grupos (consulte los tipos de KPI a continuación) |
get_status | Estado actual de alertas, una fila por alerta |
query_device_data | Datos de un solo inversor, medidor, sistema de baterías o grupo electrógeno, con una resolución de 5 o 15 minutos |
Intervalos de tiempo para query_time_series:
| Tipo de métrica | Intervalos disponibles |
|---|---|
power | 15 minutos, 1 hora |
energy | 1 hora, 1 día, 1 mes o automático |
battery | 15 minutos, 1 hora |
environment | 5 minutos, 15 minutos, 1 hora, 1 día o automático |
Tipos de KPI para get_kpis:
| Tipo de KPI | Contenido |
|---|---|
pv_performance | Rendimiento que incluye la potencia o energía FV esperada, según la corrección meteorológica del sitio y las pérdidas modeladas |
pv_yield_losses | Tiempo de inactividad de la red y de la planta, y la energía perdida en cada caso |
loss_waterfall | Pérdidas divididas en tiempo de inactividad, pérdidas por inversor, clipping, suciedad y curtailment, con la categoría principal de pérdida por período |
financial_impact | Resultados financieros por hora, día o mes |
environmental_impact | Impacto ambiental por periodo |
time_of_operation | Tiempo de funcionamiento diario |
Las solicitudes para muchos sitios se ejecutan en páginas de 100 sitios, por lo que una pregunta sobre una cartera completa requiere varias idas y vueltas. Si algunos sitios fallan, los demás siguen devolviendo resultados y los fallos se muestran como advertencias.
Datos sin procesar del dispositivo
| Herramienta | Qué hace |
|---|---|
raw_data_schema | Enumera los campos sin procesar disponibles para los dispositivos de un sitio. El asistente llama a esto primero. |
query_raw_data | Devuelve valores brutos o agregados para los campos y dispositivos seleccionados |
influx_query | Ejecuta una consulta InfluxQL avanzada para una organización, para casos que las herramientas anteriores no cubren |
Los datos sin procesar se presentan en dos esquemas de nomenclatura: standard, el modelo de datos de AMMP que es el mismo para todos los proveedores, y source, los nombres de campo utilizados por el propio sistema del proveedor del dispositivo.
Acceso a la Data API
| Herramienta | Qué hace |
|---|---|
list_endpoints | Enumera todos los endpoints de la AMMP Data API |
query_endpoint | Llama directamente a cualquier endpoint de lectura (GET) de Data API |
Resultados y exportaciones
Los resultados de las tablas pueden presentarse de varias formas. El asistente suele elegir una, pero puedes solicitar una específica.
| Modo | Comportamiento |
|---|---|
auto (predeterminado) | Los resultados pequeños se muestran al completo; los grandes se almacenan y se devuelven como un resumen con filas de muestra |
preview | Solo nombres de columnas y algunas filas de muestra |
reference | Siempre almacena el resultado y devuelve su ID |
inline | Devuelve todas las filas, hasta un límite de tamaño |
download | Devuelve un enlace temporal de descarga de CSV o Parquet |
persist_result convierte un resultado almacenado en un enlace de descarga CSV o Parquet. Los resultados almacenados y los enlaces de descarga son temporales.
Nota
Todas las herramientas son de solo lectura y solo devuelven datos que su cuenta de AMMP tiene permiso para ver.