docs(locadex): update translations (#1382)

Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>

Author: locadex-agent[bot]

docs.json

@@ -329,6 +329,7 @@
                 "group": "Optimisation de l’IA",
                 "pages": [
                   "fr/guides/assistant",
+                  "fr/ai/agent",
                   "fr/ai/llmstxt",
                   "fr/ai/contextual-menu",
                   "fr/ai/model-context-protocol",
@@ -533,6 +534,14 @@
                   "fr/api-reference/update/status"
                 ]
               },
+              {
+                "group": "Agent",
+                "pages": [
+                  "fr/api-reference/agent/create-agent-job",
+                  "fr/api-reference/agent/get-agent-job",
+                  "fr/api-reference/agent/get-all-jobs"
+                ]
+              },
               {
                 "group": "Assistant",
                 "pages": [
@@ -596,6 +605,7 @@
                 "group": "Optimización de IA",
                 "pages": [
                   "es/guides/assistant",
+                  "es/ai/agent",
                   "es/ai/llmstxt",
                   "es/ai/contextual-menu",
                   "es/ai/model-context-protocol",
@@ -800,6 +810,14 @@
                   "es/api-reference/update/status"
                 ]
               },
+              {
+                "group": "Agente",
+                "pages": [
+                  "es/api-reference/agent/create-agent-job",
+                  "es/api-reference/agent/get-agent-job",
+                  "es/api-reference/agent/get-all-jobs"
+                ]
+              },
               {
                 "group": "assistant",
                 "pages": [
@@ -863,6 +881,7 @@
                 "group": "AI 优化",
                 "pages": [
                   "zh/guides/assistant",
+                  "zh/ai/agent",
                   "zh/ai/llmstxt",
                   "zh/ai/contextual-menu",
                   "zh/ai/model-context-protocol",
@@ -1067,6 +1086,14 @@
                   "zh/api-reference/update/status"
                 ]
               },
+              {
+                "group": "代理",
+                "pages": [
+                  "zh/api-reference/agent/create-agent-job",
+                  "zh/api-reference/agent/get-agent-job",
+                  "zh/api-reference/agent/get-all-jobs"
+                ]
+              },
               {
                 "group": "AI 助手",
                 "pages": [

es/ai/agent.mdx

@@ -0,0 +1,114 @@
+---
+title: "Agent"
+description: "El agente te ayuda a redactar y mantener la documentación"
+icon: "pen-line"
+---
+
+<Info>
+  El agente está disponible en los [planes Pro y Custom](https://mintlify.com/pricing?ref=agent) para cualquier persona con acceso a tu dashboard.
+</Info>
+
+El agente crea solicitudes de extracción con cambios propuestos a tu documentación basados en tus indicaciones. Cuando envías una solicitud al agente, este consulta tu documentación, repositorios conectados y mensajes de Slack para generar contenido que siga las mejores prácticas de redacción técnica y se ajuste al esquema de Mintlify. Accede al agente en tu espacio de trabajo de Slack o intégralo en aplicaciones personalizadas con la API.
+
+Usa el agente para:
+
+* Redactar contenido nuevo a partir de tus indicaciones, enlaces a solicitudes de extracción o hilos de Slack
+* Revisar ejemplos de código obsoletos y referencias de API
+* Buscar y actualizar contenido existente
+* Responder preguntas sobre tu documentación y temas de redacción técnica
+
+Para empezar, agrega el agente a tu espacio de trabajo de Slack y menciónalo con `@mintlify` en un canal.
+
+<div id="add-the-agent-to-your-slack-workspace">
+  ## Agrega el agente a tu espacio de trabajo de Slack
+</div>
+
+<Note>
+  Si el propietario del espacio de trabajo de Slack requiere aprobación de administrador para instalar aplicaciones, pídele que apruebe la aplicación de Mintlify antes de conectarla.
+</Note>
+
+1. Ve a la página del [agente](https://dashboard.mintlify.com/products/agent) en tu dashboard.
+2. Selecciona el botón **Connect**.
+3. Sigue las indicaciones de Slack para agregar la aplicación `mintlify` a tu espacio de trabajo.
+4. Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack.
+5. Prueba que el agente funciona y responde cuando:
+   * Le envías un mensaje directo.
+   * Lo mencionas con `@mintlify` en un canal.
+
+<div id="connect-repositories-as-context">
+  ## Conecta repositorios como contexto
+</div>
+
+El agente solo puede acceder a los repositorios que conectes mediante la Aplicación de GitHub de Mintlify. Modifica qué repositorios puede acceder el agente en la [configuración de la Aplicación de GitHub](https://github.com/apps/mintlify/installations/new).
+
+<div id="embed-the-agent-via-api">
+  ## Integrar el agente mediante la API
+</div>
+
+Los endpoints del agente pueden usarse para [crear trabajos](/es/api-reference/agent/create-agent-job), [obtener un trabajo específico](/es/api-reference/agent/get-agent-job) y [obtener todos los trabajos](/es/api-reference/agent/get-all-jobs).
+
+<div id="write-effective-prompts">
+  ## Escribe prompts efectivos
+</div>
+
+Piensa en el agente como un assistant útil que necesita tu guía para completar tareas. Dale instrucciones claras y contexto. Las tareas más enfocadas son más fáciles de completar, así que divide los proyectos complejos en pasos más pequeños.
+
+Haz que tus prompts sean específicos y orientados a resultados. Prompts genéricos como `@mintlify Improve the onboarding page` aplican buenas prácticas generales, pero puede que no mejoren el contenido exactamente como lo tenías en mente.
+
+Prueba prompts basados en los resultados que quieres que tus usuarios consigan o en los problemas que encuentran. Por ejemplo: `@mintlify A lot of users have trouble installing the CLI. Review the onboarding page and update the docs so that users can easily install the CLI` o `@mintlify Developers keep getting 401 errors when following our authentication guide. Review the auth docs and add clearer examples showing how to properly format the API key`.
+
+Usa prompts amplios para el mantenimiento general del contenido, como corregir errores tipográficos, actualizar redirecciones o renombrar una función en toda tu documentación. Por ejemplo: `@mintlify Find and fix all typos in the docs` o `@mintlify change all unordered lists to use * instead of -`.
+
+<div id="agent-workflows">
+  ## Flujos de trabajo del agente
+</div>
+
+El agente ayuda con muchas tareas de documentación. Estos flujos de trabajo muestran algunas de las maneras en que puedes integrar al agente en tu proceso de documentación. Prueba un enfoque que se adapte a la forma en que trabaja tu equipo actualmente y ajústalo a tus necesidades específicas.
+
+<div id="iterate-on-a-prompt-in-a-slack-thread">
+  ### Itera sobre un prompt en un hilo de Slack
+</div>
+
+Haz un prompt al agente y luego sigue mencionándolo con `@mintlify` en el mismo hilo para refinar e iterar la solicitud de extracción que crea. Por ejemplo: `@mintlify Nuestra página de inicio rápido necesita una nueva sección sobre cómo invitar colaboradores`. Luego: `@mintlify La nueva sección debería llamarse "Invitar colaboradores"`. Y continúa con cualquier otra iteración.
+
+<div id="start-with-the-agent-finish-manually">
+  ### Comienza con el agente, termina manualmente
+</div>
+
+Pídele al agente que inicie un proyecto, luego cambia a la branch que cree y termina la tarea en tu entorno local o en el editor web. El agente puede ayudarte a empezar; después, puedes tomar el control para completar la tarea. Por ejemplo: `@mintlify Update the quickstart page to include information about inviting collaborators`, y luego cambia a la branch para realizar cualquier cambio adicional usando tu método preferido.
+
+<div id="update-docs-when-merging-feature-changes">
+  ### Actualiza la documentación al fusionar cambios de funcionalidades
+</div>
+
+Cuando fusiones una solicitud de extracción de una funcionalidad, comparte el enlace del PR con el agente para actualizar la documentación pertinente. Por ejemplo: `@mintlify Este PR agrega un nuevo método de autenticación. Actualiza la documentación para incluir el nuevo flujo de auth: [enlace al PR]`.
+
+<div id="generate-release-notes-from-commit-history">
+  ### Generar notas de versión a partir del historial de confirmaciones
+</div>
+
+Pídele al agente una solicitud de extracción específica o un período de tiempo para generar notas de versión o actualizaciones del changelog basadas en el historial de confirmaciones. Por ejemplo: `@mintlify Generate release notes for this PR: [PR link]` o `@mintlify Generate release notes for the last month`.
+
+<div id="generate-code-examples">
+  ### Generar ejemplos de código
+</div>
+
+Pídele al agente que genere ejemplos de código para funcionalidades a lo largo de tu documentación o en páginas específicas. Por ejemplo: `@mintlify Genera un ejemplo de código para que el método de autenticación sea más fácil de entender`.
+
+<div id="review-existing-content">
+  ### Revisar el contenido existente
+</div>
+
+Pídele al agente que revise el contenido existente para verificar la precisión técnica, el estilo, la gramática u otros problemas. Por ejemplo: `@mintlify Revisa la sección de limitación de tasa de la API. Cambiamos los límites el mes pasado`.
+
+<div id="respond-to-user-feedback">
+  ### Responder a los comentarios de los usuarios
+</div>
+
+Proporciona al agente comentarios de tus usuarios para aplicar actualizaciones específicas en tu documentación. Por ejemplo: `@mintlify Los usuarios se están confundiendo con el paso 3 de la guía de configuración. ¿Qué puede estar generando la confusión?`.
+
+<div id="automate-with-the-api">
+  ### Automatiza con la API
+</div>
+
+Integra el agente en tus herramientas de automatización existentes para actualizar automáticamente la documentación cuando haya cambios en el código, iniciar revisiones de contenido o sincronizar actualizaciones de la documentación en varios repositorios.

es/ai/slack-app.mdx

@@ -5,26 +5,26 @@ icon: "slack"
 ---
 
 <Info>
-  La aplicación de Slack está disponible para los [planes Pro y Custom](https://mintlify.com/pricing?ref=slack-app).
+  La aplicación de Slack está disponible para [planes Pro y Custom](https://mintlify.com/pricing?ref=slack-app).
 </Info>
 
-La aplicación de Slack agrega un bot llamado `@mintlify` a tu espacio de trabajo de Slack que puede buscar en tu documentación y responder las preguntas de los usuarios. El bot responde a mensajes directos, menciones con @ y a cualquier pregunta en un canal específicamente llamado `#ask-ai`.
+La aplicación de Slack agrega un bot a tu espacio de trabajo que puede buscar en tu documentación y responder las preguntas de los usuarios. El bot responde a mensajes directos, @menciones y a cualquier pregunta en un canal llamado específicamente `#ask-ai`. El nombre del bot es `@yourprojectname-assistant`. Por ejemplo, si el nombre de tu proyecto es Mintlify, el bot se llamará `@mintlify-assistant`.
 
-La aplicación de Slack puede generar costos: ya sea utilizando tus créditos del Asistente de IA o incurriendo en excedentes.
+La aplicación de Slack puede generar costos: ya sea consumiendo tus créditos del Asistente de IA o generando cargos por excedentes.
 
-<div id="setting-up-the-slack-app">
-  ## Configurar la aplicación de Slack
+<div id="set-up-the-slack-app">
+  ## Configura la app de Slack
 </div>
 
 <Note>
-  Si el propietario de tu espacio de trabajo de Slack requiere aprobación de administrador para instalar aplicaciones, pídele que apruebe la aplicación de Slack de Mintlify antes de agregarla.
+  Si el propietario del espacio de trabajo de Slack requiere la aprobación de un administrador para instalar aplicaciones, pídele que apruebe la app de Slack de Mintlify antes de agregarla.
 </Note>
 
 1. Ve a la página de [Add-ons](https://dashboard.mintlify.com/products/addons) de tu dashboard.
-2. Selecciona **Connect** en la tarjeta Slack Integration.
-3. Sigue las indicaciones de Slack para agregar la aplicación a tu espacio de trabajo.
-4. Verifica que el bot funciona y responde cuando:
+2. Selecciona **Connect** en la tarjeta de Slack Integration.
+3. Sigue las indicaciones de Slack para añadir la app a tu espacio de trabajo.
+4. Verifica que el bot funcione y responda cuando:
 
-- Envías un mensaje directo a la aplicación de Mintlify.
-  - Mencionas al bot con `@mintlify` en un canal.
-  - Creas un canal `#ask-ai`, agregas el bot y haces una pregunta.
+- Le envíes un mensaje directo al bot.
+  - Menciones al bot en un canal.
+  - Crees un canal `#ask-ai`, añadas al bot y hagas una pregunta.

es/api-reference/agent/create-agent-job.mdx

@@ -0,0 +1,23 @@
+---
+openapi: POST /agent/job/{domain}
+---
+
+Este endpoint crea un trabajo de agente a partir de los mensajes proporcionados y la información de la branch. El trabajo se ejecuta de forma asíncrona y devuelve una respuesta en streaming con los detalles de la ejecución y los resultados.
+
+Si no existe una branch, el agente crea una. Si los archivos se editan correctamente, al finalizar el trabajo se crea automáticamente una solicitud de extracción en borrador.
+
+<div id="rate-limits">
+  ## Límites de uso
+</div>
+
+La API del agente tiene los siguientes límites:
+
+- 10,000 usos por key al mes
+- 10,000 solicitudes por organización de Mintlify por hora
+- 10,000 solicitudes por IP al día
+
+<div id="suggested-usage">
+  ## Uso recomendado
+</div>
+
+Para obtener los mejores resultados, utiliza el [hook useChat de ai-sdk](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) para enviar solicitudes y gestionar respuestas.

es/api-reference/agent/get-agent-job.mdx

@@ -0,0 +1,19 @@
+---
+openapi: GET /agent/{domain}/job/{id}
+---
+
+<div id="usage">
+  ## Uso
+</div>
+
+Este endpoint obtiene los detalles y el estado de un trabajo de agente específico mediante su identificador único. Úsalo para consultar el progreso, el estado y los resultados de un trabajo de agente creado previamente.
+
+<div id="job-details">
+  ## Detalles del trabajo
+</div>
+
+La respuesta incluye información como:
+
+- Estado de ejecución y de finalización del trabajo
+- Información de la branch y detalles de la solicitud de extracción
+- metadata de la sesión y marcas de tiempo

es/api-reference/agent/get-all-jobs.mdx

@@ -0,0 +1,15 @@
+---
+openapi: GET /agent/{domain}/jobs
+---
+
+<div id="usage">
+  ## Uso
+</div>
+
+Este endpoint obtiene todos los trabajos del agente para el domain especificado, y ofrece una visión general de las actividades del agente y su estado actual. Es útil para supervisar y gestionar múltiples trabajos del agente, ya sean concurrentes o históricos.
+
+<div id="response">
+  ## Respuesta
+</div>
+
+Usa este endpoint para obtener una visión completa de todas las sesiones previas del agente.