diff --git a/ai/model-context-protocol.mdx b/ai/model-context-protocol.mdx index 71da1a161..5e70b37dc 100644 --- a/ai/model-context-protocol.mdx +++ b/ai/model-context-protocol.mdx @@ -26,12 +26,17 @@ When an AI application connects to your documentation MCP server, it can search ### Search filtering parameters -The MCP search tool supports optional filtering parameters that AI applications can use to narrow search results. +The MCP search tool supports optional filtering parameters that AI applications can use to narrow search results. The available parameters adapt dynamically based on your documentation. -- **`version`**: Filter results to a specific documentation version. For example, `'v0.7'`. Only returns content tagged with the specified version or content available across all versions. -- **`language`**: Filter results to a specific language code. For example, `'en'`, `'zh'`, or `'es'`. Only returns content in the specified language or content available across all languages. +**Always available:** +- **`apiReferenceOnly`**: Only return API reference docs. +- **`codeOnly`**: Only return code snippets. -AI applications determine when to apply these filters based on the context of the user's query. For example, if a user asks about a specific API version, the AI application may automatically apply the appropriate filter to provide more relevant results. +**Available when configured:** +- **`version`**: Filter results to a specific documentation version (e.g., `'v0.7'`). Only available when your documentation uses [versions](/organize/versions). Only returns content tagged with the specified version or content available across all versions. +- **`language`**: Filter results to a specific language code (e.g., `'en'`, `'zh'`, or `'es'`). Only available when your documentation uses [languages](/organize/languages). Only returns content in the specified language or content available across all languages. + +The MCP search tool schema dynamically includes only the parameters applicable to your deployment. AI applications determine when to apply these filters based on the context of the user's query. ### MCP compared to web search diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx index 3174a9e28..be71fd8ef 100644 --- a/es/ai/model-context-protocol.mdx +++ b/es/ai/model-context-protocol.mdx @@ -32,12 +32,17 @@ Cuando una aplicación de IA se conecta a tu servidor MCP de documentación, pue ### Parámetros de filtrado de búsqueda -La herramienta de búsqueda de Model Context Protocol (MCP) admite parámetros de filtrado opcionales que las aplicaciones de IA pueden usar para acotar los resultados de búsqueda. +La herramienta de búsqueda de Model Context Protocol (MCP) admite parámetros de filtrado opcionales que las aplicaciones de IA pueden usar para acotar los resultados de búsqueda. Los parámetros disponibles se adaptan dinámicamente según la configuración de tu documentación. -* **`version`**: Filtra los resultados a una versión específica de la documentación. Por ejemplo, `'v0.7'`. Solo devuelve contenido etiquetado con la versión especificada o contenido disponible en todas las versiones. -* **`language`**: Filtra los resultados a un código de idioma específico. Por ejemplo, `'en'`, `'zh'` o `'es'`. Solo devuelve contenido en el idioma especificado o contenido disponible en todos los idiomas. +**Siempre disponibles:** +* **`apiReferenceOnly`**: Solo devuelve documentación de referencia de API. +* **`codeOnly`**: Solo devuelve fragmentos de código. -Las aplicaciones de IA determinan cuándo aplicar estos filtros según el contexto de la búsqueda del usuario. Por ejemplo, si un usuario pregunta por una versión específica de la API, la aplicación de IA puede aplicar automáticamente el filtro adecuado para proporcionar resultados más relevantes. +**Disponibles cuando están configurados:** +* **`version`**: Filtra los resultados a una versión específica de la documentación (por ejemplo, `'v0.7'`). Solo disponible cuando tu documentación usa [versiones](/es/organize/versions). Solo devuelve contenido etiquetado con la versión especificada o contenido disponible en todas las versiones. +* **`language`**: Filtra los resultados a un código de idioma específico (por ejemplo, `'en'`, `'zh'` o `'es'`). Solo disponible cuando tu documentación usa [idiomas](/es/organize/languages). Solo devuelve contenido en el idioma especificado o contenido disponible en todos los idiomas. + +El esquema de la herramienta de búsqueda de MCP incluye dinámicamente solo los parámetros aplicables a tu implementación. Las aplicaciones de IA determinan cuándo aplicar estos filtros según el contexto de la búsqueda del usuario. -L'outil de recherche MCP prend en charge des paramètres de filtrage optionnels que les applications d'IA peuvent utiliser pour affiner les résultats de recherche. +L'outil de recherche MCP prend en charge des paramètres de filtrage optionnels que les applications d'IA peuvent utiliser pour affiner les résultats de recherche. Les paramètres disponibles s'adaptent dynamiquement en fonction de la configuration de votre documentation. -* **`version`** : Filtre les résultats pour une version spécifique de la documentation. Par exemple, `'v0.7'`. Ne renvoie que le contenu marqué avec la version spécifiée ou le contenu disponible pour toutes les versions. -* **`language`** : Filtre les résultats pour un code de langue spécifique. Par exemple, `'en'`, `'zh'` ou `'es'`. Ne renvoie que le contenu dans la langue spécifiée ou le contenu disponible dans toutes les langues. +**Toujours disponibles :** +* **`apiReferenceOnly`** : Ne renvoie que la documentation de référence de l'API. +* **`codeOnly`** : Ne renvoie que les extraits de code. -Les applications d'IA déterminent quand appliquer ces filtres en fonction du contexte de la requête de l'utilisateur. Par exemple, si un utilisateur pose une question sur une version spécifique d'une API, l'application d'IA peut appliquer automatiquement le filtre approprié pour fournir des résultats plus pertinents. +**Disponibles lorsqu'ils sont configurés :** +* **`version`** : Filtre les résultats pour une version spécifique de la documentation (par exemple, `'v0.7'`). Disponible uniquement lorsque votre documentation utilise des [versions](/fr/organize/versions). Ne renvoie que le contenu marqué avec la version spécifiée ou le contenu disponible pour toutes les versions. +* **`language`** : Filtre les résultats pour un code de langue spécifique (par exemple, `'en'`, `'zh'` ou `'es'`). Disponible uniquement lorsque votre documentation utilise des [langues](/fr/organize/languages). Ne renvoie que le contenu dans la langue spécifiée ou le contenu disponible dans toutes les langues. + +Le schéma de l'outil de recherche MCP inclut dynamiquement uniquement les paramètres applicables à votre déploiement. Les applications d'IA déterminent quand appliquer ces filtres en fonction du contexte de la requête de l'utilisateur. -MCP 搜索工具支持可选的筛选参数，AI 应用可以使用它们来缩小搜索结果范围。 +MCP 搜索工具支持可选的筛选参数，AI 应用可以使用它们来缩小搜索结果范围。可用参数会根据你的文档配置动态调整。 -- **`version`**：将结果筛选为特定的文档版本。例如，`'v0.7'`。只返回带有指定版本标签的内容，或在所有版本中通用的内容。 -- **`language`**：将结果筛选为特定的语言代码。例如，`'en'`、`'zh'` 或 `'es'`。只返回指定语言的内容，或在所有语言中通用的内容。 +**始终可用：** +- **`apiReferenceOnly`**：仅返回 API 参考文档。 +- **`codeOnly`**：仅返回代码片段。 -AI 应用会根据用户查询的上下文来决定何时应用这些筛选条件。例如，如果用户询问特定 API 版本，AI 应用可能会自动应用相应的筛选条件，以提供更相关的结果。 +**配置后可用：** +- **`version`**：将结果筛选为特定的文档版本（例如 `'v0.7'`）。仅当你的文档使用[版本](/zh/organize/versions)时可用。只返回带有指定版本标签的内容，或在所有版本中通用的内容。 +- **`language`**：将结果筛选为特定的语言代码（例如 `'en'`、`'zh'` 或 `'es'`）。仅当你的文档使用[语言](/zh/organize/languages)时可用。只返回指定语言的内容，或在所有语言中通用的内容。 + +MCP 搜索工具架构会动态包含仅适用于你的部署的参数。AI 应用会根据用户查询的上下文来决定何时应用这些筛选条件。