Herramientas para desarrolladores

Grafana Cloud en tu producto y en tus agentes de IA, con una API

El toolkit de Grafana Cloud cubre los dashboards y las carpetas de un stack: leerlos, crearlos a partir de JSON y actualizarlos. Tu cliente conecta una vez con una API key, y tu producto o agente de IA llama cada operación a través de Connect, que guarda la credencial y registra cada ejecución.

15 días de prueba. Sin tarjeta de crédito.

POST https://connect.reportei.com/api/tools/grafana_create_dashboard/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "namespace": "<namespace>",
    "metadata": {},
    "spec": {}
  }
}
Ejemplo: la tool "Crear dashboard" en una cuenta conectada por tu cliente.

Cómo funciona

Del cliente conectado a la primera llamada a Grafana Cloud.

  1. 1

    Tu cliente conecta la cuenta

    Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Grafana Cloud. Recibes el id de la conexión.

  2. 2

    Tu producto llama a la tool

    Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.

  3. 3

    Connect se encarga del resto

    Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.

Casos de uso

Qué hace tu producto con Grafana Cloud.

  • Aprovisionar dashboards para clientes

    Al dar de alta a un cliente, crea una carpeta y un dashboard desde una plantilla JSON en su stack, para que el monitoreo esté listo desde el primer día.

  • Mantener dashboards sincronizados

    Lee un dashboard, cambia su spec y envíalo de vuelta con el resourceVersion, para que tu producto aplique cambios de paneles o variables con seguridad.

  • Descubrimiento de dashboards con agentes

    Deja que un agente de IA liste carpetas y dashboards, lea los paneles y el rango de tiempo de un dashboard y describa qué monitorea ya el stack.

Tools

7 tools de Grafana Cloud

Ver las 7 tools

Conexión

Cómo tu cliente conecta la cuenta

Documentación oficial de Grafana Cloud

Clave de API

Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.

Al conectar, tu cliente también indica {stack}: la dirección de su cuenta en la API de la app.

Preguntas sobre el toolkit de Grafana Cloud

¿Necesito implementar la API de Grafana Cloud?

No. Connect ya trae 7 tools de Grafana Cloud descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.

¿Cómo conecta mi cliente su cuenta de Grafana Cloud?

Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.

¿Funciona con agentes de IA?

Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.

¿Mi cliente necesita una cuenta en Reportei?

No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.

Toolkits de la misma categoría

Ver los 100 toolkits

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.