From c06c11895e0c18dc4b1f597339b438bf19e702ea Mon Sep 17 00:00:00 2001 From: "locadex-agent[bot]" <217277504+locadex-agent[bot]@users.noreply.github.com> Date: Wed, 1 Oct 2025 00:35:36 +0000 Subject: [PATCH] docs(locadex): update translations --- es/api-reference/agent/create-agent-job.mdx | 12 +++---- es/api-reference/agent/get-agent-job.mdx | 2 +- es/api-reference/agent/get-all-jobs.mdx | 2 +- es/api-reference/introduction.mdx | 35 ++++++++++--------- fr/api-reference/agent/create-agent-job.mdx | 14 ++++---- fr/api-reference/agent/get-agent-job.mdx | 2 +- fr/api-reference/agent/get-all-jobs.mdx | 2 +- fr/api-reference/introduction.mdx | 27 ++++++++------- gt.config.json | 1 - zh/api-reference/agent/create-agent-job.mdx | 10 +++--- zh/api-reference/agent/get-agent-job.mdx | 2 +- zh/api-reference/agent/get-all-jobs.mdx | 2 +- zh/api-reference/introduction.mdx | 37 +++++++++++---------- 13 files changed, 75 insertions(+), 73 deletions(-) diff --git a/es/api-reference/agent/create-agent-job.mdx b/es/api-reference/agent/create-agent-job.mdx index 9cf82fc97..e841aa08a 100644 --- a/es/api-reference/agent/create-agent-job.mdx +++ b/es/api-reference/agent/create-agent-job.mdx @@ -1,20 +1,18 @@ --- -openapi: POST /agent/job/{domain} +openapi: POST /agent/job/{projectId} --- -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. +Este endpoint crea un trabajo del 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. +Si una branch no existe, el agente crea una. Si los archivos se editan correctamente, al final del trabajo se crea automáticamente una solicitud de extracción en borrador.
- ## Límites de uso + ## Límites de velocidad
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 +- 100 usos por proyecto de Mintlify por hora
## Uso recomendado diff --git a/es/api-reference/agent/get-agent-job.mdx b/es/api-reference/agent/get-agent-job.mdx index f821a4ced..4e688fe16 100644 --- a/es/api-reference/agent/get-agent-job.mdx +++ b/es/api-reference/agent/get-agent-job.mdx @@ -1,5 +1,5 @@ --- -openapi: GET /agent/{domain}/job/{id} +openapi: GET /agent/{projectId}/job/{id} ---
diff --git a/es/api-reference/agent/get-all-jobs.mdx b/es/api-reference/agent/get-all-jobs.mdx index 7ef50ff0e..3911972f2 100644 --- a/es/api-reference/agent/get-all-jobs.mdx +++ b/es/api-reference/agent/get-all-jobs.mdx @@ -1,5 +1,5 @@ --- -openapi: GET /agent/{domain}/jobs +openapi: GET /agent/{projectId}/jobs ---
diff --git a/es/api-reference/introduction.mdx b/es/api-reference/introduction.mdx index 42af73a7a..567cc03be 100644 --- a/es/api-reference/introduction.mdx +++ b/es/api-reference/introduction.mdx @@ -1,19 +1,22 @@ --- title: "Introducción" -description: "Desencadenar actualizaciones, integrar el Asistente de IA y más" +description: "Activar actualizaciones, integrar el Asistente de IA y más" icon: "book-open" --- -La API REST de Mintlify te permite interactuar programáticamente con tu documentación, desencadenar actualizaciones e integrar experiencias de chat con IA. +La API REST de Mintlify te permite interactuar de forma programática con tu documentación, activar actualizaciones e integrar experiencias de chat con IA.
## Endpoints
-* [Activar actualización](/es/api-reference/update/trigger): Activa una actualización de tu sitio cuando lo desees. -* [Obtener el estado de la actualización](/es/api-reference/update/status): Obtén el estado de una actualización y otros detalles sobre tu documentación. -* [Generar mensaje del assistant](/es/api-reference/assistant/create-assistant-message): Inserta el assistant, entrenado con tu documentación, en cualquier aplicación que elijas. -* [Buscar en la documentación](/es/api-reference/assistant/search): Busca en tu documentación. +* [Trigger update](/es/api-reference/update/trigger): Activa una actualización de tu sitio cuando lo desees. +* [Get update status](/es/api-reference/update/status): Obtén el estado de una actualización y otros detalles sobre tu documentación. +* [Create agent job](/es/api-reference/agent/create-agent-job): Crea un trabajo de agente para editar tu documentación automáticamente. +* [Get agent job](/es/api-reference/agent/get-agent-job): Obtén los detalles y el estado de un trabajo de agente específico. +* [Get all agent jobs](/es/api-reference/agent/get-all-jobs): Obtén todos los trabajos de agente para un domain. +* [Generate assistant message](/es/api-reference/assistant/create-assistant-message): Integra el assistant, entrenado con tu documentación, en cualquier aplicación que elijas. +* [Search documentation](/es/api-reference/assistant/search): Busca en tu documentación.
## Autenticación @@ -22,25 +25,25 @@ La API REST de Mintlify te permite interactuar programáticamente con tu documen Puedes generar una API key desde el [dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). Las API keys están asociadas a toda la organización y pueden usarse en varias implementaciones.
- ### Admin API key + ### Clave de API de administrador
-La admin API key se utiliza para los endpoints [Trigger update](/es/api-reference/update/trigger) y [Get update status](/es/api-reference/update/status). +La clave de API de administrador se utiliza para [Trigger update](/es/api-reference/update/trigger), [Get update status](/es/api-reference/update/status) y todos los endpoints de agentes. -Las admin API keys comienzan con el prefijo `mint_`. Mantén tus admin API keys en secreto. +Las claves de API de administrador comienzan con el prefijo `mint_`. Mantén en secreto tus claves de API de administrador.
- ### Assistant API key + ### Clave de la API del assistant
-La assistant API key se utiliza para los endpoints [Generate assistant message](/es/api-reference/assistant/create-assistant-message) y [Search documentation](/es/api-reference/assistant/search). +La clave de la API del assistant se usa en los endpoints [Generate assistant message](/es/api-reference/assistant/create-assistant-message) y [Search documentation](/es/api-reference/assistant/search). -Las assistant API keys comienzan con el prefijo `mint_dsc_`. +Las claves de la API del assistant comienzan con el prefijo `mint_dsc_`. -La **key** de la assistant API es un token del lado del servidor que debe mantenerse en secreto. +La **key** de la API del assistant es un token del lado del servidor que debe mantenerse en secreto. -El **token** de la assistant API es un token público que puede referenciarse en tu código de frontend. +El **token** de la API del assistant es un token público que puede referenciarse en tu código de frontend. - Las llamadas que usen el token de la assistant API pueden generar costos: ya sea usando tus créditos del Asistente de IA o incurriendo en sobrecargos. - + Las llamadas que usan el token de la API del assistant pueden generar costos: ya sea usando tus créditos del Asistente de IA o incurriendo en sobrecargos. + \ No newline at end of file diff --git a/fr/api-reference/agent/create-agent-job.mdx b/fr/api-reference/agent/create-agent-job.mdx index d1deffa8d..d00dba6a3 100644 --- a/fr/api-reference/agent/create-agent-job.mdx +++ b/fr/api-reference/agent/create-agent-job.mdx @@ -1,20 +1,18 @@ --- -openapi: POST /agent/job/{domain} +openapi: POST /agent/job/{projectId} --- -Cet endpoint crée une tâche d’agent à partir des messages fournis et des informations de branche. La tâche s’exécute de manière asynchrone et renvoie une réponse en flux continu contenant les détails d’exécution et les résultats. +Cet endpoint crée une tâche d’agent à partir des messages fournis et des informations de branche. La tâche s’exécute de façon asynchrone et renvoie une réponse en streaming contenant les détails d’exécution et les résultats. -Si la branche n’existe pas, l’agent en crée une. Si des fichiers sont modifiés avec succès, une pull request (demande de fusion) en brouillon est automatiquement créée à la fin de la tâche. +Si la branche n’existe pas, l’agent en crée une. Si des fichiers sont modifiés avec succès, une pull request (demande de fusion) en mode brouillon est automatiquement créée à la fin de la tâche.
- ## Limites de taux + ## Limites de débit
-L’API de l’agent impose les limites suivantes : +L’API de l’agent présente les limites suivantes : -- 10 000 utilisations par key et par mois -- 10 000 requêtes par organisation Mintlify et par heure -- 10 000 requêtes par adresse IP et par jour +- 100 utilisations par projet Mintlify et par heure
## Utilisation recommandée diff --git a/fr/api-reference/agent/get-agent-job.mdx b/fr/api-reference/agent/get-agent-job.mdx index e5f2977bd..7db138875 100644 --- a/fr/api-reference/agent/get-agent-job.mdx +++ b/fr/api-reference/agent/get-agent-job.mdx @@ -1,5 +1,5 @@ --- -openapi: GET /agent/{domain}/job/{id} +openapi: GET /agent/{projectId}/job/{id} ---
diff --git a/fr/api-reference/agent/get-all-jobs.mdx b/fr/api-reference/agent/get-all-jobs.mdx index d55b7a006..0275e8288 100644 --- a/fr/api-reference/agent/get-all-jobs.mdx +++ b/fr/api-reference/agent/get-all-jobs.mdx @@ -1,5 +1,5 @@ --- -openapi: GET /agent/{domain}/jobs +openapi: GET /agent/{projectId}/jobs ---
diff --git a/fr/api-reference/introduction.mdx b/fr/api-reference/introduction.mdx index 39df24435..a0fa3542c 100644 --- a/fr/api-reference/introduction.mdx +++ b/fr/api-reference/introduction.mdx @@ -1,6 +1,6 @@ --- title: "Introduction" -description: "Déclencher des mises à jour, intégrer l’Assistant IA et plus encore" +description: "Déclenchez des mises à jour, intégrez l’Assistant IA et plus encore" icon: "book-open" --- @@ -10,22 +10,25 @@ L’API REST de Mintlify vous permet d’interagir par programmation avec votre ## Endpoints
-* [Déclencher une mise à jour](/fr/api-reference/update/trigger) : Déclenchez une mise à jour de votre site à la demande. -* [Obtenir l’état de la mise à jour](/fr/api-reference/update/status) : Obtenez l’état d’une mise à jour et d’autres détails sur votre documentation. -* [Générer un message de l’Assistant](/fr/api-reference/assistant/create-assistant-message) : Intégrez l’Assistant, entraîné sur votre documentation, dans n’importe quelle application de votre choix. -* [Rechercher dans la documentation](/fr/api-reference/assistant/search) : Recherchez dans votre documentation. +* [Déclencher une mise à jour](/fr/api-reference/update/trigger): Déclenchez une mise à jour de votre site quand vous le souhaitez. +* [Obtenir l’état de la mise à jour](/fr/api-reference/update/status): Obtenez l’état d’une mise à jour et d’autres détails sur votre documentation. +* [Créer une tâche d’agent](/fr/api-reference/agent/create-agent-job): Créez une tâche d’agent pour modifier automatiquement votre documentation. +* [Obtenir une tâche d’agent](/fr/api-reference/agent/get-agent-job): Récupérez les détails et l’état d’une tâche d’agent spécifique. +* [Obtenir toutes les tâches d’agent](/fr/api-reference/agent/get-all-jobs): Récupérez toutes les tâches d’agent pour un domain. +* [Générer un message Assistant](/fr/api-reference/assistant/create-assistant-message): Intégrez l’Assistant, entraîné sur votre documentation, dans n’importe quelle application de votre choix. +* [Rechercher dans la documentation](/fr/api-reference/assistant/search): Recherchez dans votre documentation.
## Authentification
-Vous pouvez générer une clé d’API via [le Dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). Les clés d’API sont associées à toute l’organisation et peuvent être utilisées sur plusieurs déploiements. +Vous pouvez générer une clé d’API via [le Dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). Les clés d’API sont associées à l’ensemble d’une organisation et peuvent être utilisées sur plusieurs déploiements.
### Clé d’API administrateur
-La clé d’API administrateur est utilisée pour les endpoints [Déclencher une mise à jour](/fr/api-reference/update/trigger) et [Obtenir l’état de la mise à jour](/fr/api-reference/update/status). +La clé d’API administrateur est utilisée pour [déclencher une mise à jour](/fr/api-reference/update/trigger), [obtenir l’état de mise à jour](/fr/api-reference/update/status) ainsi que pour tous les endpoints d’agent. Les clés d’API administrateur commencent par le préfixe `mint_`. Gardez vos clés d’API administrateur secrètes. @@ -33,14 +36,14 @@ Les clés d’API administrateur commencent par le préfixe `mint_`. Gardez vos ### Clé d’API de l’Assistant
-La clé d’API de l’Assistant est utilisée pour les endpoints [Générer un message de l’Assistant](/fr/api-reference/assistant/create-assistant-message) et [Rechercher dans la documentation](/fr/api-reference/assistant/search). +La clé d’API de l’Assistant est utilisée pour les endpoints [Generate assistant message](/fr/api-reference/assistant/create-assistant-message) et [Search documentation](/fr/api-reference/assistant/search). Les clés d’API de l’Assistant commencent par le préfixe `mint_dsc_`. -La **key** de l’API de l’Assistant est un jeton côté serveur qui doit rester secret. +La **key** d’API de l’Assistant est un jeton côté serveur qui doit rester secret. -Le **token** de l’API de l’Assistant est un jeton public qui peut être référencé dans votre code frontend. +Le **token** d’API de l’Assistant est un jeton public qui peut être référencé dans votre code frontend. - Les appels utilisant le token de l’API de l’Assistant peuvent entraîner des coûts : soit en utilisant vos crédits d’Assistant IA, soit en engendrant des dépassements. - + Les appels utilisant le token d’API de l’Assistant peuvent entraîner des coûts : soit en utilisant vos crédits d’Assistant IA, soit en générant des dépassements. + \ No newline at end of file diff --git a/gt.config.json b/gt.config.json index 3ea70a583..51690a6b4 100644 --- a/gt.config.json +++ b/gt.config.json @@ -1,5 +1,4 @@ { - "projectId": "prj_u0hebau791s0lso8onna23xg", "$schema": "https://assets.gtx.dev/config-schema.json", "files": { "json": { diff --git a/zh/api-reference/agent/create-agent-job.mdx b/zh/api-reference/agent/create-agent-job.mdx index eab8db0a2..313d3198a 100644 --- a/zh/api-reference/agent/create-agent-job.mdx +++ b/zh/api-reference/agent/create-agent-job.mdx @@ -1,10 +1,10 @@ --- -openapi: POST /agent/job/{domain} +openapi: POST /agent/job/{projectId} --- -此端点会根据提供的消息和branch信息创建一个代理任务。该任务以异步方式执行,并通过流式响应返回执行详情和结果。 +此端点会根据提供的消息和 branch 信息创建一个代理作业。该作业以异步方式执行,并通过流式响应返回执行详情和结果。 -如果branch不存在,代理会创建一个。若文件编辑成功,任务结束时会自动创建一个草稿拉取请求(PR;亦称“合并请求”/Merge Request)。 +如果该 branch 不存在,代理将创建一个。若文件编辑成功,作业结束时会自动创建一个草稿拉取请求(PR;亦称“合并请求”/Merge Request)。
## 速率限制 @@ -12,9 +12,7 @@ openapi: POST /agent/job/{domain} Agent API 具有以下限制: -- 每个 key 每月最多使用 10,000 次 -- 每个 Mintlify 组织每小时最多 10,000 次请求 -- 每个 IP 每天最多 10,000 次请求 +- 每个 Mintlify 项目每小时最多 100 次调用
## 建议用法 diff --git a/zh/api-reference/agent/get-agent-job.mdx b/zh/api-reference/agent/get-agent-job.mdx index 3b2193e1b..eb893fdf3 100644 --- a/zh/api-reference/agent/get-agent-job.mdx +++ b/zh/api-reference/agent/get-agent-job.mdx @@ -1,5 +1,5 @@ --- -openapi: GET /agent/{domain}/job/{id} +openapi: GET /agent/{projectId}/job/{id} ---
diff --git a/zh/api-reference/agent/get-all-jobs.mdx b/zh/api-reference/agent/get-all-jobs.mdx index 3c0edd0ff..fc5ba5fd2 100644 --- a/zh/api-reference/agent/get-all-jobs.mdx +++ b/zh/api-reference/agent/get-all-jobs.mdx @@ -1,5 +1,5 @@ --- -openapi: GET /agent/{domain}/jobs +openapi: GET /agent/{projectId}/jobs ---
diff --git a/zh/api-reference/introduction.mdx b/zh/api-reference/introduction.mdx index 6a2cd8826..9bebad3c2 100644 --- a/zh/api-reference/introduction.mdx +++ b/zh/api-reference/introduction.mdx @@ -1,46 +1,49 @@ --- -title: "简介" -description: "触发更新、嵌入 AI 助手等" +title: "介绍" +description: "触发更新、嵌入 AI 助手等功能" icon: "book-open" --- -Mintlify 的 REST API 使你能够通过编程与文档交互、触发更新,并嵌入 AI 驱动的聊天体验。 +Mintlify 的 REST API 可让你以编程方式与文档交互、触发更新,并嵌入 AI 驱动的聊天体验。
## 端点
-* [触发更新](/zh/api-reference/update/trigger): 在需要时触发站点更新。 -* [获取更新状态](/zh/api-reference/update/status): 获取更新状态及文档的其他详细信息。 -* [生成 AI 助手消息](/zh/api-reference/assistant/create-assistant-message): 将基于你的文档训练的 AI 助手嵌入到任意你选择的应用中。 -* [搜索文档](/zh/api-reference/assistant/search): 搜索你的文档。 +* [触发更新](/zh/api-reference/update/trigger): 按需触发你的网站更新。 +* [获取更新状态](/zh/api-reference/update/status): 获取更新状态及与你的文档相关的其他详情。 +* [创建代理任务](/zh/api-reference/agent/create-agent-job): 创建代理任务以自动编辑你的文档。 +* [获取代理任务](/zh/api-reference/agent/get-agent-job): 获取特定代理任务的详情和状态。 +* [获取所有代理任务](/zh/api-reference/agent/get-all-jobs): 检索某个 domain 下的所有代理任务。 +* [生成 AI 助手消息](/zh/api-reference/assistant/create-assistant-message): 将基于你文档训练的 AI 助手嵌入到任意应用中。 +* [搜索文档](/zh/api-reference/assistant/search): 在文档中搜索。
## 认证
-你可以通过[控制台](https://dashboard.mintlify.com/settings/organization/api-keys)生成 API key。API key 与整个组织关联,可在多个部署中使用。 +您可以通过[控制台](https://dashboard.mintlify.com/settings/organization/api-keys)生成 API key。API key 关联整个组织,可在多个部署中使用。
- ### Admin API key + ### 管理员 API key
-Admin API key 用于 [Trigger update](/zh/api-reference/update/trigger) 和 [Get update status](/zh/api-reference/update/status) 端点。 +管理员 API key 用于 [触发更新](/zh/api-reference/update/trigger)、[获取更新状态](/zh/api-reference/update/status) 以及所有代理端点。 -Admin API key 以 `mint_` 为前缀。请妥善保管你的 Admin API key。 +管理员 API key 以 `mint_` 作为前缀。请妥善保管你的管理员 API key。
### Assistant API key
-Assistant API key 用于 [Generate assistant message](/zh/api-reference/assistant/create-assistant-message) 和 [Search documentation](/zh/api-reference/assistant/search) 端点。 +assistant API key 用于 [生成助手消息](/zh/api-reference/assistant/create-assistant-message) 和 [搜索文档](/zh/api-reference/assistant/search) 端点。 -Assistant API key 以 `mint_dsc_` 为前缀。 +Assistant API key 以 `mint_dsc_` 前缀开头。 -Assistant API 的 **key** 是服务端令牌,应当保密。 +assistant API 的 **key** 是应当保密的服务端令牌。 -Assistant API 的 **token** 是公开令牌,可以在你的前端代码中引用。 +assistant API 的 **token** 是可在前端代码中引用的公共令牌。 - 使用 Assistant API token 的调用可能产生费用:要么消耗你的 AI 助手额度,要么产生超额费用。 - + 使用 assistant API token 的调用可能会产生费用:要么消耗你的 AI 助手额度,要么产生超额费用。 + \ No newline at end of file