diff --git a/es/assistant/customize.mdx b/es/assistant/customize.mdx index 1555fb6e5a..f1f3377459 100644 --- a/es/assistant/customize.mdx +++ b/es/assistant/customize.mdx @@ -14,8 +14,6 @@ Agrega un archivo `.mintlify/Assistant.md` en la raíz de tu proyecto de documen Las instrucciones en un archivo `Assistant.md` se añaden al prompt de sistema del assistant. No reemplazan ni anulan las instrucciones predeterminadas del assistant. -Para orientación profunda y específica de un tema que el assistant debería incorporar solo cuando una pregunta coincida, usa [assistant skills](/es/assistant/skills) en lugar de agregar contenido a `Assistant.md`. - Para eliminar las instrucciones personalizadas, elimina el archivo `Assistant.md`. Usa `Assistant.md` para: @@ -27,6 +25,10 @@ Usa `Assistant.md` para: - Restringir o delimitar las áreas de enfoque del assistant - Proporcionar orientación específica de versión + + Usa los [skills](/es/assistant/skills) del assistant para orientación específica de un tema que el assistant cargará solo cuando un usuario haga una pregunta relacionada. + +
## Ejemplo de archivo `Assistant.md`
diff --git a/es/credits.mdx b/es/credits.mdx index 235dd3da27..b52e34b2a7 100644 --- a/es/credits.mdx +++ b/es/credits.mdx @@ -18,7 +18,7 @@ Para obtener la información de precios más actualizada, consulta la [página d Los créditos están disponibles en el **plan Pro y superiores**. Todos los planes Pro incluyen 10,000 créditos al mes, y puedes comprar créditos adicionales desde la página de [Uso](https://app.mintlify.com/settings/organization/usage) cuando necesites más. -El plan gratuito Starter no incluye funciones de IA ni ofrece una opción para comprar créditos. Para usar el assistant, los agentes del editor y de Slack, o las automatizaciones, actualiza a Pro. +El plan gratuito Starter no incluye funciones de IA. No puedes comprar créditos en el plan Starter. Para usar el assistant, el agente o las automatizaciones, actualiza a Pro o Enterprise. Los clientes con planes de créditos heredados conservan sus paquetes de créditos y precios existentes. Los niveles siguientes se aplican al plan Pro. diff --git a/es/optimize/analytics.mdx b/es/optimize/analytics.mdx index 64ce618230..7eba9448da 100644 --- a/es/optimize/analytics.mdx +++ b/es/optimize/analytics.mdx @@ -81,14 +81,20 @@ La pestaña Assistant muestra un gráfico de barras del uso del assistant a lo l Consulta los Analytics de tu assistant para: * **Supervisar el uso del assistant**: Observa los cambios en el uso del assistant para entender cómo tus usuarios interactúan con tu contenido. -* **Identificar las categorías frecuentes**: Usa las categorías con mayor frecuencia de aparición para entender qué temas son más importantes para tus usuarios. Identifica brechas en la cobertura y prioriza las actualizaciones de contenido. +* **Identificar temas frecuentes**: Usa los temas y las categorías con mayor frecuencia de aparición para entender qué es más importante para tus usuarios. Identifica brechas en la cobertura y prioriza las actualizaciones de contenido. +* **Encontrar dónde tienen dificultades los usuarios**: Usa el sentimiento para ver qué temas reciben comentarios negativos y prioriza mejorar ese contenido. * **Revisar el historial de chat**: Obtén datos detallados de alta intención sobre cómo tus usuarios perciben tu producto revisando su historial de chat con el assistant. Observa qué términos usan, en qué necesitan ayuda y qué tareas intentan realizar.
### Categorías
-La Tab de categorías usa LLMs para agrupar automáticamente las conversaciones por tema o temática. +La Tab de categorías asigna automáticamente a cada conversación una categoría granular y, a continuación, agrupa las categorías relacionadas bajo un tema más amplio. La categorización agrupa las conversaciones por tema independientemente del idioma. + +Cada tema y categoría muestra: + +- **Ocurrencia**: Cuántas conversaciones contiene. +- **Sentimiento**: Recuento de pulgares arriba y pulgares abajo a partir de los comentarios de los usuarios sobre las respuestas del assistant. La Tab de categorías en la página de Analytics del assistant. @@ -96,9 +102,9 @@ La Tab de categorías usa LLMs para agrupar automáticamente las conversaciones La Tab de categorías en la página de Analytics del assistant. -Usa las categorías para identificar temas comunes, patrones en las necesidades y el comportamiento de los usuarios, y áreas donde la documentación podría necesitar ampliación o aclaración. +Usa los temas para identificar los asuntos comunes y los patrones en las necesidades de los usuarios. Usa las categorías para localizar problemas puntuales, como una tarea específica sobre la que los usuarios preguntan repetidamente o una página que genera comentarios negativos. -Haz clic en una fila de categoría para expandirla y ver las conversaciones relacionadas agrupadas bajo esa categoría. +Haz clic en una fila de tema para expandirla y ver sus categorías. Haz clic en una categoría para ver las conversaciones relacionadas. Haz clic en una conversación individual para ver todo el hilo de chat, incluida la pregunta del usuario, la respuesta del assistant y cualquier fuente citada. diff --git a/es/optimize/feedback.mdx b/es/optimize/feedback.mdx index 01f699b842..47e5ca8787 100644 --- a/es/optimize/feedback.mdx +++ b/es/optimize/feedback.mdx @@ -31,7 +31,7 @@ Consulta los comentarios en la página de Analytics en tu dashboard. - Los comentarios contextuales y sobre fragmentos de código están en versión beta. Para habilitarlos en tu sitio de documentación, [contacta a nuestro equipo de ventas](mailto:gtm@mintlify.com). + Los comentarios contextuales y sobre fragmentos de código requieren un [plan Enterprise](https://www.mintlify.com/pricing?ref=feedback). La pestaña de comentarios muestra información según los [Add-ons de comentarios](https://dashboard.mintlify.com/products/addons) que habilites. diff --git a/es/organize/settings-reference.mdx b/es/organize/settings-reference.mdx index e8e9ec91a1..9bf0eea04d 100644 --- a/es/organize/settings-reference.mdx +++ b/es/organize/settings-reference.mdx @@ -686,6 +686,10 @@ Variables de contenido globales reemplazadas en tiempo de compilación usando la **Tipo:** object—pares clave-valor donde las claves son nombres de variables (alfanuméricos y guiones únicamente) y los valores son cadenas de reemplazo. + + La sustitución de variables solo se aplica a páginas MDX y snippets. No se aplica a los archivos de especificación OpenAPI (`.yaml`, `.yml`, `.json`) ni a otros recursos estáticos. + + --- ### `metadata` diff --git a/fr/assistant/customize.mdx b/fr/assistant/customize.mdx index ab4611d1c1..4a33507d82 100644 --- a/fr/assistant/customize.mdx +++ b/fr/assistant/customize.mdx @@ -14,8 +14,6 @@ Ajoutez un fichier `.mintlify/Assistant.md` à la racine de votre projet de docu Les instructions dans un fichier `Assistant.md` s'ajoutent au prompt système de l'assistant. Elles ne remplacent ni ne substituent les instructions par défaut de l'assistant. -Pour des conseils approfondis et spécifiques à un sujet que l'assistant ne doit charger que lorsqu'une question correspond, utilisez les [skills de l'assistant](/fr/assistant/skills) plutôt que d'ajouter du contenu à `Assistant.md`. - Pour supprimer les instructions personnalisées, supprimez le fichier `Assistant.md`. Utilisez `Assistant.md` pour : @@ -27,6 +25,10 @@ Utilisez `Assistant.md` pour : - Restreindre ou délimiter les domaines d'expertise de l'assistant - Fournir des conseils spécifiques à une version + + Utilisez les [skills](/fr/assistant/skills) de l'assistant pour des conseils spécifiques à un sujet que l'assistant ne chargera que lorsqu'un utilisateur posera une question associée. + +
## Exemple de fichier `Assistant.md`
diff --git a/fr/credits.mdx b/fr/credits.mdx index 48c2ea950b..1b21390309 100644 --- a/fr/credits.mdx +++ b/fr/credits.mdx @@ -18,7 +18,7 @@ Pour les informations tarifaires les plus à jour, consultez la [page Tarifs](ht Les crédits sont disponibles sur le **forfait Pro et supérieurs**. Chaque forfait Pro inclut 10 000 crédits par mois, et vous pouvez acheter des crédits supplémentaires depuis la page [Utilisation](https://app.mintlify.com/settings/organization/usage) dès que vous en avez besoin. -Le forfait gratuit Starter n'inclut pas de fonctionnalités d'IA et ne propose aucune option d'achat de crédits. Pour utiliser l'assistant, les agents de l'éditeur et de Slack, ou les automatisations, passez au forfait Pro. +Le forfait gratuit Starter n'inclut pas de fonctionnalités d'IA. Vous ne pouvez pas acheter de crédits sur le forfait Starter. Pour utiliser l'assistant, l'agent ou les automatisations, passez au forfait Pro ou Enterprise. Les clients disposant de forfaits de crédits hérités conservent leurs forfaits de crédits et tarifs existants. Les paliers ci-dessous s'appliquent au forfait Pro. diff --git a/fr/optimize/analytics.mdx b/fr/optimize/analytics.mdx index b953434661..e30de17350 100644 --- a/fr/optimize/analytics.mdx +++ b/fr/optimize/analytics.mdx @@ -82,14 +82,20 @@ L'onglet Assistant affiche un graphique en barres de l'utilisation de l& Examinez vos Analytics de l'Assistant pour : * **Surveiller l'utilisation de l'Assistant** : Observez les évolutions de l'utilisation de l'Assistant pour comprendre comment vos utilisateurs interagissent avec votre contenu. -* **Identifier les catégories fréquentes** : Utilisez les catégories à forte fréquence pour comprendre quels sujets sont les plus importants pour vos utilisateurs. Identifiez les lacunes dans la couverture et priorisez les mises à jour de contenu. +* **Identifier les sujets fréquents** : Utilisez les thèmes et catégories à forte fréquence pour comprendre quels sujets sont les plus importants pour vos utilisateurs. Identifiez les lacunes dans la couverture et priorisez les mises à jour de contenu. +* **Repérer où les utilisateurs rencontrent des difficultés** : Utilisez le sentiment pour identifier les sujets qui reçoivent des retours négatifs et priorisez l'amélioration de ce contenu. * **Examiner l'historique des conversations** : Obtenez des données détaillées à forte intention sur la façon dont vos utilisateurs perçoivent votre produit en analysant l'historique de leurs échanges avec l'Assistant. Voyez quels termes ils utilisent, sur quoi ils ont besoin d'aide et quelles tâches ils essaient d'accomplir.
### Catégories
-L’onglet Catégories utilise des LLM pour regrouper automatiquement les conversations par sujet ou par thème. +L’onglet Catégories attribue automatiquement une catégorie granulaire à chaque conversation, puis regroupe les catégories associées sous un thème plus large. La catégorisation regroupe les conversations par sujet, indépendamment de la langue. + +Chaque thème et catégorie affiche : + +- **Occurrence** : le nombre de conversations qu’il contient. +- **Sentiment** : le nombre de pouces levés et de pouces baissés issus des retours des utilisateurs sur les réponses de l’Assistant. L’onglet Catégories dans la page Analytics de l’Assistant. @@ -97,9 +103,9 @@ L’onglet Catégories utilise des LLM pour regrouper automatiquement les conver L’onglet Catégories dans la page Analytics de l’Assistant. -Utilisez les catégories pour identifier les sujets récurrents, les tendances dans les besoins et comportements des utilisateurs, ainsi que les sections de la documentation qui pourraient nécessiter un enrichissement ou une clarification. +Utilisez les thèmes pour identifier les sujets récurrents et les tendances dans les besoins des utilisateurs. Utilisez les catégories pour repérer des problèmes ciblés, comme une tâche spécifique sur laquelle les utilisateurs reviennent régulièrement ou une page qui génère des retours négatifs. -Cliquez sur une ligne de catégorie pour la déplier et afficher les conversations associées regroupées sous cette catégorie. +Cliquez sur une ligne de thème pour la déplier et afficher ses catégories. Cliquez sur une catégorie pour afficher les conversations associées. Cliquez sur une conversation donnée pour afficher l’intégralité du fil de discussion, y compris la question de l’utilisateur, la réponse de l’Assistant et toutes les sources citées. diff --git a/fr/optimize/feedback.mdx b/fr/optimize/feedback.mdx index 58e7ead783..f39424d0a9 100644 --- a/fr/optimize/feedback.mdx +++ b/fr/optimize/feedback.mdx @@ -32,7 +32,7 @@ Consultez les commentaires sur la page Analytics de votre Dashboard. - Les feedbacks contextuels et sur les extraits de code sont en bêta. Pour les activer sur votre site de documentation, [contactez notre équipe commerciale](mailto:gtm@mintlify.com). + Les feedbacks contextuels et sur les extraits de code nécessitent un [forfait Enterprise](https://www.mintlify.com/pricing?ref=feedback). L'onglet Feedback affiche des informations en fonction des [modules complémentaires de feedback](https://dashboard.mintlify.com/products/addons) que vous activez. diff --git a/fr/organize/settings-reference.mdx b/fr/organize/settings-reference.mdx index 29a813ac3b..4b8202e7d0 100644 --- a/fr/organize/settings-reference.mdx +++ b/fr/organize/settings-reference.mdx @@ -686,6 +686,10 @@ Variables de contenu globales remplacées au moment de la compilation en utilisa **Type :** object—paires clé-valeur où les clés sont des noms de variables (alphanumériques et tirets uniquement) et les valeurs sont des chaînes de remplacement. + + La substitution de variables ne s'applique qu'aux pages MDX et aux snippets. Elle ne s'applique pas aux fichiers de spécification OpenAPI (`.yaml`, `.yml`, `.json`) ni aux autres ressources statiques. + + --- ### `metadata` diff --git a/zh/assistant/customize.mdx b/zh/assistant/customize.mdx index 718c652048..47cd005eb8 100644 --- a/zh/assistant/customize.mdx +++ b/zh/assistant/customize.mdx @@ -14,8 +14,6 @@ keywords: ["assistant", "自定义指令", "Assistant.md", "系统提示", "角 `Assistant.md` 文件中的指令会添加到 AI 助手的系统提示中。它们不会替换或覆盖 AI 助手的默认指令。 -对于 AI 助手仅在问题匹配时才应引入的、面向特定主题的深入指导,请使用 [assistant skills](/zh/assistant/skills),而不是将内容加入 `Assistant.md`。 - 要删除自定义指令,请删除 `Assistant.md` 文件。 使用 `Assistant.md` 可以: @@ -27,6 +25,10 @@ keywords: ["assistant", "自定义指令", "Assistant.md", "系统提示", "角 - 限定或界定 AI 助手的关注领域 - 提供特定版本的指导 + + 使用 AI 助手的 [skills](/zh/assistant/skills) 提供面向特定主题的指导,AI 助手仅在用户提出相关问题时才会加载它们。 + +
## `Assistant.md` 文件示例
diff --git a/zh/credits.mdx b/zh/credits.mdx index dc883413b9..af95bad5f1 100644 --- a/zh/credits.mdx +++ b/zh/credits.mdx @@ -18,7 +18,7 @@ keywords: ["积分", "计费", "定价", "AI 聊天", "消息", "套餐", "用 积分在 **Pro 及更高方案**中提供。每个 Pro 方案每月包含 10,000 个积分,当你需要更多时,可从[用量](https://app.mintlify.com/settings/organization/usage)页面购买额外积分。 -免费的 Starter 方案不包含 AI 功能,也没有购买积分的途径。要使用助手、编辑器和 Slack 代理或自动化,请升级到 Pro。 +免费的 Starter 方案不包含 AI 功能。你无法在 Starter 方案上购买积分。要使用助手、代理或自动化,请升级到 Pro 或 Enterprise。 使用旧版积分方案的客户将保留其现有的积分套餐和价格。以下等级适用于 Pro 方案。 diff --git a/zh/optimize/analytics.mdx b/zh/optimize/analytics.mdx index 64c59b40a3..00c51df177 100644 --- a/zh/optimize/analytics.mdx +++ b/zh/optimize/analytics.mdx @@ -81,14 +81,20 @@ AI 助手标签页显示一张展示 AI 助手随时间使用情况的柱状图 查看 AI 助手分析数据以: * **监控 AI 助手使用情况**:观察 AI 助手使用情况的变化,以了解用户如何与您的内容进行交互。 -* **识别高频类别**:利用高频出现的类别来理解哪些主题对您的用户最重要。识别覆盖空白并优先更新相关内容。 +* **识别高频主题**:利用高频出现的主题和类别来理解哪些主题对您的用户最重要。识别覆盖空白并优先更新相关内容。 +* **找出用户遇到困难的地方**:利用情感分析查看哪些主题收到负面反馈,并优先改进相关内容。 * **查看聊天记录**:通过审查用户与 AI 助手的聊天记录,获取关于用户如何看待您的产品的高意向详细数据。了解他们使用的术语、需要帮助的内容以及尝试完成的任务。
### 分类
-“分类”标签页使用 LLM 来按主题或话题自动归类会话。 +“分类”标签页会自动为每个会话分配一个细粒度类别,然后将相关类别归入更宽泛的主题。分类会按主题对会话进行分组,与语言无关。 + +每个主题和类别都会显示: + +- **出现次数**:其包含的会话数量。 +- **情感**:用户对 AI 助手回答的“赞”和“踩”反馈计数。 AI 助手 Analytics 页面中的“分类”标签页。 @@ -96,9 +102,9 @@ AI 助手标签页显示一张展示 AI 助手随时间使用情况的柱状图 AI 助手 Analytics 页面中的“分类”标签页。 -使用分类来识别常见主题、用户需求和行为模式,以及文档中可能需要扩充或澄清的部分。 +使用主题来识别常见话题以及用户需求中的模式。使用类别来发现具体问题,例如用户反复询问的某项特定任务,或产生负面反馈的某个页面。 -点击某个分类行将其展开,并查看归入该分类的相关会话。 +点击某个主题行将其展开以查看其类别。点击某个类别以查看相关会话。 点击单个会话可查看完整聊天记录,包括用户的问题、AI 助手的回答,以及引用的所有来源。 diff --git a/zh/optimize/feedback.mdx b/zh/optimize/feedback.mdx index 55dcb25b0b..f80fe71811 100644 --- a/zh/optimize/feedback.mdx +++ b/zh/optimize/feedback.mdx @@ -32,7 +32,7 @@ boost: 3 - 上下文反馈和代码片段反馈目前处于测试版 (Beta) 阶段。要为你的文档站点启用它们,请[联系销售团队](mailto:gtm@mintlify.com)。 + 上下文反馈和代码片段反馈需要 [Enterprise 方案](https://www.mintlify.com/pricing?ref=feedback)。 反馈标签页会根据你启用的[反馈附加组件](https://dashboard.mintlify.com/products/addons)显示相应信息。 diff --git a/zh/organize/settings-reference.mdx b/zh/organize/settings-reference.mdx index 77e42a35ec..dde433fe38 100644 --- a/zh/organize/settings-reference.mdx +++ b/zh/organize/settings-reference.mdx @@ -451,6 +451,10 @@ keywords: ["docs.json", "schema", "参考", "配置", "所有设置", "属性", **类型:** object—键是变量名(仅限字母数字和连字符),值是替换字符串。 + + 变量替换仅适用于 MDX 页面和 snippets。它不适用于 OpenAPI 规范文件(`.yaml`、`.yml`、`.json`)或其他静态资源。 + + --- ### `metadata`