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
114 changes: 86 additions & 28 deletions es/agent/workflows.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ Cuando se ejecuta un flujo de trabajo, el agente clona los repositorios especifi
Cada flujo de trabajo puede ejecutarse hasta 50 veces al día. Las ejecuciones que fallan no cuentan para este límite.

<Tip>
Usa flujos de trabajo que se ejecutan según una programación para automatizar tareas recurrentes, como publicar registros de cambios o comprobar problemas de gramática y estilo.
Usa flujos de trabajo que se ejecutan según una programación para automatizar tareas recurrentes, como publicar registros de cambios o comprobar problemas de gramática y estilo.

Usa flujos de trabajo que se ejecutan en eventos de push para automatizar tareas de mantenimiento reactivas, como actualizar referencias de API o identificar actualizaciones de documentación necesarias para nuevas funciones.
Usa flujos de trabajo que se ejecutan en eventos de push para automatizar tareas de mantenimiento reactivas, como actualizar referencias de API o identificar actualizaciones de documentación necesarias para nuevas funciones.
</Tip>

<div id="create-a-workflow">
Expand All @@ -31,27 +31,28 @@ Usa flujos de trabajo que se ejecutan en eventos de push para automatizar tareas

1. Abre la página [Workflows](https://dashboard.mintlify.com/products/workflows) en tu dashboard.
2. Haz clic en **New workflow**.
3. Configura el disparador, el prompt y otros ajustes, luego haz clic en **Create workflow**.
3. Configura el disparador, la instrucción y otros ajustes, luego haz clic en **Create workflow**.

<Frame>
<img src="/images/agent/new-workflow-light.png" alt="La página de configuración del nuevo flujo de trabajo." className="block dark:hidden" />
<img src="/images/agent/new-workflow-dark.png" alt="La página de configuración del nuevo flujo de trabajo." className="hidden dark:block" />
<img src="/images/agent/new-workflow-light.png" alt="La página de configuración del nuevo flujo de trabajo." className="block dark:hidden" />

<img src="/images/agent/new-workflow-dark.png" alt="La página de configuración del nuevo flujo de trabajo." className="hidden dark:block" />
</Frame>

<div id="create-a-workflow-file-with-the-cli">
### Crear un archivo de flujo de trabajo con la CLI
### Crea un archivo de flujo de trabajo con la CLI
</div>

Si tienes la [CLI de Mintlify](/es/installation) instalada, ejecuta el siguiente comando desde tu repositorio de documentación para crear un archivo de flujo de trabajo de forma interactiva en la CLI.
Si tienes instalada la [CLI de Mintlify](/es/installation), ejecuta el siguiente comando desde tu repositorio de documentación para crear de forma interactiva un archivo de flujo de trabajo en la CLI.

```bash
mint workflow
```

La CLI te solicita información sobre el flujo de trabajo y crea un archivo `.md` en el directorio `.mintlify/workflows/`. Haz commit y push del archivo para activar el flujo de trabajo.
La CLI te pide información sobre el flujo de trabajo y crea un archivo `.md` en el directorio `.mintlify/workflows/`. Haz commit y push del archivo para activar el flujo de trabajo.

<Tip>
Si ejecutas `mint workflow` en un entorno no interactivo como un pipeline de CI/CD o un agente de codificación con IA, la CLI devuelve instrucciones de uso y el formato del archivo de flujo de trabajo en lugar de prompts interactivos.
Si ejecutas `mint workflow` en un entorno no interactivo, como un pipeline de CI/CD o un agente de programación con IA, la CLI devuelve instrucciones de uso y el formato del archivo del flujo de trabajo en lugar de solicitudes interactivas.
</Tip>

<div id="add-a-workflow-file-to-your-repository">
Expand Down Expand Up @@ -85,18 +86,20 @@ Success criteria: Someone who reads the changelog knows the most up to date info
## Campos de frontmatter
</div>

| Campo | Obligatorio | Descripción |
|-------|-------------|-------------|
| `name` | Sí | Nombre visible que se muestra en el Dashboard de Mintlify. |
| `on` | Sí | Configuración del desencadenador. |
| `context` | No | Repositorios clonados como referencia cuando se ejecuta el flujo de trabajo. |
| `automerge` | No | El valor predeterminado es `false`, lo que abre una solicitud de extracción para revisión. Si es `true`, abre una solicitud de extracción y la fusiona automáticamente. |
| Campo | Obligatorio | Descripción |
| ----------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Sí | Nombre para mostrar que se muestra en el dashboard. |
| `on` | Sí | Configuración del disparador. |
| `context` | No | Repositorios clonados como referencia cuando se ejecuta el flujo de trabajo. |
| `automerge` | No | El valor predeterminado es `false`, lo que abre una solicitud de extracción para revisión. Si es `true`, abre una solicitud de extracción y la fusiona automáticamente. |
| `notify` | No | Configuración de notificaciones. Envía mensajes de Slack cuando se completen los flujos de trabajo. |

Debes tener la Aplicación de GitHub de Mintlify instalada en cada repositorio indicado en los campos `context` o `on.push.repo`. Agrega nuevos repositorios en la página de la [Aplicación de GitHub](https://dashboard.mintlify.com/settings/organization/github-app) de tu Dashboard de Mintlify.
Debes tener instalada la aplicación de GitHub de Mintlify en cada repositorio enumerado en los campos `context` o `on.push.repo`. Agrega nuevos repositorios en la página de la [aplicación de GitHub](https://dashboard.mintlify.com/settings/organization/github-app) de tu dashboard de Mintlify.

<Frame>
<img src="/images/github/app-repos-light.png" alt="La página de la Aplicación de GitHub que muestra repositorios conectados para dos organizaciones." className="block dark:hidden" />
<img src="/images/github/app-repos-dark.png" alt="La página de la Aplicación de GitHub que muestra repositorios conectados para dos organizaciones en modo oscuro." className="hidden dark:block" />
<img src="/images/github/app-repos-light.png" alt="La página de la aplicación de GitHub que muestra los repositorios conectados de dos organizaciones." className="block dark:hidden" />

<img src="/images/github/app-repos-dark.png" alt="La página de la aplicación de GitHub que muestra los repositorios conectados de dos organizaciones en modo oscuro." className="hidden dark:block" />
</Frame>

<div id="triggers">
Expand Down Expand Up @@ -152,7 +155,6 @@ on:
branch: release
```


<div id="context-repositories">
### Repositorios de contexto
</div>
Expand All @@ -169,22 +171,52 @@ context:
### Combinación automática de cambios
</div>

De forma predeterminada, el agente abre una solicitud de extracción por cada ejecución del flujo de trabajo para que puedas revisar los cambios antes de que se publiquen. Establece `automerge: true` para fusionar automáticamente la solicitud de extracción sin requerir aprobación manual. Esto te proporciona un registro de los cambios en el historial de solicitudes de extracción de tu repositorio mientras automatiza el paso de fusión.
De forma predeterminada, el agente abre una solicitud de extracción por cada ejecución del flujo de trabajo para que puedas revisar los cambios antes de que se publiquen. Establece `automerge: true` para fusionar automáticamente la solicitud de extracción sin necesidad de aprobación manual. Esto te proporciona un registro de los cambios en el historial de solicitudes de extracción de tu repositorio, a la vez que automatiza el paso de fusión.

```yaml
automerge: true
```

<div id="slack-notifications">
### Notificaciones de Slack
</div>

Envía mensajes de Slack cuando un flujo de trabajo finalice o falle. Las notificaciones incluyen el estado del flujo de trabajo, un enlace a la solicitud de extracción y un resumen de los cambios.

```yaml
notify:
slack:
channels:
- documentation
- dev-updates
users:
- alice
- bob
```

Puedes especificar los destinos de las notificaciones por nombre o por ID:

| Campo | Descripción |
| ------------- | --------------------------------------------------------------------------------------------- |
| `channels` | Nombres de canales a los que notificar (con o sin el prefijo `#`). |
| `channel_ids` | ID de los canales a los que notificar. |
| `users` | Nombres de usuario, nombres para mostrar o nombres reales a los que enviar mensajes directos. |
| `user_ids` | ID de usuario de Slack a los que enviar mensajes directos. |

<Note>
Las notificaciones de Slack requieren que Slack esté instalado en tu organización. Conecta Slack desde la página de [integración de Slack](https://dashboard.mintlify.com/settings/organization/integrations/slack) de tu dashboard.
</Note>

<div id="prompts">
## Prompts
</div>

Los prompts eficaces se centran en una sola tarea y buscan un resultado concreto. Los flujos de trabajo siempre presentan cierta variabilidad debido a la naturaleza no determinista de los agentes, pero puedes mejorar la consistencia de sus resultados siguiendo estas buenas prácticas:

- Describe el resultado que quieres que el agente consiga.
- Incluye criterios de éxito.
- Especifica el contexto que quieres que el agente utilice.
- Divide las tareas complejas en pasos o en varios flujos de trabajo.
* Describe el resultado que quieres que el agente consiga.
* Incluye criterios de éxito.
* Especifica el contexto que quieres que el agente utilice.
* Divide las tareas complejas en pasos o en varios flujos de trabajo.

<div id="agent-environment">
### Entorno del agente
Expand Down Expand Up @@ -241,7 +273,6 @@ Criterios de éxito: Tras leer la documentación nueva o actualizada, los usuari
- Mantén el estilo y la estructura de las páginas de documentación existentes.
```


<div id="style-audit">
### Auditoría de estilo
</div>
Expand Down Expand Up @@ -272,7 +303,6 @@ Success criteria:
- Skip any files in language subdirectories (`es/`, `fr/`, `zh/`).
```


<div id="update-api-reference">
### Actualizar la referencia de la API
</div>
Expand Down Expand Up @@ -329,8 +359,9 @@ Success criteria: Any discrepancies between the English and translated files are
- If a translated file does not exist, flag it as missing rather than out of sync.
- Group findings by language, then by how far out of date they are (most stale first).
```
<div id="style-audit">
### Auditoría de estilo

<div id="seo-and-metadata-audit">
### Auditoría de SEO y metadata
</div>

Se ejecuta semanalmente para comprobar si hay páginas con metadata faltante o deficiente y abrir una solicitud de extracción con mejoras. Este flujo de trabajo de ejemplo comprueba si falta el frontmatter `description`. Edita el flujo de trabajo para comprobar otros problemas de metadata o contenido que consideres prioritarios para tu documentación.
Expand All @@ -357,3 +388,30 @@ Criterios de éxito: Todas las páginas tienen descripciones actualizadas que re
- Solo actualiza el frontmatter. No modifiques el contenido de la página.
- Si todas las páginas tienen metadata completa y razonable, no hagas nada.
```

<div id="changelog-with-notifications">
### Registro de cambios con notificaciones
</div>

Se ejecuta semanalmente para generar un registro de cambios y notificar a tu equipo en Slack cuando se complete el flujo de trabajo. Este ejemplo muestra cómo combinar flujos de trabajo programados con notificaciones en Slack.

```markdown .mintlify/workflows/changelog-with-notify.md
---
name: Weekly changelog
on:
cron: "0 9 * * 1"
context:
- repo: your-org/your-product
automerge: false
notify:
slack:
channels:
- documentation
users:
- tech-writer
---

Review all merged PRs in `your-org/your-product` from the past week. Draft a changelog entry summarizing new features, bug fixes, and breaking changes.

Success criteria: The changelog accurately reflects the week's changes and is ready for review.
```
4 changes: 2 additions & 2 deletions es/installation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -260,13 +260,13 @@ Indica un nombre de archivo (por ejemplo, `./openapi.yaml`) o una URL (por ejemp
### Crear un flujo de trabajo
</div>

Crea un archivo de [flujo de trabajo](/es/agent/workflows) de forma interactiva con el siguiente comando:
Crea un archivo de [flujo de trabajo](/es/agent/workflows) de manera interactiva con el siguiente comando:

```bash
mint workflow
```

La CLI te solicita un nombre, un tipo de disparador y otros ajustes, y luego crea un archivo `.md` en `.mintlify/workflows/`.
La CLI te pedirá un nombre, un tipo de desencadenador y otras opciones de configuración, y luego creará un archivo `.md` en `.mintlify/workflows/`.

<div id="rename-files">
### Renombrar archivos
Expand Down
Loading
Loading