Herramientas para desarrolladores
GitLab en tu producto y en tus agentes de IA, con una API
El toolkit de GitLab cubre proyectos y sus miembros, issues con comentarios y merge requests, incluido abrirlas y fusionarlas. Con Connect, un producto o agente de IA trabaja en los repositorios del cliente en GitLab.com sin construir la integración ni renovar tokens.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/gitlab_create_issue/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"id": "<id>",
"title": "<title>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a GitLab.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de GitLab. 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 GitLab.
Issues desde tu producto
Crea una issue en GitLab a partir de un reporte de bug o ticket de soporte de tu app, asígnala con el id de un miembro y mantenla al día con los comentarios posteriores.
Agentes de código abriendo merge requests
Deja que un agente de IA abra una merge request de source_branch a target_branch y revise detailed_merge_status antes de fusionar.
Estado del proyecto para otros equipos
Lee las issues y merge requests abiertas de cada proyecto y muestra el avance a quienes no usan GitLab.
Tools
13 tools de GitLab
- Listar proyectosGETLista proyectos, del más nuevo al más antiguo. Envía membership true para obtener solo los proyectos de la cuenta: sin eso, GitLab.com devuelve todos los proyectos públicos. Cada elemento tiene id y path_with_namespace, que las demás herramientas aceptan como project. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Listar miembros del proyectoGETLista los miembros de un proyecto, incluidos los heredados de sus grupos. Cada elemento tiene id, username y name: el id es lo que piden assignee_ids y reviewer_ids. Pagina con page y per_page.
- Listar issuesGETLista las issues de todos los proyectos que la cuenta puede ver. Por defecto, solo las issues que creó la cuenta: envía scope assigned_to_me o all para las demás. Cada elemento tiene project_id e iid, que piden las herramientas de issues. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Listar issues del proyectoGETLista las issues de un proyecto, de la más nueva a la más antigua. Cada elemento tiene iid, el número de la issue en el proyecto, que piden las herramientas de issues. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Obtener issueGETDevuelve una issue de un proyecto, con title, description, state, labels, assignees, milestone y due date.
- Crear issuePOSTCrea una issue en un proyecto y la devuelve, con su iid. Notifica a los participantes.
- Actualizar issuePUTModifica una issue y la devuelve. Solo cambian los campos enviados, y debe enviarse al menos uno. Para cerrarla o reabrirla, envía state_event. labels reemplaza todas las etiquetas; add_labels y remove_labels cambian solo las nombradas.
- Listar notas de la issueGETLista los comentarios (notes) de una issue, del más nuevo al más antiguo por defecto, incluidas las notas que GitLab escribe en cada cambio. Envía activity_filter only_comments para quedarte solo con lo que escribieron las personas. Pagina con page y per_page.
- Crear nota en la issuePOSTAgrega un comentario (note) a una issue y lo devuelve. Notifica a los participantes.
- Listar merge requestsGETLista las merge requests de un proyecto, de la más nueva a la más antigua. Cada elemento tiene iid, que piden las herramientas de merge requests. Pagina con page y per_page: una página con menos elementos que per_page es la última.
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.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/gitlab, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de GitLab
¿Necesito implementar la API de GitLab?
No. Connect ya trae 13 tools de GitLab 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 GitLab?
Con el modo que acepta el toolkit: Clave de API, OAuth con la app de tu producto. 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.
