Herramientas para desarrolladores
Sentry en tu producto y en tus agentes de IA, con una API
El toolkit de Sentry cubre organizaciones, proyectos, issues y eventos de error con stack trace, etiquetas y contexto. 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/sentry_list_organizations/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": "<query>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Sentry.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Sentry. Recibes el id de la conexión.
- 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
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 Sentry.
Mostrar errores dentro de tu producto
Lista las issues sin resolver de un cliente con conteo de eventos y usuarios para que tu SaaS muestre qué se está rompiendo, junto a la app monitoreada.
Cerrar el ciclo desde tu tracker
Resuelve, archiva o asigna una issue de Sentry cuando el ticket correspondiente cambia de estado en tu producto.
Triaje con un agente de IA
Deja que un agente lea una issue, traiga el evento más reciente con el stack trace y los valores de etiqueta más frecuentes y proponga quién debería revisarla.
Tools
11 tools de Sentry
- Listar organizacionesGETLista las organizaciones a las que llega el token en esta ubicación de almacenamiento de datos, cada una con id, slug y name. El slug es el organization_id_or_slug que piden las demás herramientas. Devuelve hasta 100.
- Listar proyectosGETLista los proyectos de una organización, cada uno con id, slug, name y platform. El slug es el project_id_or_slug que piden las herramientas de proyecto. Devuelve hasta 100; afina con query.
- Obtener proyectoGETDevuelve un proyecto con name, platform, equipos, estado y ajustes.
- Listar issuesGETLista las issues de una organización, por defecto las no resueltas ordenadas por última aparición. Cada issue trae id, shortId, title, status, level, conteo de eventos, conteo de usuarios, primera y última aparición y proyecto. Devuelve hasta 100; afina con query, project y statsPeriod.
- Obtener issueGETDevuelve una issue con title, culprit, status, level, responsable, conteos, primera y última aparición, release y principales etiquetas.
- Actualizar issuePUTResuelve, archiva, reabre, asigna o cambia la prioridad de una issue. Solo cambian los campos enviados. Para archivar, envía status ignored con un substatus, y la condición en statusDetails cuando sea archived_until_condition_met.
- Listar eventos de la issueGETLista los eventos de una issue, 100 por página. Con full true cada evento trae el stack trace, y la página baja a 10.
- Obtener evento de la issueGETDevuelve un evento de una issue con stack trace, etiquetas, contexto, breadcrumbs y request. Usa latest, oldest o recommended como event_id cuando no tengas un id de evento.
- Obtener etiqueta de la issueGETDevuelve los valores más frecuentes de una etiqueta en los eventos de una issue, con el conteo de cada uno, como los navegadores o releases afectados.
- Listar eventos del proyectoGETLista los eventos de error de un proyecto, 100 por página. Con full true cada evento trae el stack trace, y la página baja a 10.
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 {region}: la dirección de su cuenta en la API de la app.
Preguntas sobre el toolkit de Sentry
¿Necesito implementar la API de Sentry?
No. Connect ya trae 11 tools de Sentry 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 Sentry?
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 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
