From e4856c595911caff386dbaf7bae22f2e37daf7c3 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Thu, 18 Dec 2025 01:10:47 +0000 Subject: [PATCH] =?UTF-8?q?Automated=20translation=20to=20=F0=9F=87=AA?= =?UTF-8?q?=F0=9F=87=B8=20from=20Mintlify?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs.json | 128 +++++++++--------- es/api/assistant/create-assistant-message.mdx | 123 +++++++++-------- 2 files changed, 129 insertions(+), 122 deletions(-) diff --git a/docs.json b/docs.json index 9201726c3..63b57f15a 100644 --- a/docs.json +++ b/docs.json @@ -1,22 +1,36 @@ { - "$schema": "https://mintlify.com/docs.json", "theme": "almond", + "$schema": "https://mintlify.com/docs.json", "name": "Mintlify", "colors": { "primary": "#166E3F", "light": "#26BD6C", "dark": "#166E3F" }, + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://mintlify.com/docs" + }, "favicon": "/favicon.ico", - "icons": { - "library": "lucide" + "api": { + "mdx": { + "auth": { + "method": "bearer" + } + } }, - "interaction": { - "drilldown": false + "navbar": { + "primary": { + "type": "button", + "label": "Get started", + "href": "https://mintlify.com/start" + } }, "navigation": { "languages": [ { + "language": "en", "tabs": [ { "tab": "Documentation", @@ -331,10 +345,10 @@ } ] } - ], - "language": "en" + ] }, { + "language": "fr", "tabs": [ { "tab": "Documentation", @@ -649,10 +663,10 @@ } ] } - ], - "language": "fr" + ] }, { + "language": "es", "tabs": [ { "tab": "Documentación", @@ -688,7 +702,7 @@ "es/customize/custom-scripts", "es/customize/react-components", { - "group": "Acceso al dashboard", + "group": "Acceso al panel", "pages": [ "es/dashboard/sso", "es/dashboard/permissions", @@ -759,13 +773,13 @@ ] }, { - "group": "Implementar", + "group": "Desplegar", "icon": "boxes", "pages": [ "es/deploy/deployments", "es/deploy/preview-deployments", { - "group": "subruta /docs", + "group": "Subruta /docs", "pages": [ "es/deploy/docs-subpath", "es/deploy/cloudflare", @@ -794,7 +808,7 @@ "es/ai/slack-bot", "es/ai/contextual-menu", { - "group": "Análisis", + "group": "Insights", "pages": [ "es/insights/overview", "es/insights/feedback" @@ -809,7 +823,7 @@ "group": "Integraciones", "pages": [ { - "group": "Analytics", + "group": "Analíticas", "pages": [ "es/integrations/analytics/overview", "es/integrations/analytics/amplitude", @@ -861,14 +875,14 @@ "tab": "Guías", "groups": [ { - "group": "Descripción general", + "group": "Visión general", "icon": "book-open", "pages": [ "es/guides/index" ] }, { - "group": "IA", + "group": "AI", "icon": "bot", "pages": [ "es/guides/automate-agent", @@ -880,7 +894,7 @@ ] }, { - "group": "Documentación de la API", + "group": "Documentación de API", "icon": "file-json", "pages": [ "es/guides/migrating-from-mdx" @@ -919,17 +933,17 @@ ] }, { - "tab": "Referencia de la API", + "tab": "Referencia de API", "groups": [ { - "group": "Referencia de la API", + "group": "Referencia de API", "icon": "file-json", "pages": [ "es/api/introduction" ] }, { - "group": "Administrador", + "group": "Admin", "icon": "activity", "pages": [ "es/api/update/trigger", @@ -937,7 +951,7 @@ ] }, { - "group": "Agente", + "group": "Agent", "icon": "pen-line", "pages": [ "es/api/agent/create-agent-job", @@ -946,7 +960,7 @@ ] }, { - "group": "assistant", + "group": "Assistant", "icon": "bot-message-square", "pages": [ "es/api/assistant/create-assistant-message", @@ -956,10 +970,10 @@ ] }, { - "tab": "Cambios", + "tab": "Changelog", "groups": [ { - "group": "Cambios", + "group": "Changelog", "icon": "calendar", "pages": [ "es/changelog" @@ -967,10 +981,10 @@ } ] } - ], - "language": "es" + ] }, { + "language": "zh", "tabs": [ { "tab": "文档", @@ -1285,30 +1299,10 @@ } ] } - ], - "language": "zh" + ] } ] }, - "logo": { - "light": "/logo/light.svg", - "dark": "/logo/dark.svg", - "href": "https://mintlify.com/docs" - }, - "api": { - "mdx": { - "auth": { - "method": "bearer" - } - } - }, - "navbar": { - "primary": { - "type": "button", - "label": "Get started", - "href": "https://mintlify.com/start" - } - }, "footer": { "socials": { "x": "https://x.com/mintlify", @@ -1394,17 +1388,16 @@ } ] }, - "thumbnails": { - "background": "/images/thumbnail/background.svg" + "seo": { + "metatags": { + "canonical": "https://www.mintlify.com/docs", + "google-site-verification": "YRuJgIxsRnMkiRTYTo_tEsJSFyIE3AraEiukTbeV4Ag", + "og:locale": "en_US", + "twitter:site": "@mintlify" + } }, - "contextual": { - "options": [ - "copy", - "chatgpt", - "claude", - "cursor", - "vscode" - ] + "icons": { + "library": "lucide" }, "redirects": [ { @@ -1792,12 +1785,19 @@ "apiKey": "phc_l0gu1V19gegCphI9sE7GgmONC5MFx3KmppIFVeqxWrR" } }, - "seo": { - "metatags": { - "canonical": "https://www.mintlify.com/docs", - "google-site-verification": "YRuJgIxsRnMkiRTYTo_tEsJSFyIE3AraEiukTbeV4Ag", - "og:locale": "en_US", - "twitter:site": "@mintlify" - } + "contextual": { + "options": [ + "copy", + "chatgpt", + "claude", + "cursor", + "vscode" + ] + }, + "thumbnails": { + "background": "/images/thumbnail/background.svg" + }, + "interaction": { + "drilldown": false } } \ No newline at end of file diff --git a/es/api/assistant/create-assistant-message.mdx b/es/api/assistant/create-assistant-message.mdx index 66c9eda45..b522887df 100644 --- a/es/api/assistant/create-assistant-message.mdx +++ b/es/api/assistant/create-assistant-message.mdx @@ -1,79 +1,86 @@ --- -openapi: /es/discovery-openapi.json POST /assistant/{domain}/message -keywords: [ "mensaje del assistant", "incrustar", "chat", "integrar" ] +- openapi: /discovery-openapi.json POST /assistant/{domain}/message --- -
- ## Integración con `useChat` -
+## Integración con `useChat` -El hook `useChat` del AI SDK de Vercel es la forma recomendada de integrar la API del assistant en tu aplicación. +El `useChat` hook de Vercel's AI SDK es la forma recomendada para integrar la API del asistente en tu aplicación. - La API del assistant de Mintlify es compatible con **AI SDK v4**. Si utilizas AI SDK v5 o posterior, debes configurar un transporte personalizado. + La API del asistente de Mintlify es compatible con **AI SDK v4**. Si utilizas AI SDK v5 o posterior, debes configurar un transporte personalizado. - + + ```bash + npm i ai@^4.1.15 + ``` + -```bash -npm i ai@^4.1.15 -``` + + ```tsx + import { useChat } from 'ai/react'; - - + function MyComponent({ domain }) { + const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat({ + api: `https://api.mintlify.com/discovery/v1/assistant/${domain}/message`, + headers: { + 'Authorization': `Bearer ${process.env.MINTLIFY_TOKEN}`, + }, + body: { + fp: 'anonymous', + retrievalPageSize: 5, + context: [ + { + type: 'code', + value: 'const example = "code snippet";', + elementId: 'code-block-1', + }, + ], + }, + streamProtocol: 'data', + sendExtraMessageFields: true, + }); -```tsx -import { useChat } from 'ai/react'; + return ( +
+ {messages.map((message) => ( +
+ {message.role === 'user' ? 'User: ' : 'Assistant: '} + {message.content} +
+ ))} +
+ + +
+
+ ); + } + ``` -function MyComponent({ domain }) { - const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat({ - api: `https://api.mintlify.com/discovery/v1/assistant/${domain}/message`, - headers: { - 'Authorization': `Bearer ${process.env.MINTLIFY_TOKEN}`, - }, - body: { - fp: 'anonymous', - retrievalPageSize: 5, - }, - streamProtocol: 'data', - sendExtraMessageFields: true, - }); + **Configuración requerida para Mintlify:** - return ( -
- {messages.map((message) => ( -
- {message.role === 'user' ? 'Usuario: ' : 'Assistant: '} - {message.content} -
- ))} -
- - -
-
- ); -} -``` + * `streamProtocol: 'data'` - Requerido para respuestas en streaming. + * `sendExtraMessageFields: true` - Requerido para enviar metadatos de mensajes. + * `body.fp` - Identificador de huella digital (usa 'anonymous' o un identificador de usuario). + * `body.retrievalPageSize` - Número de resultados de búsqueda a utilizar (recomendado: 5). -**Configuración obligatoria para Mintlify:** -- `streamProtocol: 'data'` - Obligatorio para respuestas en streaming. -- `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 que se usarán (recomendado: 5). + **Configuración opcional:** - + * `body.context` - Array de información contextual para proporcionar al asistente. Cada objeto de contexto contiene: + * `type` - Ya sea `'code'` o `'textSelection'`. + * `value` - El fragmento de código o el contenido de texto seleccionado. + * `elementId` (opcional) - Identificador para el elemento de UI que contiene el contexto. + -Consulta [useChat](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat) en la documentación del AI SDK para obtener más información. +Ver [useChat](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat) en la documentación de AI SDK para más detalles. -
- ## Límites de uso -
+## Límites de uso -La API del assistant tiene los siguientes límites: +La API del asistente 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 \ No newline at end of file +* 10,000 usos por clave por mes +* 10,000 solicitudes por organización de Mintlify por hora +* 10,000 solicitudes por IP por día