diff --git a/docs.json b/docs.json index 07533c096..436b3e0fb 100644 --- a/docs.json +++ b/docs.json @@ -468,6 +468,7 @@ "fr/agent/index", "fr/agent/slack", "fr/agent/linear", + "fr/agent/notion", "fr/agent/customize", "fr/agent/effective-prompts", "fr/agent/workflows" @@ -838,6 +839,7 @@ "es/agent/index", "es/agent/slack", "es/agent/linear", + "es/agent/notion", "es/agent/customize", "es/agent/effective-prompts", "es/agent/workflows" @@ -1208,6 +1210,7 @@ "zh/agent/index", "zh/agent/slack", "zh/agent/linear", + "zh/agent/notion", "zh/agent/customize", "zh/agent/effective-prompts", "zh/agent/workflows" diff --git a/es/agent/index.mdx b/es/agent/index.mdx index 1e694cf7a..2c64d4c35 100644 --- a/es/agent/index.mdx +++ b/es/agent/index.mdx @@ -56,6 +56,9 @@ El agente solo puede acceder a los repositorios que conectes mediante la Aplicac Añade el agente a tu espacio de trabajo de Linear. + + Otorga al agente acceso a tu espacio de trabajo de Notion. + Configura el agente con un archivo `AGENTS.md`. diff --git a/es/agent/linear.mdx b/es/agent/linear.mdx index 90848551c..f7cc15397 100644 --- a/es/agent/linear.mdx +++ b/es/agent/linear.mdx @@ -13,8 +13,8 @@ Conecta tu espacio de trabajo de Linear al agente para realizar actualizaciones 1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard. 2. En la sección "Agent settings", haz clic en **Install Linear app**. - La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear. - La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear. + La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion. + La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion. 3. Sigue las indicaciones de Linear para autorizar la aplicación de Mintlify en tu espacio de trabajo. diff --git a/es/agent/notion.mdx b/es/agent/notion.mdx new file mode 100644 index 000000000..cfe9000ae --- /dev/null +++ b/es/agent/notion.mdx @@ -0,0 +1,50 @@ +--- +title: "Conectar Notion al agente" +description: "Otorga al agente acceso a tu espacio de trabajo de Notion para que consulte páginas y bases de datos al actualizar la documentación." +keywords: ["Notion", "integration", "knowledge base", "context"] +--- + +Conecta tu espacio de trabajo de Notion al agente para que pueda buscar en tu contenido de Notion y usarlo como contexto al crear actualizaciones de documentación. El contexto adicional proveniente de la base de conocimiento de tu equipo, las especificaciones de producto y la documentación interna almacenada en Notion ayuda al agente a crear documentación más precisa y completa. + +
+ ## Conecta tu espacio de trabajo de Notion +
+ +1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard. +2. En la sección "Agent settings", haz clic en **Install Notion app**. + + La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion. + La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion. + +3. Sigue las indicaciones para autorizar a Mintlify a acceder a tu espacio de trabajo de Notion. +4. En la pantalla de autorización de Notion, selecciona qué páginas y bases de datos compartir con Mintlify. + +
+ ## Qué puede hacer el agente con Notion +
+ +La integración con Notion utiliza las [herramientas MCP](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) de Notion para buscar y leer el contenido de tu espacio de trabajo. + +Tu contenido en Notion se convierte en contexto adicional para que el agente lo use al generar documentación. + +Cuando el agente tiene acceso a tu espacio de trabajo de Notion, puede: + +- **Buscar en Notion**: Encontrar páginas y bases de datos relevantes en tu espacio de trabajo de Notion conectado, según el contexto de tu solicitud. +- **Leer páginas de Notion**: Acceder al contenido de las páginas de Notion para usarlo como material de referencia al generar documentación. +- **Consultar bases de datos**: Obtener datos estructurados de las bases de datos de Notion para informar las actualizaciones de documentación. + +
+ ## Casos de uso +
+ +- **Sincronizar especificaciones de producto con la documentación**: Consultar documentos de requisitos de producto y especificaciones de diseño almacenados en Notion al redactar documentación de funcionalidades. +- **Documentar a partir de notas de reuniones**: Indicar al agente notas de reuniones o registros de decisiones en Notion para redactar documentación basada en las discusiones del equipo. +- **Consultar bases de conocimiento internas**: Usar wikis internos y bases de conocimiento en Notion como material de referencia para la documentación pública. + +
+ ## Mejores prácticas +
+ +- **Delimita el acceso cuidadosamente**: Otorga acceso solo a las páginas y bases de datos de Notion que contengan información relevante para tu documentación. +- **Proporciona referencias específicas**: Al dar instrucciones al agente, menciona la página o base de datos de Notion específica que deseas que consulte para obtener mejores resultados. +- **Revisa el contenido generado**: Siempre revisa las solicitudes de extracción para asegurarte de que la información de Notion se haya adaptado adecuadamente para tu documentación pública. diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 8c1482da6..ab4bd4e29 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -15,8 +15,8 @@ keywords: ["Integración con Slack", "Bot de Slack", "Colaboración en equipo", 1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard. 2. En la sección "Agent settings", haz clic en **Install Slack app**. - La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear. - La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear. + La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion. + La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion. 3. Sigue las indicaciones de Slack para instalar la app `mintlify` en tu espacio de trabajo. 4. Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack. diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx index a4f7e439a..6c124d719 100644 --- a/fr/agent/index.mdx +++ b/fr/agent/index.mdx @@ -56,6 +56,9 @@ L’agent ne peut accéder qu’aux dépôts que vous connectez via la GitHub Ap Ajoutez l'agent à votre espace de travail Linear. + + Donnez à l'agent accès à votre espace de travail Notion. + Configurez l'agent avec un fichier `AGENTS.md`. diff --git a/fr/agent/linear.mdx b/fr/agent/linear.mdx index d27eda521..71824ff88 100644 --- a/fr/agent/linear.mdx +++ b/fr/agent/linear.mdx @@ -13,8 +13,8 @@ Connectez votre espace de travail Linear à l'agent pour effectuer des mises à 1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard. 2. Dans la section "Agent settings", cliquez sur **Install Linear app**. - La section des paramètres d'application avec les boutons d'installation de Slack et Linear. - La section des paramètres d'application avec les boutons d'installation de Slack et Linear. + La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion. + La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion. 3. Suivez les instructions de Linear pour autoriser l'application Mintlify dans votre espace de travail. diff --git a/fr/agent/notion.mdx b/fr/agent/notion.mdx new file mode 100644 index 000000000..86c03a70f --- /dev/null +++ b/fr/agent/notion.mdx @@ -0,0 +1,50 @@ +--- +title: "Connecter Notion à l'agent" +description: "Donnez à l'agent accès à votre espace de travail Notion pour qu'il puisse consulter des pages et des bases de données lors de la mise à jour de la documentation." +keywords: ["Notion", "integration", "knowledge base", "context"] +--- + +Connectez votre espace de travail Notion à l'agent pour qu'il puisse rechercher dans votre contenu Notion et l'utiliser comme contexte lors de la création de mises à jour de documentation. Le contexte supplémentaire provenant de la base de connaissances de votre équipe, des spécifications produit et de la documentation interne stockée dans Notion aide l'agent à créer une documentation plus précise et complète. + +
+ ## Connectez votre espace de travail Notion +
+ +1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard. +2. Dans la section "Agent settings", cliquez sur **Install Notion app**. + + La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion. + La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion. + +3. Suivez les instructions pour autoriser Mintlify à accéder à votre espace de travail Notion. +4. Sur l'écran d'autorisation de Notion, sélectionnez les pages et les bases de données à partager avec Mintlify. + +
+ ## Ce que l'agent peut faire avec Notion +
+ +L'intégration Notion utilise les [outils MCP](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) de Notion pour rechercher et lire le contenu de votre espace de travail. + +Votre contenu dans Notion devient un contexte supplémentaire que l'agent peut utiliser lors de la génération de documentation. + +Lorsque l'agent a accès à votre espace de travail Notion, il peut : + +- **Rechercher dans Notion** : Trouver des pages et des bases de données pertinentes dans votre espace de travail Notion connecté, en fonction du contexte de votre demande. +- **Lire des pages Notion** : Accéder au contenu des pages Notion pour l'utiliser comme matériel de référence lors de la génération de documentation. +- **Consulter des bases de données** : Extraire des données structurées des bases de données Notion pour alimenter les mises à jour de documentation. + +
+ ## Cas d'utilisation +
+ +- **Synchroniser les spécifications produit avec la documentation** : Consulter les documents d'exigences produit et les spécifications de conception stockés dans Notion lors de la rédaction de la documentation des fonctionnalités. +- **Documenter à partir de notes de réunion** : Indiquer à l'agent des notes de réunion ou des journaux de décisions dans Notion pour rédiger de la documentation à partir des discussions de l'équipe. +- **S'appuyer sur les bases de connaissances internes** : Utiliser les wikis internes et les bases de connaissances dans Notion comme matériel source pour la documentation destinée au public. + +
+ ## Bonnes pratiques +
+ +- **Délimitez l'accès avec soin** : N'accordez l'accès qu'aux pages et bases de données Notion contenant des informations pertinentes pour votre documentation. +- **Fournissez des références spécifiques** : Lorsque vous donnez des instructions à l'agent, mentionnez la page ou la base de données Notion spécifique que vous souhaitez qu'il consulte pour obtenir de meilleurs résultats. +- **Relisez le contenu généré** : Relisez toujours les pull requests (demandes de fusion) pour vous assurer que les informations provenant de Notion ont été correctement adaptées pour votre documentation publique. diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index bc8b75f19..78425fab9 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -15,8 +15,8 @@ keywords: ["Intégration Slack", "Bot Slack", "Collaboration d'équipe", "Intég 1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard. 2. Dans la section "Agent settings", cliquez sur **Install Slack app**. - La section des paramètres d'application avec les boutons d'installation de Slack et Linear. - La section des paramètres d'application avec les boutons d'installation de Slack et Linear. + La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion. + La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion. 3. Suivez les instructions Slack pour installer l'application `mintlify` dans votre espace de travail. 4. Suivez les instructions Slack pour lier votre compte Mintlify à votre espace de travail Slack. diff --git a/zh/agent/index.mdx b/zh/agent/index.mdx index f644f9654..ee18042d1 100644 --- a/zh/agent/index.mdx +++ b/zh/agent/index.mdx @@ -56,6 +56,9 @@ Agent 只能访问你通过 Mintlify GitHub 应用连接的仓库。你可以在 将 agent 添加到你的 Linear 工作区。 + + 为 agent 授予对你的 Notion 工作区的访问权限。 + 使用 `AGENTS.md` 文件配置 agent。 diff --git a/zh/agent/linear.mdx b/zh/agent/linear.mdx index 0b5c1a2f1..0c52573d7 100644 --- a/zh/agent/linear.mdx +++ b/zh/agent/linear.mdx @@ -13,8 +13,8 @@ keywords: ["issue tracking", "project management"] 1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。 2. 在 "Agent settings" 部分，点击 **Install Linear app**。 - 应用设置区域，包含 Slack 和 Linear 安装按钮。 - 应用设置区域，包含 Slack 和 Linear 安装按钮。 + 应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。 + 应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。 3. 按照 Linear 的提示授权 Mintlify 应用访问你的工作区。 diff --git a/zh/agent/notion.mdx b/zh/agent/notion.mdx new file mode 100644 index 000000000..4b051a385 --- /dev/null +++ b/zh/agent/notion.mdx @@ -0,0 +1,50 @@ +--- +title: "将 Notion 连接到 agent" +description: "为 agent 授予对你的 Notion 工作区的访问权限，以便在更新文档时引用页面和数据库。" +keywords: ["Notion", "integration", "knowledge base", "context"] +--- + +将你的 Notion 工作区连接到 agent，使其能够搜索你的 Notion 内容，并在创建文档更新时将其用作上下文。来自团队知识库、产品规格说明和存储在 Notion 中的内部文档的额外上下文，有助于 agent 创建更准确、更完整的文档。 + +
+ ## 连接你的 Notion 工作区 +
+ +1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。 +2. 在 "Agent settings" 部分，点击 **Install Notion app**。 + + 应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。 + 应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。 + +3. 按照提示授权 Mintlify 访问你的 Notion 工作区。 +4. 在 Notion 的授权页面上，选择要与 Mintlify 共享的页面和数据库。 + +
+ ## agent 可以用 Notion 做什么 +
+ +Notion 集成使用 Notion 的 [MCP 工具](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) 来搜索和读取你工作区中的内容。 + +你在 Notion 中的内容将成为 agent 生成文档时可使用的额外上下文。 + +当 agent 可以访问你的 Notion 工作区时，它可以： + +- **搜索 Notion**：根据你请求的上下文，在已连接的 Notion 工作区中查找相关页面和数据库。 +- **阅读 Notion 页面**：访问 Notion 页面的内容，将其作为生成文档时的参考资料。 +- **查询数据库**：从 Notion 数据库中提取结构化数据，为文档更新提供依据。 + +
+ ## 使用场景 +
+ +- **将产品规格同步到文档**：在编写功能文档时，引用存储在 Notion 中的产品需求文档和设计规格。 +- **根据会议记录编写文档**：将 agent 指向 Notion 中的会议记录或决策日志，基于团队讨论起草文档。 +- **利用内部知识库**：将 Notion 中的内部 wiki 和知识库作为面向公众的文档的素材来源。 + +
+ ## 最佳实践 +
+ +- **谨慎控制访问范围**：仅授予 agent 对包含与你文档相关信息的 Notion 页面和数据库的访问权限。 +- **提供具体引用**：在给 agent 下达指令时，提及你希望它参考的具体 Notion 页面或数据库，以获得最佳效果。 +- **审查生成的内容**：始终审查拉取请求，确保来自 Notion 的信息已被恰当地调整，适用于你的公开文档。 diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx index 9d7f8ca5d..0ae9b7309 100644 --- a/zh/agent/slack.mdx +++ b/zh/agent/slack.mdx @@ -15,8 +15,8 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", " 1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。 2. 在 "Agent settings" 部分，点击 **Install Slack app**。 - 应用设置区域，包含 Slack 和 Linear 安装按钮。 - 应用设置区域，包含 Slack 和 Linear 安装按钮。 + 应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。 + 应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。 3. 按照 Slack 的提示将 `mintlify` 应用安装到你的工作区。 4. 按照 Slack 的提示将你的 Mintlify 账户关联到你的 Slack 工作区。