Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 0 additions & 20 deletions es/ai/agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,26 +17,6 @@ Usa el agente para:
* Buscar y actualizar contenido existente
* Responder preguntas sobre tu documentación y temas de redacción técnica

<div id="use-the-agent-in-the-dashboard">
## Usa el agente en el dashboard
</div>

Accede al panel del agente directamente desde tu dashboard usando el atajo de teclado <kbd>⌘</kbd>+<kbd>I</kbd> (Mac) o <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux), o haciendo clic en el botón **Preguntar al agente**.

El panel del agente incluye:

* **Chat**: Envía consultas y recibe respuestas con propuestas de cambios en la documentación.
* **Historial**: Consulta y continúa conversaciones anteriores.
* **Configuración**: Configura los permisos de la Aplicación de GitHub y la integración con Slack.

<Frame>
<img src="/images/agent/dashboard-light.png" alt="El panel del agente en modo claro." className="block dark:hidden" style={{ maxHeight: '500px' }} />

<img src="/images/agent/dashboard-dark.png" alt="El panel del agente en modo oscuro." className="hidden dark:block" style={{ maxHeight: '500px' }} />
</Frame>

Cuando el agente realiza cambios, puedes ver la solicitud de extracción directamente desde el chat o abrir los cambios en el editor web.

<div id="add-the-agent-to-your-slack-workspace">
## Añade el agente a tu espacio de trabajo de Slack
</div>
Expand Down
6 changes: 3 additions & 3 deletions es/api/assistant/create-assistant-message.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ keywords: [ "mensaje del assistant", "incrustar", "chat", "integrar" ]
El hook `useChat` del AI SDK de Vercel es la forma recomendada de integrar la API del assistant en tu aplicación.

<Note>
La API del assistant de Mintlify es compatible con **AI SDK v4**. Si usas AI SDK v5 o posterior, debes configurar un transporte personalizado.
La API del assistant de Mintlify es compatible con **AI SDK v4**. Si utilizas AI SDK v5 o posterior, debes configurar un transporte personalizado.
</Note>

