mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
802368c3e2
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
816 lines
32 KiB
JSON
816 lines
32 KiB
JSON
{
|
|
"openapi": "3.0.1",
|
|
"info": {
|
|
"title": "Mintlify Admin API",
|
|
"description": "Una API de operaciones administrativas, incluidas las actualizaciones de documentación y la gestión de agentes.",
|
|
"version": "2.0.0"
|
|
},
|
|
"servers": [
|
|
{
|
|
"url": "https://api.mintlify.com"
|
|
}
|
|
],
|
|
"security": [
|
|
{
|
|
"bearerAuth": []
|
|
}
|
|
],
|
|
"paths": {
|
|
"/v1/deslop/{projectId}": {
|
|
"post": {
|
|
"summary": "Detectar prosa que suena a IA en una página",
|
|
"description": "Analiza una página en busca de prosa generada por IA y devuelve los pasajes marcados con reescrituras sugeridas. Consume un crédito de IA por página comprobada. Omite las páginas con menos de 50 palabras. Limitado a 30 solicitudes por minuto por dirección IP del cliente.",
|
|
"parameters": [
|
|
{
|
|
"name": "projectId",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": { "type": "string" },
|
|
"description": "El ID de tu proyecto. Se puede copiar desde la página de [claves de API](https://app.mintlify.com/settings/organization/api-keys) en tu panel de control."
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"required": ["path", "content"],
|
|
"properties": {
|
|
"path": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"description": "Ruta de la página relativa al repositorio, utilizada solo para informes."
|
|
},
|
|
"content": {
|
|
"type": "string",
|
|
"maxLength": 1000000,
|
|
"description": "El contenido MDX o Markdown sin procesar de la página que se va a comprobar."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "La página se comprobó, o se omitió porque era demasiado corta.",
|
|
"content": {
|
|
"application/json": { "schema": { "$ref": "#/components/schemas/DeslopResult" } }
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Cuerpo de la solicitud no válido.",
|
|
"content": {
|
|
"application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
|
|
}
|
|
},
|
|
"402": {
|
|
"description": "Créditos de IA insuficientes.",
|
|
"content": {
|
|
"application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
|
|
}
|
|
},
|
|
"429": {
|
|
"description": "Se ha superado el límite de tasa.",
|
|
"content": {
|
|
"text/plain": {
|
|
"schema": {
|
|
"type": "string",
|
|
"example": "Demasiadas solicitudes, inténtalo de nuevo más tarde."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"503": {
|
|
"description": "La detección no está disponible temporalmente. No se cobra ningún crédito.",
|
|
"content": {
|
|
"application/json": { "schema": { "$ref": "#/components/schemas/Error" } }
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Se produjo un error inesperado al procesar la página."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/v1/agent/{projectId}/job": {
|
|
"post": {
|
|
"summary": "Crear trabajo del agente (v1)",
|
|
"deprecated": true,
|
|
"description": "En desuso: usa [v2 create agent job](/api/agent/v2/create-agent-job) en su lugar. Crea un nuevo trabajo del agente que puede generar y editar documentación según los mensajes proporcionados y la información de la branch.\n\nAutentícate con una clave de API de administrador.",
|
|
"parameters": [
|
|
{
|
|
"name": "projectId",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El ID de tu proyecto. Se puede copiar desde la página de [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) en tu dashboard."
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"required": [
|
|
"messages"
|
|
],
|
|
"properties": {
|
|
"branch": {
|
|
"type": "string",
|
|
"description": "El nombre de la branch de Git en la que debe trabajar el agente. Si se omite, el agente genera un nombre de branch a partir del contenido del mensaje."
|
|
},
|
|
"messages": {
|
|
"type": "array",
|
|
"description": "Una lista de mensajes para proporcionar al agente. Siempre se antepone automáticamente un prompt del sistema predeterminado, por lo que normalmente solo necesitas incluir mensajes del usuario.",
|
|
"items": {
|
|
"type": "object",
|
|
"required": [
|
|
"role",
|
|
"content"
|
|
],
|
|
"properties": {
|
|
"role": {
|
|
"type": "string",
|
|
"enum": [
|
|
"system",
|
|
"user",
|
|
"assistant"
|
|
],
|
|
"description": "El rol del remitente del mensaje. Usa `user` para las instrucciones de la tarea. Usa `system` para agregar instrucciones complementarias que se añaden después del prompt del sistema predeterminado (no lo reemplaza). Usa `assistant` para proporcionar respuestas de ejemplo del assistant para el prompting de pocos ejemplos."
|
|
},
|
|
"content": {
|
|
"type": "string",
|
|
"description": "El contenido del mensaje."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"asDraft": {
|
|
"type": "boolean",
|
|
"default": false,
|
|
"description": "Controla si la solicitud de extracción se crea en modo borrador o en modo normal. Cuando es true, crea una solicitud de extracción en borrador. Cuando es false (predeterminado), crea una solicitud de extracción regular lista para revisión."
|
|
},
|
|
"model": {
|
|
"type": "string",
|
|
"enum": [
|
|
"sonnet",
|
|
"opus"
|
|
],
|
|
"default": "sonnet",
|
|
"description": "El modelo de IA que se usará para el trabajo del agente. Usa `sonnet` para un procesamiento más rápido y rentable. Usa `opus` para un procesamiento más capaz, pero más lento."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Tarea de agente creada correctamente. Devuelve una respuesta en streaming con Server-Sent Events.",
|
|
"headers": {
|
|
"X-Session-Id": {
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "Identificador único de sesión para la tarea de agente creada."
|
|
},
|
|
"X-Branch-Name": {
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "Nombre de la rama Git donde el agente realiza los cambios."
|
|
}
|
|
},
|
|
"content": {
|
|
"text/event-stream": {
|
|
"schema": {
|
|
"type": "string",
|
|
"description": "Flujo Server-Sent Events que contiene los detalles de ejecución y resultados de la tarea de agente."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/v1/agent/{projectId}/job/{id}": {
|
|
"get": {
|
|
"summary": "Obtener trabajo del agente por ID (v1)",
|
|
"deprecated": true,
|
|
"description": "En desuso: usa [v2 get agent job](/api/agent/v2/get-agent-job) en su lugar. Recupera los detalles y el estado de un trabajo del agente específico a partir de su ID.\n\nAutentícate con una clave de API de administrador.",
|
|
"parameters": [
|
|
{
|
|
"name": "projectId",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El ID de tu proyecto. Puedes copiarlo desde la página de [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) en tu dashboard."
|
|
},
|
|
{
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El identificador único del trabajo del agente que se va a recuperar."
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Detalles del trabajo del agente recuperados correctamente",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"sessionId": {
|
|
"type": "string",
|
|
"description": "El subdomain al que pertenece esta sesión."
|
|
},
|
|
"subdomain": {
|
|
"type": "string",
|
|
"description": "El subdomain al que pertenece esta sesión."
|
|
},
|
|
"branch": {
|
|
"type": "string",
|
|
"description": "Nombre de la branch de Git en la que se realizaron los cambios.",
|
|
"nullable": true
|
|
},
|
|
"haulted": {
|
|
"type": "boolean",
|
|
"description": "Indica si se detuvo la ejecución de la sesión."
|
|
},
|
|
"haultReason": {
|
|
"type": "string",
|
|
"enum": [
|
|
"completed",
|
|
"github_missconfigured",
|
|
"error",
|
|
"processing",
|
|
"interrupted"
|
|
],
|
|
"description": "Motivo de la interrupción de la sesión. `processing` indica que la tarea está en curso. `interrupted` indica que la tarea fue interrumpida manualmente."
|
|
},
|
|
"pullRequestLink": {
|
|
"type": "string",
|
|
"description": "Enlace a la solicitud de extracción creada."
|
|
},
|
|
"messageToUser": {
|
|
"type": "string",
|
|
"description": "Mensaje para el usuario sobre el resultado de la sesión."
|
|
},
|
|
"todos": {
|
|
"type": "array",
|
|
"description": "Lista de tareas pendientes de la sesión.",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"content": {
|
|
"type": "string",
|
|
"description": "Breve descripción de la tarea."
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [
|
|
"pending",
|
|
"in_progress",
|
|
"completed",
|
|
"cancelled"
|
|
],
|
|
"description": "Estado actual de la tarea."
|
|
},
|
|
"priority": {
|
|
"type": "string",
|
|
"enum": [
|
|
"high",
|
|
"medium",
|
|
"low"
|
|
],
|
|
"description": "Nivel de prioridad de la tarea."
|
|
},
|
|
"id": {
|
|
"type": "string",
|
|
"description": "Identificador único de la tarea pendiente."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"userId": {
|
|
"type": "string",
|
|
"description": "El ID del usuario que creó esta sesión, si está disponible."
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"description": "Título generado que resume el trabajo del agente."
|
|
},
|
|
"createdAt": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "Marca de tiempo de creación de la sesión."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/v1/agent/{projectId}/jobs": {
|
|
"get": {
|
|
"summary": "Obtener todos los trabajos del agente (v1)",
|
|
"deprecated": true,
|
|
"description": "En desuso: usa [v2 get agent job](/api/agent/v2/get-agent-job) en su lugar. Recupera todas las tareas del agente para el domain especificado, incluido su estado y sus detalles.\n\nAutentícate con una clave de API de administrador.",
|
|
"parameters": [
|
|
{
|
|
"name": "projectId",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El ID de tu proyecto. Puedes copiarlo desde la página de [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) en tu dashboard."
|
|
},
|
|
{
|
|
"name": "skip",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"default": 0
|
|
},
|
|
"description": "Número de resultados a omitir para la paginación."
|
|
},
|
|
{
|
|
"name": "take",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"maximum": 100,
|
|
"default": 12
|
|
},
|
|
"description": "Número de resultados a devolver. Máximo 100."
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Todos los trabajos del agente se recuperaron correctamente",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"allSessions": {
|
|
"type": "array",
|
|
"description": "Matriz de todas las sesiones del agente para el domain.",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"sessionId": {
|
|
"type": "string",
|
|
"description": "El subdomain al que pertenece esta sesión."
|
|
},
|
|
"subdomain": {
|
|
"type": "string",
|
|
"description": "El subdomain al que pertenece esta sesión."
|
|
},
|
|
"branch": {
|
|
"type": "string",
|
|
"description": "Nombre de la branch de Git en la que se realizaron los cambios",
|
|
"nullable": true
|
|
},
|
|
"haulted": {
|
|
"type": "boolean",
|
|
"description": "Indica si se detuvo la ejecución de la sesión."
|
|
},
|
|
"haultReason": {
|
|
"type": "string",
|
|
"enum": [
|
|
"completed",
|
|
"github_missconfigured",
|
|
"error",
|
|
"processing",
|
|
"interrupted"
|
|
],
|
|
"description": "Motivo de la interrupción de la sesión. `processing` indica que la tarea está en curso. `interrupted` indica que la tarea fue interrumpida manualmente."
|
|
},
|
|
"pullRequestLink": {
|
|
"type": "string",
|
|
"description": "Enlace a la solicitud de extracción creada."
|
|
},
|
|
"messageToUser": {
|
|
"type": "string",
|
|
"description": "Mensaje para el usuario sobre el resultado de la sesión."
|
|
},
|
|
"todos": {
|
|
"type": "array",
|
|
"description": "Lista de tareas pendientes de la sesión.",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"content": {
|
|
"type": "string",
|
|
"description": "Breve descripción de la tarea."
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [
|
|
"pending",
|
|
"in_progress",
|
|
"completed",
|
|
"cancelled"
|
|
],
|
|
"description": "Estado actual de la tarea."
|
|
},
|
|
"priority": {
|
|
"type": "string",
|
|
"enum": [
|
|
"high",
|
|
"medium",
|
|
"low"
|
|
],
|
|
"description": "Nivel de prioridad de la tarea."
|
|
},
|
|
"id": {
|
|
"type": "string",
|
|
"description": "Identificador único de la tarea pendiente."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"userId": {
|
|
"type": "string",
|
|
"description": "El ID del usuario que creó esta sesión, si está disponible."
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"description": "Título generado que resume el trabajo del agente."
|
|
},
|
|
"createdAt": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "marca de tiempo de creación de la sesión."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/v2/agent/{projectId}/job": {
|
|
"post": {
|
|
"summary": "Crear trabajo del agente",
|
|
"description": "Crea un nuevo trabajo del agente que se ejecuta en segundo plano. El trabajo procesa el prompt de forma asíncrona; consulta periódicamente el endpoint get job para seguir el progreso. Si el agente edita archivos correctamente, se crea automáticamente una solicitud de extracción.\n\nAutentícate con una clave de API de administrador.",
|
|
"parameters": [
|
|
{
|
|
"name": "projectId",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El ID de tu proyecto. Puedes copiarlo desde la página de [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) en tu dashboard."
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"required": [
|
|
"prompt"
|
|
],
|
|
"properties": {
|
|
"prompt": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"description": "La instrucción que debe ejecutar el agente."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"201": {
|
|
"description": "Trabajo del agente creado correctamente",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/AgentJob"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Solicitud no válida",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Error"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"429": {
|
|
"description": "superar el límite de solicitudes",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Error"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/v2/agent/{projectId}/job/{id}": {
|
|
"get": {
|
|
"summary": "Obtener trabajo del agente",
|
|
"description": "Recupera el estado actual y los detalles de un trabajo del agente. Consulta este endpoint para seguir el progreso del trabajo.\n\nAutentícate con una clave de API de administrador.",
|
|
"parameters": [
|
|
{
|
|
"name": "projectId",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El ID de tu proyecto. Puedes copiarlo desde la página de [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) en tu dashboard."
|
|
},
|
|
{
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El identificador único del trabajo del agente."
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Detalles del trabajo del agente",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/AgentJob"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Trabajo no encontrado",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Error"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/v2/agent/{projectId}/job/{id}/message": {
|
|
"post": {
|
|
"summary": "Enviar mensaje de seguimiento",
|
|
"description": "Envía un mensaje de seguimiento a un trabajo del agente existente. El mensaje se procesa de forma asíncrona: consulta periódicamente el endpoint get job para seguir el progreso.\n\nAutentícate con una clave de API de administrador.",
|
|
"parameters": [
|
|
{
|
|
"name": "projectId",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El ID de tu proyecto. Puedes copiarlo desde la página de [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard."
|
|
},
|
|
{
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"description": "El identificador único del trabajo del agente al que se enviará un mensaje."
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"type": "object",
|
|
"required": [
|
|
"prompt"
|
|
],
|
|
"properties": {
|
|
"prompt": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"description": "La instrucción de seguimiento para el agente."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Mensaje enviado correctamente",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/AgentJob"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Solicitud no válida",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Error"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Trabajo no encontrado",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Error"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"429": {
|
|
"description": "Se superó el límite de solicitudes",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Error"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"components": {
|
|
"schemas": {
|
|
"DeslopResult": {
|
|
"type": "object",
|
|
"required": ["path", "skipped", "creditsCharged"],
|
|
"properties": {
|
|
"path": { "type": "string", "description": "La ruta proveniente de la solicitud." },
|
|
"skipped": {
|
|
"type": "string",
|
|
"nullable": true,
|
|
"enum": ["too_short", null],
|
|
"description": "Motivo por el que se omitió la página, o null cuando la página se comprobó. `too_short` significa que la página tenía menos de 50 palabras de prosa y no se cobró."
|
|
},
|
|
"predictionShort": {
|
|
"type": "string",
|
|
"enum": ["AI", "AI-Assisted", "Human", "Mixed"],
|
|
"description": "Veredicto general de la página. Presente solo cuando la página se comprobó."
|
|
},
|
|
"fractionAi": { "type": "number", "description": "Fracción de la página detectada como generada por IA (0-1)." },
|
|
"fractionAiAssisted": { "type": "number", "description": "Fracción detectada como asistida por IA (0-1)." },
|
|
"fractionHuman": { "type": "number", "description": "Fracción detectada como escrita por humanos (0-1)." },
|
|
"windows": {
|
|
"type": "array",
|
|
"description": "Pasajes marcados (no humanos). Presente solo cuando la página se comprobó.",
|
|
"items": { "$ref": "#/components/schemas/DeslopWindow" }
|
|
},
|
|
"creditsCharged": { "type": "integer", "description": "Créditos de IA cobrados por esta solicitud (0 cuando se omite)." }
|
|
}
|
|
},
|
|
"DeslopWindow": {
|
|
"type": "object",
|
|
"required": ["text", "label", "aiAssistanceScore", "startLine", "endLine"],
|
|
"properties": {
|
|
"text": { "type": "string", "description": "El texto del pasaje marcado." },
|
|
"label": { "type": "string", "description": "Etiqueta de detección para el pasaje, por ejemplo `AI-Generated`." },
|
|
"aiAssistanceScore": { "type": "number", "description": "Puntuación de asistencia por IA para el pasaje (0-1)." },
|
|
"confidence": {
|
|
"description": "Confianza de la detección, devuelta como una etiqueta como `High` o un valor numérico.",
|
|
"oneOf": [
|
|
{ "type": "string" },
|
|
{ "type": "number" }
|
|
]
|
|
},
|
|
"startLine": { "type": "integer", "description": "Línea de inicio del pasaje en el contenido original (índice basado en 1)." },
|
|
"endLine": { "type": "integer", "description": "Línea final del pasaje en el contenido original (índice basado en 1)." },
|
|
"rewrites": {
|
|
"type": "array",
|
|
"description": "Reescrituras humanas sugeridas del pasaje.",
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["text", "rationale"],
|
|
"properties": {
|
|
"text": { "type": "string", "description": "El pasaje reescrito." },
|
|
"rationale": { "type": "string", "description": "Por qué la reescritura suena más humana." }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"AgentJob": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"description": "Identificador único del trabajo del agente."
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [
|
|
"active",
|
|
"completed",
|
|
"archived",
|
|
"failed"
|
|
],
|
|
"description": "Estado actual del trabajo. `active` — el agente está procesando la instrucción en este momento. `completed` — el agente finalizó correctamente y es posible que se haya creado una PR (verificar `prLink`). `archived` — el trabajo se ha archivado. `failed` — el agente encontró un error irrecuperable. Consulte periódicamente hasta que el estado sea `completed`, `archived` o `failed`."
|
|
},
|
|
"source": {
|
|
"type": "object",
|
|
"description": "Información del repositorio de origen.",
|
|
"properties": {
|
|
"repository": {
|
|
"type": "string",
|
|
"description": "URL completa del repositorio de GitHub."
|
|
},
|
|
"ref": {
|
|
"type": "string",
|
|
"description": "branch de Git en la que trabaja el agente.",
|
|
"nullable": true
|
|
}
|
|
}
|
|
},
|
|
"model": {
|
|
"type": "string",
|
|
"description": "El modelo de IA utilizado para esta tarea."
|
|
},
|
|
"prLink": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"example": "https://github.com/org/repo/pull/123",
|
|
"description": "URL de la solicitud de extracción de GitHub creada por el agente. `null` mientras la tarea siga `active` o si no se ha cambiado ningún archivo. Se completa cuando el agente crea correctamente una PR.",
|
|
"nullable": true
|
|
},
|
|
"createdAt": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "Marca de tiempo de creación de la tarea."
|
|
},
|
|
"archivedAt": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "Marca de tiempo de archivado de la tarea.",
|
|
"nullable": true
|
|
}
|
|
}
|
|
},
|
|
"Error": {
|
|
"type": "object",
|
|
"properties": {
|
|
"error": {
|
|
"type": "string",
|
|
"description": "Mensaje de error."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"securitySchemes": {
|
|
"bearerAuth": {
|
|
"type": "http",
|
|
"scheme": "bearer",
|
|
"description": "El encabezado Authorization requiere un token de tipo Bearer. Usa una clave de API de administrador. Esta es una clave secreta del lado del servidor. Genera una en la [página de claves de API](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard."
|
|
}
|
|
}
|
|
}
|
|
}
|