- ## Configurar la aplicación de Slack
+
+ ## Configura la app de Slack
- 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.
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.
\ No newline at end of file
+- 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.
\ No newline at end of file
diff --git a/es/api-reference/agent/create-agent-job.mdx b/es/api-reference/agent/create-agent-job.mdx
new file mode 100644
index 000000000..9cf82fc97
--- /dev/null
+++ b/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.
+
+
+ ## Límites de uso
+
+
+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
+
+
+ ## Uso recomendado
+
+
+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.
\ No newline at end of file
diff --git a/es/api-reference/agent/get-agent-job.mdx b/es/api-reference/agent/get-agent-job.mdx
new file mode 100644
index 000000000..f821a4ced
--- /dev/null
+++ b/es/api-reference/agent/get-agent-job.mdx
@@ -0,0 +1,19 @@
+---
+openapi: GET /agent/{domain}/job/{id}
+---
+
+
+ ## Uso
+
+
+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.
+
+
+ ## Detalles del trabajo
+
+
+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
\ No newline at end of file
diff --git a/es/api-reference/agent/get-all-jobs.mdx b/es/api-reference/agent/get-all-jobs.mdx
new file mode 100644
index 000000000..7ef50ff0e
--- /dev/null
+++ b/es/api-reference/agent/get-all-jobs.mdx
@@ -0,0 +1,15 @@
+---
+openapi: GET /agent/{domain}/jobs
+---
+
+
+ ## Uso
+
+
+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.
+
+
+ ## Respuesta
+
+
+Usa este endpoint para obtener una visión completa de todas las sesiones previas del agente.
\ No newline at end of file
diff --git a/fr/ai/agent.mdx b/fr/ai/agent.mdx
new file mode 100644
index 000000000..48a8d8fb2
--- /dev/null
+++ b/fr/ai/agent.mdx
@@ -0,0 +1,114 @@
+---
+title: "Agent"
+description: "L’agent vous aide à rédiger et à maintenir la documentation"
+icon: "pen-line"
+---
+
+
+ L’agent est disponible avec les [offres Pro et Custom](https://mintlify.com/pricing?ref=agent) pour toute personne ayant accès à votre Dashboard.
+
+
+L’agent crée des pull requests avec des propositions de modification de votre documentation, à partir de vos instructions. Lorsque vous lui envoyez une demande, il s’appuie sur votre documentation, vos dépôts connectés et vos messages Slack pour produire un contenu conforme aux bonnes pratiques de rédaction technique et au schéma Mintlify. Accédez à l’agent dans votre espace de travail Slack ou intégrez‑le à des applications personnalisées via l’API.
+
+Utilisez l’agent pour :
+
+* Rédiger de nouveaux contenus à partir de vos instructions, de liens vers des pull requests ou de fils Slack
+* Mettre à jour des exemples de code obsolètes et des références d’API
+* Rechercher et actualiser le contenu existant
+* Répondre aux questions sur votre documentation et la rédaction technique
+
+Pour commencer, ajoutez l’agent à votre espace de travail Slack et mentionnez‑le avec `@mintlify` dans un canal.
+
+
+ ## Ajouter l’agent à votre espace de travail Slack
+
+
+
+ Si le propriétaire de votre espace Slack exige une approbation d’un administrateur pour installer des applications, demandez-lui d’approuver l’application mintlify avant de la connecter.
+
+
+1. Accédez à la page [agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
+2. Sélectionnez le bouton **Connect**.
+3. Suivez les instructions Slack pour ajouter l’application `mintlify` à votre espace de travail.
+4. Suivez les instructions Slack pour lier votre compte Mintlify à votre espace Slack.
+5. Vérifiez que l’agent fonctionne et répond lorsque vous :
+ * Lui envoyez un message direct.
+ * Le mentionnez avec `@mintlify` dans un canal.
+
+
+ ## Connecter des dépôts comme contexte
+
+
+L’agent ne peut accéder qu’aux dépôts que vous connectez via la GitHub App de Mintlify. Modifiez les dépôts auxquels l’agent peut accéder dans les [paramètres de la GitHub App](https://github.com/apps/mintlify/installations/new).
+
+
+ ## Intégrer l’agent via l’API
+
+
+Les points de terminaison de l’API de l’agent permettent de [créer des tâches](/fr/api-reference/agent/create-agent-job), [récupérer une tâche spécifique](/fr/api-reference/agent/get-agent-job) et [récupérer toutes les tâches](/fr/api-reference/agent/get-all-jobs).
+
+
+ ## Rédiger des prompts efficaces
+
+
+Considérez l’agent comme un assistant utile qui a besoin de vos indications pour accomplir des tâches. Donnez‑lui des instructions claires et du contexte. Les tâches ciblées sont plus faciles à mener à bien, donc décomposez les projets complexes en étapes plus petites.
+
+Rendez vos prompts spécifiques et orientés vers le résultat. Des prompts génériques comme `@mintlify Improve the onboarding page` appliquent des bonnes pratiques générales, mais peuvent ne pas améliorer le contenu de la manière précise que vous aviez en tête.
+
+Essayez des prompts fondés sur les résultats que vous souhaitez que vos utilisateurs atteignent ou sur les problèmes qu’ils rencontrent. Par exemple : `@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` ou `@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`.
+
+Utilisez des prompts larges pour la maintenance générale du contenu, comme corriger les fautes de frappe, mettre à jour les redirections ou renommer une fonctionnalité dans l’ensemble de votre documentation. Par exemple : `@mintlify Find and fix all typos in the docs` ou `@mintlify change all unordered lists to use * instead of -`.
+
+
+ ## Workflows de l’agent
+
+
+L’agent prend en charge de nombreuses tâches liées à la documentation. Ces workflows illustrent différentes manières d’intégrer l’agent à votre processus de documentation. Adoptez une approche qui correspond au fonctionnement actuel de votre équipe et adaptez-la à vos besoins spécifiques.
+
+
+ ### Itérez sur un prompt dans un fil Slack
+
+
+Faites une première demande à l’agent, puis continuez à le mentionner avec `@mintlify` dans le même fil pour affiner et itérer sur la pull request (demande de fusion) qu’il crée. Par exemple : `@mintlify Notre page de démarrage rapide a besoin d’une nouvelle section sur l’invitation de collaborateurs`. Puis : `@mintlify La nouvelle section devrait s’intituler « Inviter des collaborateurs »`. Suivez avec toute autre itération nécessaire.
+
+
+ ### Commencez avec l’agent, terminez manuellement
+
+
+Demandez à l’agent de lancer un projet, puis récupérez la branche qu’il crée et terminez la tâche dans votre environnement local ou dans l’éditeur web. L’agent peut vous aider à démarrer, puis vous pouvez prendre le relais pour finaliser la tâche. Par exemple : `@mintlify Update the quickstart page to include information about inviting collaborators`, puis récupérez la branche pour apporter des modifications supplémentaires avec votre méthode préférée.
+
+
+ ### Mettre à jour la documentation lors de la fusion de changements de fonctionnalités
+
+
+Lorsque vous fusionnez une pull request (demande de fusion) de fonctionnalité, partagez le lien de la PR avec l’agent pour mettre à jour la documentation concernée. Par exemple : `@mintlify Cette PR ajoute une nouvelle méthode d’authentification. Mettez à jour la doc pour inclure le nouveau flux d’authentification : [PR link]`.
+
+
+ ### Générer des notes de version à partir de l’historique des commits
+
+
+Demandez à l’agent, en lui fournissant un pull request (demande de fusion) spécifique ou une période donnée, de générer des notes de version ou des mises à jour du journal des modifications à partir de l’historique des commits. Par exemple : `@mintlify Generate release notes for this PR: [PR link]` ou `@mintlify Generate release notes for the last month`.
+
+
+ ### Générer des exemples de code
+
+
+Demandez à l’agent de générer des exemples de code pour des fonctionnalités dans l’ensemble de votre documentation ou sur des pages spécifiques. Par exemple : `@mintlify Génère un exemple de code pour rendre la méthode d’authentification plus facile à comprendre`.
+
+
+ ### Passer en revue le contenu existant
+
+
+Demandez à l’agent de passer en revue le contenu existant pour vérifier l’exactitude technique, le style, la grammaire ou d’autres points. Par exemple : `@mintlify Review the API rate limiting section. We changed limits last month`.
+
+
+ ### Répondre aux commentaires des utilisateurs
+
+
+Soumettez à l’agent les commentaires de vos utilisateurs pour apporter des mises à jour ciblées à votre documentation. Par exemple : `@mintlify Les utilisateurs sont déroutés par l’étape 3 du guide d’installation. Qu’est-ce qui pourrait la rendre ambiguë ?`.
+
+
+ ### Automatiser avec l’API
+
+
+Intégrez l’agent à vos outils d’automatisation existants pour mettre automatiquement à jour la documentation lors des modifications de code, déclencher des revues de contenu ou synchroniser les mises à jour de documentation entre plusieurs dépôts.
\ No newline at end of file
diff --git a/fr/ai/slack-app.mdx b/fr/ai/slack-app.mdx
index acfb5ab29..f6d6cdd66 100644
--- a/fr/ai/slack-app.mdx
+++ b/fr/ai/slack-app.mdx
@@ -5,15 +5,15 @@ icon: "slack"
---
- L’application Slack est disponible avec les [offres Pro et Custom](https://mintlify.com/pricing?ref=slack-app).
+ L'app Slack est disponible avec les [offres Pro et Custom](https://mintlify.com/pricing?ref=slack-app).
-L’application Slack ajoute un bot nommé `@mintlify` à votre espace de travail Slack, capable de rechercher dans votre documentation et de répondre aux questions des utilisateurs. Le bot répond aux messages directs, aux @mentions, ainsi qu’à toute question dans un canal nommé spécifiquement `#ask-ai`.
+L'app Slack ajoute un bot à votre espace de travail Slack qui peut rechercher dans votre documentation et répondre aux questions des utilisateurs. Le bot répond aux messages directs, aux @mentions, ainsi qu’à toute question dans un canal nommé spécifiquement `#ask-ai`. Le nom du bot est `@yourprojectname-assistant`. Ainsi, si le nom de votre projet est Mintlify, le bot s’appelle `@mintlify-assistant`.
-L’application Slack peut engendrer des coûts : soit via l’utilisation de vos crédits d’Assistant IA, soit via des dépassements.
+L'app Slack peut entraîner des coûts : soit en utilisant vos crédits d’Assistant IA, soit en générant des dépassements.
-
- ## Configuration de l’application Slack
+
+ ## Configurer l’application Slack
@@ -22,9 +22,9 @@ L’application Slack peut engendrer des coûts : soit via l’utilisation de v
1. Accédez à la page [Modules complémentaires](https://dashboard.mintlify.com/products/addons) de votre Dashboard.
2. Sélectionnez **Connect** dans la carte Slack Integration.
-3. Suivez les invites Slack pour ajouter l’application à votre espace de travail.
+3. Suivez les instructions de Slack pour ajouter l’application à votre espace de travail.
4. Vérifiez que le bot fonctionne et répond lorsque vous :
-- Envoyez un message direct à l’application Mintlify.
- - Mentionnez le bot avec `@mintlify` dans un canal.
+- Envoyez un message direct au bot.
+ - Mentionnez le bot dans un canal.
- Créez un canal `#ask-ai`, ajoutez le bot et posez une question.
\ 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
new file mode 100644
index 000000000..d1deffa8d
--- /dev/null
+++ b/fr/api-reference/agent/create-agent-job.mdx
@@ -0,0 +1,23 @@
+---
+openapi: POST /agent/job/{domain}
+---
+
+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.
+
+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.
+
+
+ ## Limites de taux
+
+
+L’API de l’agent impose 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
+
+
+ ## Utilisation recommandée
+
+
+Pour de meilleurs résultats, utilisez le [hook useChat d’ai-sdk](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) pour envoyer des requêtes et traiter les réponses.
\ No newline at end of file
diff --git a/fr/api-reference/agent/get-agent-job.mdx b/fr/api-reference/agent/get-agent-job.mdx
new file mode 100644
index 000000000..e5f2977bd
--- /dev/null
+++ b/fr/api-reference/agent/get-agent-job.mdx
@@ -0,0 +1,19 @@
+---
+openapi: GET /agent/{domain}/job/{id}
+---
+
+
+ ## Utilisation
+
+
+Cet endpoint renvoie les détails et l’état d’un travail d’agent spécifique à partir de son identifiant unique. Utilisez-le pour vérifier la progression, l’état et les résultats d’un travail d’agent précédemment créé.
+
+
+ ## Détails du job
+
+
+La réponse inclut des informations telles que :
+
+- Statut d’exécution du job et état d’achèvement
+- Informations de branche et détails du pull request (demande de fusion)
+- metadata de session et horodatages
\ No newline at end of file
diff --git a/fr/api-reference/agent/get-all-jobs.mdx b/fr/api-reference/agent/get-all-jobs.mdx
new file mode 100644
index 000000000..d55b7a006
--- /dev/null
+++ b/fr/api-reference/agent/get-all-jobs.mdx
@@ -0,0 +1,15 @@
+---
+openapi: GET /agent/{domain}/jobs
+---
+
+
+ ## Utilisation
+
+
+Cet endpoint récupère tous les jobs d’agent pour le domain spécifié, offrant une vue d’ensemble de toutes les activités des agents et de leur état actuel. C’est utile pour surveiller et gérer plusieurs jobs d’agent simultanés ou historiques.
+
+
+ ## Réponse
+
+
+Utilisez cet endpoint pour obtenir une vue d’ensemble de toutes les sessions d’agent précédentes.
\ No newline at end of file
diff --git a/zh/ai/agent.mdx b/zh/ai/agent.mdx
new file mode 100644
index 000000000..a3ae2662f
--- /dev/null
+++ b/zh/ai/agent.mdx
@@ -0,0 +1,114 @@
+---
+title: "Agent"
+description: "Agent 可帮助你编写和维护文档"
+icon: "pen-line"
+---
+
+
+ Agent 适用于拥有你控制台访问权限的用户，包含在 [Pro 和 Custom 方案](https://mintlify.com/pricing?ref=agent) 中。
+
+
+Agent 会根据你的提示为文档提出修改并创建拉取请求（PR）。当你向 Agent 发送请求时，它会参考你的文档、已连接的代码仓库以及 Slack 消息，生成符合技术写作最佳实践并遵循 Mintlify 架构的内容。你可以在 Slack 工作区中使用 Agent，或通过 API 将其嵌入自定义应用。
+
+你可以使用 Agent 来：
+
+* 基于你的提示、拉取请求链接或 Slack 线程撰写新内容
+* 更新过时的代码示例和 API 引用
+* 搜索并更新现有内容
+* 回答关于你的文档与技术写作的相关问题
+
+开始使用前，将 Agent 添加到你的 Slack 工作区，并在频道中通过 `@mintlify` 提及它。
+
+
+ ## 将代理添加到你的 Slack 工作区
+
+
+
+ 如果你的 Slack 工作区所有者要求对安装应用进行管理员审批，请在连接之前请他们先批准 mintlify 应用。
+
+
+1. 在控制台中前往 [agent](https://dashboard.mintlify.com/products/agent) 页面。
+2. 选择 **Connect** 按钮。
+3. 按照 Slack 的提示将 `mintlify` 应用添加到你的工作区。
+4. 按照 Slack 的提示将你的 Mintlify 帐户关联到你的 Slack 工作区。
+5. 测试代理是否正常工作，并在以下情况下能做出响应：
+ * 向其发送私信。
+ * 在频道中使用 `@mintlify` 提及它。
+
+
+ ## 将仓库连接为 context
+
+
+代理只能访问你通过 Mintlify GitHub 应用连接的仓库。你可以在 [GitHub 应用设置](https://github.com/apps/mintlify/installations/new) 中修改代理可访问的仓库。
+
+
+ ## 通过 API 嵌入代理
+
+
+代理端点可用于[创建任务](/zh/api-reference/agent/create-agent-job)、[获取特定任务](/zh/api-reference/agent/get-agent-job)以及[获取所有任务](/zh/api-reference/agent/get-all-jobs)。
+
+
+ ## 编写高效的提示词
+
+
+将代理视为一个需要你指引来完成任务的 AI 助手。向它提供清晰的指令和上下文。任务越聚焦，越容易完成，因此将复杂项目拆解为更小的步骤。
+
+让你的提示词具体且以结果为导向。像 `@mintlify Improve the onboarding page` 这样的笼统提示只会应用通用最佳实践，但可能无法按你设想的方式改进内容。
+
+围绕你希望用户达成的目标或他们遇到的问题来编写提示词。例如：`@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` 或 `@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`。
+
+对一般性的内容维护，使用更宽泛的提示词，例如修正错别字、更新重定向，或在整个文档中重命名某个功能。例如：`@mintlify Find and fix all typos in the docs` 或 `@mintlify change all unordered lists to use * instead of -`。
+
+
+ ## Agent 工作流
+
+
+该 Agent 可协助处理多种文档任务。以下工作流展示了将 Agent 集成到文档流程中的一些方式。选择与团队当前工作方式相匹配的方法，并根据你的具体需求进行调整。
+
+
+ ### 在 Slack 线程中迭代优化提示
+
+
+先向代理发送提示，然后在同一线程中继续用 `@mintlify` 提及它，以完善并迭代其创建的拉取请求（PR）。例如：`@mintlify 我们的快速入门页面需要新增一个关于邀请协作者的章节`。然后：`@mintlify 新章节应命名为「邀请协作者」`。之后可继续进行其他迭代。
+
+
+ ### 由智能代理起步，手动收尾
+
+
+让代理启动一个项目，然后检出它创建的 branch，并在本地环境或网页版编辑器中完成任务。代理可助你快速起步，随后由你接手完成。示例：`@mintlify Update the quickstart page to include information about inviting collaborators`，接着检出该 branch，并用你偏好的方式进行后续修改。
+
+
+ ### 合并功能变更时更新文档
+
+
+当你合并功能拉取请求（PR）后，将 PR 链接发给助手以更新相关文档。例如：`@mintlify 此 PR 新增了一种认证方法。请更新文档以包含新的认证流程：[PR 链接]`。
+
+
+ ### 基于提交历史生成发布说明
+
+
+向代理提供特定的拉取请求（PR）或时间范围，以基于提交历史生成发布说明或更新日志。例如：`@mintlify Generate release notes for this PR: [PR link]` 或 `@mintlify Generate release notes for the last month`。
+
+
+ ### 生成代码示例
+
+
+让代理在你的文档各处或特定页面为功能生成代码示例。例如：`@mintlify 生成一个代码示例，以便更容易理解该认证方法`。
+
+
+ ### 审查现有内容
+
+
+让代理审查现有内容的技术准确性、风格、语法等问题。例如：`@mintlify Review the API rate limiting section. We changed limits last month`。
+
+
+ ### 回应用户反馈
+
+
+将用户的反馈作为提示提供给代理，以便对文档进行有针对性的更新。例如：`@mintlify Users are getting confused by step 3 in the setup guide. What might be making it unclear?`。
+
+
+ ### 使用 API 实现自动化
+
+
+将智能代理集成到你现有的自动化工具中，在代码变更时自动更新文档、触发内容评审，或在多个代码库间同步文档更新。
\ No newline at end of file
diff --git a/zh/ai/slack-app.mdx b/zh/ai/slack-app.mdx
index f8e610ff2..2d0c019f1 100644
--- a/zh/ai/slack-app.mdx
+++ b/zh/ai/slack-app.mdx
@@ -1,30 +1,30 @@
---
title: "Slack app"
-description: "向你的 Slack 工作区添加一个可搜索文档并回答问题的机器人"
+description: "在你的 Slack 工作区中添加一个可搜索文档并回答问题的机器人"
icon: "slack"
---
- Slack app 适用于[Pro 和 Custom 计划](https://mintlify.com/pricing?ref=slack-app)。
+ Slack app 适用于 [Pro 和 Custom 方案](https://mintlify.com/pricing?ref=slack-app)。
-Slack app 会在你的 Slack 工作区添加一个名为 `@mintlify` 的机器人，它可以搜索你的文档并解答用户的问题。该机器人会回复私信、@ 提及，以及在名为 `#ask-ai` 的频道中提出的任何问题。
+Slack app 会在你的 Slack 工作区中添加一个机器人，它可以搜索你的文档并回答用户的问题。该机器人会响应私信、@ 提及，以及在名为 `#ask-ai` 的频道中提出的任何问题。机器人的名称为 `@yourprojectname-assistant`。因此，如果你的项目名称是 Mintlify，机器人的名称就是 `@mintlify-assistant`。
使用 Slack app 可能会产生费用：要么消耗你的 AI 助手额度，要么产生超额费用。
-
+
## 设置 Slack 应用
- 如果你的 Slack 工作区所有者要求对安装应用进行管理员审批，请在添加之前请他们先批准 Mintlify Slack 应用。
+ 如果你的 Slack 工作区需由所有者审批才能安装应用，请在添加前请他们先批准 Mintlify Slack 应用。
-1. 前往控制台的 [附加组件](https://dashboard.mintlify.com/products/addons) 页面。
-2. 在 Slack Integration 卡片中选择 **Connect**。
-3. 按照 Slack 的提示将应用添加到你的工作区。
+1. 前往你的控制台的 [附加组件](https://dashboard.mintlify.com/products/addons) 页面。
+2. 在 Slack 集成卡片中选择 **Connect**。
+3. 按照 Slack 的指引将应用添加到你的工作区。
4. 测试机器人是否正常工作，并在以下情况下能响应：
-- 向 Mintlify 应用发送私信。
- - 在频道中使用 `@mintlify` 提及机器人。
- - 创建 `#ask-ai` 频道，添加机器人并提出问题。
\ No newline at end of file
+- 向机器人发送私信。
+ - 在频道中提及机器人。
+ - 创建一个 `#ask-ai` 频道，添加机器人并提问。
\ No newline at end of file
diff --git a/zh/api-reference/agent/create-agent-job.mdx b/zh/api-reference/agent/create-agent-job.mdx
new file mode 100644
index 000000000..eab8db0a2
--- /dev/null
+++ b/zh/api-reference/agent/create-agent-job.mdx
@@ -0,0 +1,23 @@
+---
+openapi: POST /agent/job/{domain}
+---
+
+此端点会根据提供的消息和branch信息创建一个代理任务。该任务以异步方式执行，并通过流式响应返回执行详情和结果。
+
+如果branch不存在，代理会创建一个。若文件编辑成功，任务结束时会自动创建一个草稿拉取请求（PR；亦称“合并请求”/Merge Request）。
+
+
+ ## 速率限制
+
+
+Agent API 具有以下限制：
+
+- 每个 key 每月最多使用 10,000 次
+- 每个 Mintlify 组织每小时最多 10,000 次请求
+- 每个 IP 每天最多 10,000 次请求
+
+
+ ## 建议用法
+
+
+为获得最佳效果，请使用 [ai-sdk 的 useChat 钩子](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) 来发送请求并处理响应。
\ No newline at end of file
diff --git a/zh/api-reference/agent/get-agent-job.mdx b/zh/api-reference/agent/get-agent-job.mdx
new file mode 100644
index 000000000..3b2193e1b
--- /dev/null
+++ b/zh/api-reference/agent/get-agent-job.mdx
@@ -0,0 +1,19 @@
+---
+openapi: GET /agent/{domain}/job/{id}
+---
+
+
+ ## 用法
+
+
+此端点可通过唯一标识符获取特定代理任务的详细信息与状态。可用于查看之前创建的代理任务的进度、状态和结果。
+
+
+ ## 作业详情
+
+
+响应包含以下信息：
+
+- 作业执行状态与完成情况
+- branch 信息与拉取请求（PR；亦称“合并请求”/Merge Request）详情
+- 会话 metadata 与时间戳
\ No newline at end of file
diff --git a/zh/api-reference/agent/get-all-jobs.mdx b/zh/api-reference/agent/get-all-jobs.mdx
new file mode 100644
index 000000000..3c0edd0ff
--- /dev/null
+++ b/zh/api-reference/agent/get-all-jobs.mdx
@@ -0,0 +1,15 @@
+---
+openapi: GET /agent/{domain}/jobs
+---
+
+
+ ## 用法
+
+
+此端点会检索指定 domain 的所有代理任务，提供代理活动及其当前状态的总体概览。适用于监控和管理并发或历史的多项代理任务。
+
+
+ ## 响应
+
+
+使用此端点获取所有以往代理会话的完整概览。
\ No newline at end of file