<Steps>
Expand Down Expand Up @@ -59,9 +59,9 @@ function MyComponent({ domain }) {

**Configuración obligatoria para Mintlify:**
- `streamProtocol: 'data'` - Obligatorio para respuestas en streaming.
- `sendExtraMessageFields: true` - Obligatorio para enviar metadata de los mensajes.
- `sendExtraMessageFields: true` - Obligatorio para enviar metadatos de los mensajes.
- `body.fp` - Identificador de huella digital (usa 'anonymous' o un identificador de usuario).
- `body.retrievalPageSize` - Número de resultados de búsqueda a usar (recomendado: 5).
- `body.retrievalPageSize` - Número de resultados de búsqueda que se usarán (recomendado: 5).

</Step>
</Steps>
Expand Down
66 changes: 33 additions & 33 deletions es/discovery-openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"openapi": "3.0.1",
"info": {
"title": "Mintlify Assistant API",
"description": "Una API para integrar las funcionalidades de descubrimiento de Mintlify en tu producto.",
"description": "An API to integrate Mintlify discovery features into your product.",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Spanish translations incorrectly replaced with English text

The Spanish localization file es/discovery-openapi.json has all its translated Spanish description strings replaced with English text. For example, the API description changes from Spanish "Una API para integrar las funcionalidades de descubrimiento de Mintlify en tu producto." to English "An API to integrate Mintlify discovery features into your product." This undoes the localization throughout the entire file, which contradicts the stated purpose of updating translations.

Additional Locations (2)

Fix in Cursor Fix in Web

"version": "1.0.0"
},
"servers": [
Expand All @@ -18,8 +18,8 @@
"paths": {
"/assistant/{domain}/message": {
"post": {
"summary": "Mensaje del assistant",
"description": "Genera un mensaje de respuesta del assistant para el dominio especificado.",
"summary": "Assistant message",
"description": "Generates a response message from the assistant for the specified domain.",
"parameters": [
{
"name": "domain",
Expand All @@ -28,7 +28,7 @@
"schema": {
"type": "string"
},
"description": "El identificador de dominio de tu URL `domain.mintlify.app`. Puedes encontrarlo al final de la URL de tu dashboard. Por ejemplo, en `dashboard.mintlify.com/organization/domain`, el identificador de dominio es `domain`."
"description": "The domain identifier from your `domain.mintlify.app` URL. Can be found at the end of your dashboard URL. For example, `dashboard.mintlify.com/organization/domain` has a domain identifier of `domain`."
}
],
"requestBody": {
Expand All @@ -44,12 +44,12 @@
"properties": {
"fp": {
"type": "string",
"description": "Identificador de huella digital para el seguimiento de sesiones de conversación. Usa `anonymous` para usuarios anónimos o proporciona un identificador de usuario único."
"description": "Fingerprint identifier for tracking conversation sessions. Use 'anonymous' for anonymous users or provide a unique user identifier."
},
"threadId": {
"default": null,
"type": "string",
"description": "Un identificador opcional que se utiliza para mantener la continuidad de la conversación a lo largo de varios mensajes. Cuando se proporciona, permite que el sistema asocie los mensajes posteriores con el mismo hilo de conversación. El threadId se devuelve en la respuesta como event.threadId cuando event.type === 'finish'."
"description": "An optional identifier used to maintain conversation continuity across multiple messages. When provided, it allows the system to associate follow-up messages with the same conversation thread. The threadId is returned in the response as event.threadId when event.type === 'finish'."
},
"messages": {
"type": "array",
Expand All @@ -71,7 +71,7 @@
"properties": {
"id": {
"type": "string",
"description": "Identificador único del mensaje"
"description": "Unique identifier for the message"
},
"role": {
"type": "string",
Expand All @@ -81,21 +81,21 @@
"data",
"user"
],
"description": "El rol del remitente del mensaje"
"description": "The role of the message sender"
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "Marca de tiempo en que se creó el mensaje"
"description": "Timestamp when the message was created"
},
"content": {
"type": "string",
"description": "El contenido del mensaje"
"description": "The content of the message"
},
"annotations": {
"type": "array",
"items": {},
"description": "Arreglo opcional de anotaciones para el mensaje"
"description": "Optional array of annotations for the message"
},
"parts": {
"type": "array",
Expand Down Expand Up @@ -342,7 +342,7 @@
}
]
},
"description": "Array de fragmentos de mensaje de distintos tipos, incluidos texto, razonamiento, fuentes e invocaciones de herramientas"
"description": "Array of message parts with different types including text, reasoning, sources, and tool invocations"
},
"experimental_attachments": {
"type": "array",
Expand All @@ -363,7 +363,7 @@
"url"
]
},
"description": "Arreglo opcional de archivos adjuntos experimentales para el mensaje"
"description": "Optional array of experimental attachments for the message"
}
},
"required": [
Expand All @@ -373,27 +373,27 @@
"parts"
]
},
"description": "Array de mensajes de la conversación. En el frontend, es probable que quieras usar la función handleSubmit del hook useChat del paquete @ai-sdk para agregar los mensajes del usuario y gestionar las respuestas en streaming, en lugar de definir manualmente los objetos de este array, ya que tienen tantos parámetros."
"description": "Array of messages in the conversation. On the frontend, you will likely want to use the handleSubmit function from the @ai-sdk package's useChat hook to append user messages and handle streaming responses, rather than manually defining the objects in this array as they have so many parameters."
},
"retrievalPageSize": {
"type": "number",
"default": 5,
"description": "Número de resultados de búsqueda en la documentación que se utilizarán para generar la respuesta. Valores más altos proporcionan más contexto, pero pueden aumentar el tiempo de respuesta. Recomendado: 5."
"description": "Number of documentation search results to use for generating the response. Higher values provide more context but may increase response time. Recommended: 5."
},
"filter": {
"type": "object",
"default": null,
"properties": {
"version": {
"type": "string",
"description": "Filtro opcional de versión"
"description": "Optional version filter"
},
"language": {
"type": "string",
"description": "Filtro de idioma opcional"
"description": "Optional language filter"
}
},
"description": "Criterios opcionales de filtrado para la búsqueda"
"description": "Optional filter criteria for the search"
}
}
}
Expand All @@ -402,12 +402,12 @@
},
"responses": {
"200": {
"description": "Mensaje generado con éxito",
"description": "Message generated successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "Objeto de respuesta que transmite partes de un flujo de datos con formato con el estado, los encabezados y el contenido especificados. Esto coincide con lo que espera AI SDK, según se documenta en [ai-sdk.dev/docs/ai-sdk-ui/streaming-data](https://ai-sdk.dev/docs/ai-sdk-ui/streaming-data). En lugar de escribir tu propio analizador (parser), se recomienda usar el [hook useChat de ai-sdk, tal como se documenta aquí](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat)."
"description": "Response object that streams formatted data stream parts with the specified status, headers, and content. This matches what is expected from the AI SDK as documented at [ai-sdk.dev/docs/ai-sdk-ui/streaming-data](https://ai-sdk.dev/docs/ai-sdk-ui/streaming-data). Instead of writing your own parser, it is recommended to use the [useChat hook from ai-sdk as documented here](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat)."
}
}
}
Expand All @@ -417,8 +417,8 @@
},
"/search/{domain}": {
"post": {
"summary": "Buscar en la documentación",
"description": "Realiza búsquedas semánticas y de palabras clave en tu documentación con filtros y paginación configurables.",
"summary": "Search documentation",
"description": "Perform semantic and keyword searches across your documentation with configurable filtering and pagination.",
"parameters": [
{
"name": "domain",
Expand All @@ -427,7 +427,7 @@
"schema": {
"type": "string"
},
"description": "El identificador de dominio de tu URL `domain.mintlify.app`. Puedes encontrarlo al final de la URL de tu dashboard. Por ejemplo, `dashboard.mintlify.com/organization/domain` tiene como identificador de dominio `domain`."
"description": "The domain identifier from your `domain.mintlify.app` URL. Can be found at the end of your dashboard URL. For example, `dashboard.mintlify.com/organization/domain` has a domain identifier of `domain`."
}
],
"requestBody": {
Expand All @@ -442,24 +442,24 @@
"properties": {
"query": {
"type": "string",
"description": "La búsqueda que se ejecutará en el contenido de tu documentación."
"description": "The search query to execute against your documentation content."
},
"pageSize": {
"type": "number",
"default": 10,
"description": "Número de resultados de búsqueda que se devolverán. El valor predeterminado es 10 si no se especifica."
"description": "Number of search results to return. Defaults to 10 if not specified."
},
"filter": {
"type": "object",
"description": "Parámetros de filtrado opcionales para refinar los resultados de búsqueda.",
"description": "Optional filtering parameters to narrow search results.",
"properties": {
"version": {
"type": "string",
"description": "Filtrar resultados por versión de la documentación."
"description": "Filter results by documentation version."
},
"language": {
"type": "string",
"description": "Filtra los resultados según el idioma del contenido."
"description": "Filter results by content language."
}
}
}
Expand All @@ -470,7 +470,7 @@
},
"responses": {
"200": {
"description": "Resultados de búsqueda",
"description": "Search results",
"content": {
"application/json": {
"schema": {
Expand All @@ -480,15 +480,15 @@
"properties": {
"content": {
"type": "string",
"description": "El contenido correspondiente de tu documentación."
"description": "The matching content from your documentation."
},
"path": {
"type": "string",
"description": "La ruta o URL del documento de origen."
"description": "The path or URL to the source document."
},
"metadata": {
"type": "object",
"description": "Metadata adicional sobre el resultado de la búsqueda."
"description": "Additional metadata about the search result."
}
}
}
Expand All @@ -505,7 +505,7 @@
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"description": "El encabezado Authorization requiere un token Bearer. Consulta la [documentación de la clave de API del assistant](/docs/api-reference/introduction#assistant-api-key) para obtener más detalles sobre cómo obtener tu clave de API."
"description": "The Authorization header expects a Bearer token. See the [Assistant API Key documentation](/docs/api-reference/introduction#assistant-api-key) for details on how to get your API key."
}
}
}
Expand Down
18 changes: 0 additions & 18 deletions fr/ai/agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,24 +17,6 @@ Utilisez l&#39;agent pour :
* Rechercher et mettre à jour le contenu existant
* Répondre à des questions sur votre documentation et des sujets de rédaction technique

## Utiliser l&#39;agent dans le Dashboard

Accédez au panneau de l&#39;agent directement depuis votre Dashboard à l&#39;aide du raccourci clavier <kbd>⌘</kbd>+<kbd>I</kbd> (Mac) ou <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux), ou en cliquant sur le bouton **Demander à l&#39;agent**.

Le panneau de l&#39;agent comprend :

* **Chat** : Envoyez des requêtes et recevez des réponses avec des propositions de modifications de la documentation.
* **History** : Affichez et poursuivez des conversations précédentes.
* **Settings** : Configurez les autorisations GitHub App et l&#39;intégration à Slack.

<Frame>
<img src="/images/agent/dashboard-light.png" alt="Le panneau de l'agent en mode clair." className="block dark:hidden" style={{ maxHeight: '500px' }} />

<img src="/images/agent/dashboard-dark.png" alt="Le panneau de l'agent en mode sombre." className="hidden dark:block" style={{ maxHeight: '500px' }} />
</Frame>

Lorsque l&#39;agent effectue des modifications, vous pouvez consulter la pull request (demande de fusion) directement depuis le chat ou ouvrir les modifications dans l&#39;éditeur web.

<div id="add-the-agent-to-your-slack-workspace">
## Ajouter l’agent à votre espace de travail Slack
</div>
Expand Down
4 changes: 2 additions & 2 deletions fr/api/assistant/create-assistant-message.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@ keywords: [ "message de l’Assistant", "intégration", "chat", "intégrer" ]
## Intégration avec `useChat`
</div>

La méthode recommandée pour intégrer l’API de l’Assistant à votre application consiste à utiliser le hook `useChat` du SDK AI de Vercel.
Le hook `useChat` du SDK AI de Vercel est la méthode recommandée pour intégrer l’API de l’Assistant à votre application.

<Note>
L’API de l’Assistant Mintlify est compatible avec **AI SDK v4**. Si vous utilisez AI SDK v5 ou une version ultérieure, vous devez configurer un transport personnalisé.
</Note>

<Steps>
<Step title="Installer AI SDK v4">
<Step title="Installer le SDK AI v4">

```bash
npm i ai@^4.1.15
Expand Down
Loading