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
17 changes: 13 additions & 4 deletions es.json
Original file line number Diff line number Diff line change
Expand Up @@ -147,6 +147,7 @@
},
"es/organize/navigation",
"es/ai/contextual-menu",
"es/assistant/narration",
"es/ai/bring-your-own-model",
"es/create/redirects",
"es/organize/mintignore",
Expand Down Expand Up @@ -279,7 +280,17 @@
"pages": [
"es/assistant/index",
"es/assistant/configure",
"es/assistant/customize",
"es/assistant/support-routing",
{
"group": "Mejorar las respuestas",
"pages": [
"es/assistant/sources",
"es/assistant/customize",
"es/assistant/skills"
]
},
"es/assistant/use",
"es/assistant/embed",
{
"group": "Widget",
"hidden": true,
Expand All @@ -288,9 +299,7 @@
"es/assistant/widget"
]
},
"es/assistant/skills",
"es/assistant/narration",
"es/assistant/use"
"es/assistant/billing"
]
},
{
Expand Down
2 changes: 1 addition & 1 deletion es/ai-native.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ La búsqueda de texto completo y la comprensión semántica ayudan a los usuario
Selecciona cualquiera de las siguientes tarjetas para obtener más información.

<CardGroup>
<Card title="Assistant" icon="bot-message-square" href="/es/assistant/configure">
<Card title="Assistant" icon="bot-message-square" href="/es/assistant">
Configura el assistant para buscar en sitios externos o derivar a las personas a tu equipo de soporte si no puede responder sus preguntas.
</Card>

Expand Down
2 changes: 1 addition & 1 deletion es/api/analytics/assistant-thread.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Usos comunes:
Puedes obtener un `threadId` desde cualquiera de las siguientes fuentes:

- El campo `conversationId` de cualquier fila devuelta por [Obtener conversaciones del assistant](/es/api/analytics/assistant-conversations).
- El parámetro de consulta `threadId` que Mintlify añade a la URL de soporte cuando el assistant deriva a tu plataforma de soporte usando la [derivación por enlace](/es/assistant/configure#deflect-to-a-support-link).
- El parámetro de consulta `threadId` que Mintlify añade a la URL de soporte cuando el assistant dirige a los usuarios a tu plataforma de soporte con la opción de soporte [Enlace](/es/assistant/support-routing#link-to-your-help-center).

## Límites de uso

Expand Down
46 changes: 46 additions & 0 deletions es/assistant/billing.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
---
title: "Gestionar la facturación del assistant"
sidebarTitle: "Facturación"
description: "Consulta cuántos créditos usa el assistant de IA, cambia tu nivel de créditos, permite excedentes, configura alertas de uso y usa tu propio modelo."
keywords: ["assistant", "facturación", "créditos", "excedentes", "alertas de uso", "nivel de créditos", "usar tu propio modelo"]
---

<Info>
El assistant requiere un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=assistant).
</Info>

El assistant funciona con créditos. Cada pregunta que el assistant responde cuesta 25 créditos. Si el assistant no encuentra una respuesta en tu documentación y así lo indica, el mensaje no cuesta nada.

Cada plan Pro aporta 10,000 créditos al mes al saldo compartido de créditos de tu organización, que se usa para el assistant, Autopilot y otras funciones basadas en créditos en todos los proyectos. Consulta [Precios por créditos](/es/credits) para obtener más información.

En los planes Enterprise, puedes [usar tu propio modelo](/es/ai/bring-your-own-model) para ejecutar el assistant con tu propio proveedor de LLM y clave de API.

Administra la facturación y el uso en las páginas [Uso](https://app.mintlify.com/settings/organization/usage) y [Facturación](https://app.mintlify.com/settings/organization/billing) de tu dashboard.

<div id="change-your-credit-tier">
## Cambiar tu nivel de créditos
</div>

1. Ve a la página de [Uso](https://app.mintlify.com/settings/organization/usage) de tu dashboard.
2. En la sección **Credit packages**, selecciona un nivel del menú desplegable.
3. Confirma el cambio para continuar al checkout.

<div id="allow-overages">
## Permitir excedentes
</div>

Tu organización comparte los créditos entre proyectos. Por defecto, Mintlify deshabilita los excedentes. Puedes activar o desactivar los excedentes para cada proyecto. Si deshabilitas los excedentes en un proyecto, el assistant deja de estar disponible cuando se agota el saldo compartido de créditos de tu organización. El assistant permanece no disponible hasta que se renueva el saldo de créditos.

Para permitir excedentes, activa el interruptor **Overage** en la tarjeta del proyecto, en la sección **Usage** de la página [Facturación](https://app.mintlify.com/settings/organization/billing) de tu dashboard. Si habilitas los excedentes, cada crédito gastado por encima del saldo compartido incurre en un cargo por excedente. Elige **Limit spend** para establecer un monto máximo de excedentes en dólares, o **No spend limit** para facturar los excedentes sin límite máximo. Cuando un proyecto alcanza su límite de gasto, sus funciones basadas en créditos se pausan hasta el siguiente ciclo de facturación.

<div id="set-usage-alerts">
## Configurar alertas de uso
</div>

En la sección **Usage** de la página [Facturación](https://app.mintlify.com/settings/organization/billing), configura el umbral **Alert** para enviar un correo electrónico a los administradores de tu organización cuando el uso total alcance un cierto porcentaje de su saldo compartido de créditos.

<div id="higher-credit-volumes">
## Volúmenes de créditos más altos
</div>

Para añadir hasta 90,000 créditos al mes, compra un [complemento de créditos](/es/credits#credit-add-ons). Para añadir una cantidad mayor de créditos, [contacta con ventas](https://www.mintlify.com/contact/sales) para hablar de un paquete de créditos personalizado.
136 changes: 17 additions & 119 deletions es/assistant/configure.mdx
Original file line number Diff line number Diff line change
@@ -1,106 +1,22 @@
---
title: "Configurar el assistant"
description: "Configura el assistant de IA: actívalo, dirige las preguntas de soporte a un correo, un enlace o tickets de Plain y Zendesk, añade preguntas iniciales y gestiona la facturación."
keywords: ["assistant", "configuración", "derivación", "tickets de soporte", "Plain", "Zendesk", "protección contra bots", "facturación"]
sidebarTitle: "Configuración"
description: "Activa el assistant de IA, añade preguntas iniciales, habilita la protección contra bots y prueba las respuestas en la vista previa local antes de que las vean los usuarios."
keywords: ["assistant", "configurar", "configuración", "habilitar", "preguntas iniciales", "protección contra bots", "previsualización local"]
---

<Info>
El assistant requiere un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=assistant).
</Info>

Configura el assistant en la página [Assistant](https://app.mintlify.com/products/assistant) de tu dashboard. Administra la facturación y el uso en la página [Uso](https://app.mintlify.com/settings/organization/usage).
Configura el assistant en la página [Assistant](https://app.mintlify.com/products/assistant) de tu dashboard. Después de activarlo y añadir preguntas iniciales, elige a dónde van las preguntas que el assistant no puede responder y, a continuación, pruébalo.

<div id="enable-or-disable-the-assistant">
## Habilitar o deshabilitar el assistant
</div>

En la página [Assistant](https://app.mintlify.com/products/assistant) de tu dashboard, haz clic en el interruptor de estado para habilitar o deshabilitar el assistant en tu sitio.

<div id="set-deflection-emails">
## Configurar correos de derivación
</div>

En la sección Manejo de respuestas, habilita el assistant para invitar a los usuarios a contactar con tus equipos de soporte y ventas cuando no pueda responder por sí solo.

El menú **Support** define a dónde van las preguntas de soporte. Tiene tres opciones: **Email**, **Link** y **Direct support ticketing**. Esta sección trata sobre **Email**.

En el menú **Support**, selecciona **Email** y luego introduce una o ambas direcciones:

- **Support email**: Para preguntas que el assistant no pueda resolver a partir de tu documentación.
- **Ventas**: Para preguntas sobre precios, planes o compras.

Cuando habilitas la derivación y el assistant detecta una pregunta que coincide, aparece un formulario de contacto dentro del chat. El formulario solicita el nombre, los apellidos, la empresa, el correo corporativo y un mensaje del usuario. Mintlify envía la información por correo al equipo correspondiente, que puede responder directamente al correo del usuario.

El mismo formulario de contacto está disponible en el [widget del assistant](/es/assistant/widget) integrado en otros sitios.

<Tip>
Si prefieres dirigir las preguntas de soporte a tus canales existentes, desactiva **Contact form** en la sección Manejo de respuestas.

Cuando desactivas el formulario de contacto, el assistant dirige a los usuarios a tu dirección de correo de soporte como texto plano en lugar de mostrar el formulario dentro del chat. Las preguntas de ventas siguen usando el formulario dentro del chat cuando configuras un correo de ventas.
</Tip>

<div id="deflect-to-a-support-link">
## Desviar a un enlace de soporte
</div>

En el menú **Support**, selecciona **Link** para enviar a los usuarios a tu plataforma de soporte existente (por ejemplo, un centro de ayuda, un portal de tickets o un foro de la comunidad) en lugar de recopilar el correo mediante un formulario dentro del chat.

Introduce la URL completa de tu destino de soporte. La URL debe usar `http` o `https` y no puede incluir credenciales.

Cuando el assistant detecte una pregunta de soporte, mostrará al usuario una tarjeta con un enlace a tu URL de soporte. Mintlify añade el ID del hilo del assistant como parámetro de consulta `threadId` para que tu herramienta de soporte pueda adjuntar la transcripción de la conversación al ticket resultante. Recupera la transcripción con el endpoint [Obtener hilo de conversación del assistant](/es/api/analytics/assistant-thread).

Con **Link** seleccionado, el assistant no muestra el formulario de contacto ni dirige las preguntas de ventas.

<div id="create-tickets-in-your-support-platform">
## Crear tickets en tu plataforma de soporte
</div>

El assistant puede registrar las solicitudes de soporte como tickets en Plain o Zendesk en lugar de enviarlas por correo.

Antes de conectar Plain, crea una clave de API de Plain con estos permisos:

- `customer:create`
- `customer:edit`
- `customer:read`
- `thread:create`
- `thread:read`

1. En la sección **Response handling** del menú **Support**, selecciona **Direct support ticketing**.
2. Selecciona una **Ticketing platform**: **Plain** o **Zendesk**.
3. En la tarjeta de la plataforma, haz clic en **Connect** y completa la conexión en la ventana que se abre. Para Plain, usa la clave de API que creaste.

Mintlify guarda la creación directa de tickets de soporte solo después de que la plataforma se conecte. Hasta entonces, tu opción de soporte actual sigue activa. La conexión es una integración compartida para tu organización.

Cuando el assistant detecta una pregunta de soporte, muestra el formulario de contacto dentro del chat. Mintlify crea un ticket en tu plataforma conectada a partir del envío. El ticket incluye los datos de contacto y el mensaje del usuario, además de hasta los tres primeros mensajes de la conversación con el assistant. Si la conversación es más larga, el ticket enlaza a la conversación completa en tu dashboard.

Si guardaste una dirección de **Ventas** en **Email**, las preguntas de ventas siguen enviándose por correo a esa dirección.

Si a la clave de API de Plain le falta alguno de los permisos requeridos, la tarjeta de la plataforma muestra **Scopes misconfigured**. Haz clic en **Configure** para ver qué permisos faltan y, a continuación, agrégalos a la clave de API en Plain.

<div id="search-domains">
## Dominios de búsqueda
</div>

<Info>
Los dominios de búsqueda requieren un [plan Enterprise](https://mintlify.com/pricing?ref=assistant).
</Info>

En la sección Manejo de respuestas, configura los dominios en los que el assistant puede buscar en la web para encontrar contexto adicional al responder preguntas.

- Los dominios deben ser accesibles públicamente.
- El assistant no puede buscar en dominios que requieran JavaScript para cargar.

Para un control más preciso sobre lo que el assistant puede buscar, usa la sintaxis de filtrado.

- **Filtrado a nivel de dominio**
- `example.com`: Buscar solo en el dominio `example.com`
- `docs.example.com`: Buscar solo en el subdominio `docs.example.com`
- `*.example.com`: Buscar en todos los subdominios de `example.com`
- **Filtrado a nivel de ruta**
- `docs.example.com/api`: Buscar en todas las páginas bajo la subruta `/api`
- **Múltiples patrones**
- Agrega múltiples entradas para apuntar a diferentes secciones de sitios

<div id="add-sample-questions">
## Agregar preguntas de ejemplo
</div>
Expand All @@ -116,6 +32,12 @@ Puedes agregar hasta tres preguntas iniciales. Haz clic en **Ask Assistant** par
<img src="/images/assistant/search-suggestions-dark.png" alt="El panel de sugerencias de búsqueda en el dashboard con preguntas iniciales contextuales habilitadas." className="hidden dark:block" />
</Frame>

<div id="choose-where-unanswered-questions-go">
## Elegir a dónde van las preguntas sin respuesta
</div>

Cuando el assistant no puede responder una pregunta, puede enviar al usuario a tu equipo de soporte o ventas por correo, mediante un enlace a tu centro de ayuda o con un ticket en Plain o Zendesk. Consulta [Dirigir preguntas a tu equipo](/es/assistant/support-routing).

<div id="bot-protection">
## Protección contra bots
</div>
Expand All @@ -133,38 +55,14 @@ Los cambios tardan hasta 10 minutos en propagarse.
Si usas [encabezados de Content Security Policy](/es/deploy/csp-configuration) personalizados, debes incluir `hcaptcha.com` y `*.hcaptcha.com` en tu lista de permitidos.
</Note>

<div id="manage-billing">
## Administrar la facturación
<div id="test-the-assistant">
## Probar el assistant
</div>

El assistant funciona con créditos. Cada pregunta que el assistant responde cuesta 25 créditos. Si el assistant no encuentra una respuesta en tu documentación y así lo indica, el mensaje no cuesta nada. Consulta [Precios por créditos](/es/credits) para obtener más información.
El assistant está disponible en tu previsualización local cuando inicias sesión con la CLI. Usa la previsualización local para probar las respuestas y las instrucciones personalizadas en `Assistant.md` mientras escribes.

En los planes Enterprise, puedes [usar tu propio modelo](/es/ai/bring-your-own-model) para ejecutar el assistant con tu propio proveedor de LLM y clave de API.

<div id="change-your-credit-tier">
### Cambiar tu nivel de créditos
</div>

1. Ve a la página de [Uso](https://app.mintlify.com/settings/organization/usage) de tu dashboard.
2. En la sección **Credit packages**, selecciona un nivel del menú desplegable.
3. Confirma el cambio para continuar al checkout.

<div id="allow-overages">
### Permitir excedentes
</div>

Tu organización comparte los créditos entre proyectos. Por defecto, Mintlify deshabilita los excedentes. Puedes activar o desactivar los excedentes para cada proyecto. Si deshabilitas los excedentes en un proyecto, el assistant deja de estar disponible cuando se agota el saldo compartido de créditos de tu organización. El assistant permanece no disponible hasta que se renueva el saldo de créditos.

Para permitir excedentes, activa el interruptor **Overage** en la tarjeta del proyecto, en la sección **Usage** de la página [Facturación](https://app.mintlify.com/settings/organization/billing) de tu dashboard. Si habilitas los excedentes, cada crédito gastado por encima del saldo compartido incurre en un cargo por excedente. Elige **Limit spend** para establecer un monto máximo de excedentes en dólares, o **No spend limit** para facturar los excedentes sin límite máximo. Cuando un proyecto alcanza su límite de gasto, sus funciones basadas en créditos se pausan hasta el siguiente ciclo de facturación.

<div id="set-usage-alerts">
### Configurar alertas de uso
</div>

En la sección **Usage** de la página [Facturación](https://app.mintlify.com/settings/organization/billing), configura el umbral **Alert** para enviar un correo electrónico a los administradores de tu organización cuando el uso total alcance un cierto porcentaje de su saldo compartido de créditos.

<div id="higher-credit-volumes">
### Volúmenes de créditos más altos
</div>
1. Si aún no lo has hecho, instala la CLI con `npm i -g mint`.
2. Ejecuta `mint login` para autenticarte.
3. Ejecuta `mint dev` para iniciar la previsualización local.

Para añadir hasta 90,000 créditos al mes, compra un [complemento de créditos](/es/credits#credit-add-ons). Para añadir una cantidad mayor de créditos, [contacta con ventas](https://www.mintlify.com/contact/sales) para hablar de un paquete de créditos personalizado.
El assistant en la previsualización local usa el mismo contenido indexado que tu sitio de documentación desplegado.
17 changes: 17 additions & 0 deletions es/assistant/embed.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: "Integrar el assistant en tu producto"
sidebarTitle: "Integrar en tu producto"
description: "Responde las preguntas de los usuarios dentro de tu aplicación, dashboard o portal de soporte creando tu propia interfaz sobre la API del assistant."
keywords: ["assistant", "integrar", "assistant en la aplicación", "API del assistant", "clave de API"]
---

<Info>
El assistant requiere un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=assistant).
</Info>

Lleva el assistant a los lugares donde tus usuarios ya trabajan, como tu aplicación, tu dashboard, tu sitio de marketing o tu portal de soporte. Responde a partir de la misma documentación que el assistant de tu sitio de documentación.

Usa la API del assistant para crear tu propia interfaz con control total sobre su apariencia y comportamiento. Autentícate con una [clave de API del assistant](https://app.mintlify.com/settings/organization/api-keys).

- Sigue [Crear un assistant en la aplicación](/es/guides/assistant-embed) para ver un ejemplo completo con Next.js.
- Consulta [Crear mensaje del assistant](/es/api/assistant/create-assistant-message-v2) y [Buscar en la documentación](/es/api/assistant/search) para ver los endpoints.
Loading
Loading