Skip to content
Closed
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
4 changes: 4 additions & 0 deletions es/agent/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Usa el agente para:
* Actualizar documentación existente con nuevas funcionalidades o cambios en la API.
* Procesar e incluir imágenes, diagramas y otros archivos a partir de archivos adjuntos de Slack.
* Buscar y revisar ejemplos de código y referencias de API en toda tu documentación.
* Automatizar el mantenimiento de la documentación con flujos de trabajo.
* Responder preguntas sobre tu documentación y temas de redacción técnica.
* Atender comentarios de revisión de código para mantener la calidad de la documentación.
* Capturar conocimiento de conversaciones en Slack y solicitudes de extracción antes de que se pierda.
Expand Down Expand Up @@ -64,4 +65,7 @@ Usa el agente para:

<Card title="Escribir prompts eficaces" horizontal icon="pen" href="/es/agent/effective-prompts">
Obtén mejores resultados con prompts más específicos.
</Card>
<Card title="Automatizar con flujos de trabajo" horizontal icon="refresh-cw" href="/es/agent/workflows">
Automatiza tareas recurrentes y el mantenimiento de la documentación con flujos de trabajo.
</Card>
8 changes: 8 additions & 0 deletions es/agent/use-cases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,14 @@ Proporciona al agente los comentarios de tus usuarios para realizar actualizacio

Por ejemplo: `@mintlify Users are getting confused by step 3 in the setup guide. What might be making it unclear?`.

<div id="automate-with-workflows">
## Automatizar con flujos de trabajo
</div>

Crea flujos de trabajo para automatizar tareas recurrentes y tareas de mantenimiento reactivo como escribir changelogs o actualizar contenido cuando se agregan nuevas funcionalidades a tu producto.

Consulta [Flujos de trabajo](/es/agent/workflows) para obtener más información.

<div id="automate-with-the-api">
## Automatiza con la API
</div>
Expand Down
112 changes: 72 additions & 40 deletions es/agent/workflows.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,47 @@
title: "Flujos de trabajo"
description: "Automatiza el mantenimiento de la documentación con tareas del agente programadas o activadas por eventos."
keywords: ["automation", "automate", "cron", "auto-update"]
tag: "Beta"
---

<Info>
Los flujos de trabajo están en beta. Ponte en contacto con nosotros directamente para habilitarlos.
Los flujos de trabajo están en beta. Actualmente están disponibles en los [planes Enterprise](https://mintlify.com/pricing).

[Contáctanos](mailto:gtm@mintlify.com) para habilitar flujos de trabajo para tu organización.
</Info>

Los flujos de trabajo ejecutan el agente automáticamente de forma programada o cuando se realiza un push a un repositorio que especifiques. Cada flujo de trabajo define una instrucción para el agente y un disparador que indica cuándo ejecutarlo.
Los flujos de trabajo ejecutan el agente automáticamente de forma programada o cuando se realiza un push a un repositorio. Cada flujo de trabajo define una instrucción para el agente y un disparador que indica cuándo ejecutarlo.

Cuando se ejecuta un flujo de trabajo, el agente clona los repositorios especificados como contexto, sigue la instrucción y abre una solicitud de extracción o hace push directamente de los cambios a tu rama de implementación.

<div id="create-a-workflow-file">
## Crear un archivo de flujo de trabajo
Puedes tener hasta 10 flujos de trabajo activos. Cada flujo de trabajo puede ejecutarse hasta 20 veces al día. Las ejecuciones fallidas no cuentan para este límite.

<Tip>
Usa flujos de trabajo que se ejecutan según un horario para automatizar tareas recurrentes como publicar changelogs o verificar problemas de gramática y estilo.

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

<div id="create-a-workflow">
## Crear un flujo de trabajo
</div>

<div id="create-a-workflow-in-the-dashboard">
### Crear un flujo de trabajo en el dashboard
</div>

En la página de [Flujos de trabajo](https://dashboard.mintlify.com/products/workflows) de tu dashboard, haz clic en el botón **New workflow**.

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

<div id="add-a-workflow-file-to-your-repository">
### Agregar un archivo de flujo de trabajo a tu repositorio
</div>

Crea archivos `.md` en un directorio `.mintlify/workflows/` en la raíz de tu repositorio de documentación. Cada archivo define un flujo de trabajo.
Crea un archivo `.md` para cada flujo de trabajo en un directorio `.mintlify/workflows/` en la raíz de tu repositorio de documentación. Cada archivo define un flujo de trabajo.

Los archivos de flujo de trabajo usan frontmatter YAML para configurar el flujo de trabajo, seguido de un prompt en Markdown para el agente.

Expand All @@ -41,7 +67,7 @@ Success criteria: Someone who reads the changelog knows the most up to date info


<div id="frontmatter-fields">
### Campos de frontmatter
## Campos de frontmatter
</div>

| Campo | Obligatorio | Descripción |
Expand All @@ -59,13 +85,13 @@ Debes tener la Aplicación de GitHub de Mintlify instalada en cada repositorio i
</Frame>

<div id="triggers">
## Disparadores
### Disparadores
</div>

Cada flujo de trabajo debe definir un único disparador mediante el campo `on`.

<div id="on-schedule-cron">
### Según programación (cron)
#### Según programación (cron)
</div>

Ejecuta un flujo de trabajo de forma recurrente usando una expresión cron. Todas las ejecuciones programadas se realizan en UTC.
Expand All @@ -86,8 +112,8 @@ El campo value es una expresión cron estándar de 5 campos con el formato `minu
| `"0 8 * * 1-5"` | Días laborables a las 8:00 AM UTC |


<div id="on-merge">
### Al hacer merge
<div id="on-push-events">
#### En eventos push
</div>

Ejecuta un flujo de trabajo cuando se fusiona una solicitud de extracción en un repositorio y branch específicos.
Expand All @@ -113,8 +139,8 @@ on:
```


<div id="reference-repositories">
## Repositorios de referencia
<div id="context-repositories">
### Repositorios de contexto
</div>

Usa `context` para conceder al agente acceso de lectura a repositorios adicionales cuando se ejecuta el flujo de trabajo. Esto es útil cuando tu prompt requiere revisar código o contenido fuera de tu repositorio de documentación.
Expand All @@ -127,7 +153,7 @@ context:


<div id="auto-merge-changes">
## Combinación automática de cambios
### 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 enviar los cambios directamente a tu rama de implementación sin una solicitud de extracción.
Expand All @@ -152,65 +178,71 @@ Los prompts eficaces se centran en una sola tarea y buscan un resultado concreto
## Ejemplos de flujos de trabajo
</div>

<div id="style-audit">
### Auditoría de estilo
<div id="draft-documentation-for-new-features">
### Borrador de documentación para nuevas funcionalidades
</div>

Se ejecuta cuando se fusiona una solicitud de extracción de documentación para detectar violaciones de la guía de estilo antes de que se acumulen. Este flujo de trabajo de ejemplo corrige automáticamente las violaciones de la guía de estilo y enumera en el cuerpo de la solicitud de extracción aquellas que requieren criterio humano.
<Tip>
Si usas sugerencias del agente en tu dashboard, este flujo de trabajo replica ese comportamiento.

Agrega este flujo de trabajo con cualquier modificación para tu proyecto para redactar documentación automáticamente a medida que agregas nuevas funcionalidades a tu producto.
</Tip>

```markdown .mintlify/workflows/style-audit.md
Se ejecuta cuando las solicitudes de extracción se fusionan en el repositorio de tu producto para identificar las actualizaciones de documentación necesarias para cualquier nueva funcionalidad o API que se haya introducido.

```markdown .mintlify/workflows/draft-feature-docs.md
---
name: Style audit
name: Draft docs for new features
on:
push:
- repo: your-org/your-docs
- repo: your-org/your-product
branch: main
context:
- repo: your-org/your-docs
automerge: false
---

Review all MDX files changed in the last merged PR against the style guide at `path/to/style-guide`.
Review the diff from the last merged PR in `your-org/your-product`. Identify any new features, APIs, or other changes that require documentation.

Open a pull request to resolve any style violations that can be fixed automatically. For any edits that require judgment or nuance, note them in the PR body with the specific lines, rule violations, and suggested fixes.
For each new addition, draft documentation updates that explain what it does, when to use it, and how to configure it. Include a code example where relevant.

Success criteria:
- All style violations have a proposed resolution.
- No new style violations are introduced.
Success criteria: After reading any new or updated documentation, users understand what the feature is, if it applies to tasks they do, and how to use it.

## Important

- Do not change content meaning. Only correct style violations.
- Skip any files in language subdirectories (`es/`, `fr/`, `zh/`).
- Only document changes that affect end users. Skip internal refactors or dependency updates.
- Match the style and structure of existing docs pages.
```


<div id="draft-documentation-for-new-features">
### Borrador de documentación para nuevas funcionalidades
<div id="style-audit">
### Auditoría de estilo
</div>

Se ejecuta cuando las solicitudes de extracción se fusionan en el repositorio de tu producto para identificar las actualizaciones de documentación necesarias para cualquier nueva funcionalidad o API que se haya introducido.
Se ejecuta cuando se fusiona una solicitud de extracción de documentación para detectar violaciones de la guía de estilo antes de que se acumulen. Este flujo de trabajo de ejemplo corrige automáticamente las violaciones de la guía de estilo y enumera en el cuerpo de la solicitud de extracción aquellas que requieren criterio humano.

```markdown .mintlify/workflows/draft-feature-docs.md
```markdown .mintlify/workflows/style-audit.md
---
name: Borrador de documentación para nuevas funciones
name: Style audit
on:
push:
- repo: your-org/your-product
- repo: your-org/your-docs
branch: main
context:
- repo: your-org/your-docs
automerge: false
---

Revisa el diff del último PR fusionado en `your-org/your-product`. Identifica cualquier nueva función, API u otros cambios que requieran documentación.
Review all MDX files changed in the last merged PR against the style guide at `path/to/style-guide`.

Para cada nueva incorporación, redacta actualizaciones de documentación que expliquen qué hace, cuándo usarla y cómo configurarla. Incluye un ejemplo de código donde sea relevante.
Open a pull request to resolve any style violations that can be fixed automatically. For any edits that require judgment or nuance, note them in the PR body with the specific lines, rule violations, and suggested fixes.

Criterios de éxito: Tras leer la documentación nueva o actualizada, los usuarios comprenden qué es la función, si se aplica a las tareas que realizan y cómo usarla.
Success criteria:
- All style violations have a proposed resolution.
- No new style violations are introduced.

## Importante
## Important

- Documenta solo los cambios que afecten a los usuarios finales. Omite refactorizaciones internas o actualizaciones de dependencias.
- Mantén el estilo y la estructura de las páginas de documentación existentes.
- Do not change content meaning. Only correct style violations.
- Skip any files in language subdirectories (`es/`, `fr/`, `zh/`).
```


Expand Down
54 changes: 29 additions & 25 deletions fr/agent/index.mdx
Original file line number Diff line number Diff line change
@@ -1,67 +1,71 @@
---
title: "Qu'est-ce que l'agent ?"
title: "Qu'est-ce que l'agent ?"
description: "Automatisez les mises à jour de la documentation avec l'agent. Créez des mises à jour à partir de messages Slack, de pull requests ou d'appels d'API."
keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"]
---

<Info>
L&#39;agent est disponible sur les [plans Enterprise](https://mintlify.com/pricing?ref=agent) pour toute personne ayant accès à votre Dashboard.
L'agent est disponible sur les [plans Enterprise](https://mintlify.com/pricing?ref=agent) pour toute personne ayant accès à votre Dashboard.
</Info>

L&#39;agent est un outil d&#39;IA qui crée des pull requests (demandes de fusion) avec des modifications proposées pour votre documentation, en fonction de vos instructions. Lorsque vous envoyez une requête, l&#39;agent :
L'agent est un outil d'IA qui crée des pull requests (demandes de fusion) avec des modifications proposées pour votre documentation, en fonction de vos instructions. Lorsque vous envoyez une requête, l'agent :

* **Recherche** : analyse votre documentation existante, les dépôts connectés et le contexte pertinent.
* **Planifie** : crée une liste de tâches structurée pour les travaux de documentation complexes.
* **Rédige** : génère ou met à jour du contenu en suivant les standards de rédaction et les bonnes pratiques.
* **Valide** : exécute les vérifications de l&#39;Interface en ligne de commande (CLI) Mintlify pour s&#39;assurer que la documentation se génère correctement.
* **Crée une PR** : ouvre une pull request (demande de fusion) avec les modifications proposées pour relecture.
* **Recherche** : analyse votre documentation existante, les dépôts connectés et le contexte pertinent.
* **Planifie** : crée une liste de tâches structurée pour les travaux de documentation complexes.
* **Rédige** : génère ou met à jour du contenu en suivant les standards de rédaction et les bonnes pratiques.
* **Valide** : exécute les vérifications de l'Interface en ligne de commande (CLI) Mintlify pour s'assurer que la documentation se génère correctement.
* **Crée une PR** : ouvre une pull request (demande de fusion) avec les modifications proposées pour relecture.

Tous les changements passent par des pull requests (demandes de fusion). L&#39;agent ne fait jamais de commit directement sur votre branche principale.
Tous les changements passent par des pull requests (demandes de fusion). L'agent ne fait jamais de commit directement sur votre branche principale.

<div id="what-you-can-do-with-the-agent">
## Ce que vous pouvez faire avec lagent
## Ce que vous pouvez faire avec l'agent
</div>

Utilisez lagent pour :
Utilisez l'agent pour :

* Rédiger de nouveaux contenus à partir de vos prompts, pull requests (demandes de fusion), fils Slack ou pièces jointes.
* Mettre à jour la documentation existante pour de nouvelles fonctionnalités ou des évolutions d’API.
* Traiter et intégrer des images, des schémas et d’autres fichiers à partir des pièces jointes Slack.
* Rechercher et réviser des exemples de code et des références d’API dans l’ensemble de votre documentation.
* Mettre à jour la documentation existante pour de nouvelles fonctionnalités ou des évolutions d'API.
* Traiter et intégrer des images, des schémas et d'autres fichiers à partir des pièces jointes Slack.
* Rechercher et réviser des exemples de code et des références d'API dans l'ensemble de votre documentation.
* Automatiser la maintenance de la documentation avec des workflows.
* Répondre aux questions sur votre documentation et sur des sujets de rédaction technique.
* Traiter les retours de revue de code pour maintenir la qualité de la documentation.
* Capitaliser les connaissances issues des conversations Slack et des pull requests (demandes de fusion) avant quelles ne soient perdues.
* Capitaliser les connaissances issues des conversations Slack et des pull requests (demandes de fusion) avant qu'elles ne soient perdues.
* Naviguer et coordonner efficacement les modifications dans plusieurs fichiers et répertoires.

<div id="where-you-can-use-the-agent">
## Où vous pouvez utiliser lagent
## Où vous pouvez utiliser l'agent
</div>

* **Dashboard** : Depuis nimporte quelle page de votre Dashboard, utilisez le raccourci clavier <kbd>⌘</kbd>+<kbd>I</kbd> (macOS) ou <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux) pour ouvrir le panneau de lagent. Vous pouvez aussi cliquer sur **Ask agent** sur la page [Overview](https://dashboard.mintlify.com/).
* **Dashboard** : Depuis n'importe quelle page de votre Dashboard, utilisez le raccourci clavier <kbd>⌘</kbd>+<kbd>I</kbd> (macOS) ou <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux) pour ouvrir le panneau de l'agent. Vous pouvez aussi cliquer sur **Ask agent** sur la page [Overview](https://dashboard.mintlify.com/).
<Frame>
<img src="/images/agent/dashboard-light.png" alt="Le panneau de lagent ouvert dans le Dashboard." className="block dark:hidden" />
<img src="/images/agent/dashboard-light.png" alt="Le panneau de l'agent ouvert dans le Dashboard." className="block dark:hidden" />

<img src="/images/agent/dashboard-dark.png" alt="Le panneau de lagent ouvert dans le Dashboard." className="hidden dark:block" />
<img src="/images/agent/dashboard-dark.png" alt="Le panneau de l'agent ouvert dans le Dashboard." className="hidden dark:block" />
</Frame>
* **Slack** : Ajoutez lagent à votre espace de travail Slack et mentionnez `@mintlify` dans nimporte quel canal. Vous pouvez joindre des fichiers et des images directement à vos messages pour que lagent les traite.
* **API** : Intégrez lagent dans des applications personnalisées à laide des [points de terminaison de lagent](/fr/api/agent/create-agent-job).
* **Slack** : Ajoutez l'agent à votre espace de travail Slack et mentionnez `@mintlify` dans n'importe quel canal. Vous pouvez joindre des fichiers et des images directement à vos messages pour que l'agent les traite.
* **API** : Intégrez l'agent dans des applications personnalisées à l'aide des [points de terminaison de l'agent](/fr/api/agent/create-agent-job).

<div id="next-steps">
## Prochaines étapes
</div>

<Card title="Démarrage rapide" horizontal icon="rocket" href="/fr/agent/quickstart">
Commencez à utiliser l&#39;agent dans votre Dashboard.
Commencez à utiliser l'agent dans votre Dashboard.
</Card>

<Card title="Connecter Slack" horizontal icon="slack" href="/fr/agent/slack">
Ajoutez l&#39;agent à votre espace de travail Slack.
Ajoutez l'agent à votre espace de travail Slack.
</Card>

<Card title="Personnaliser le comportement" horizontal icon="wrench" href="/fr/agent/customize">
Configurez l&#39;agent avec un fichier `AGENTS.md`.
Configurez l'agent avec un fichier `AGENTS.md`.
</Card>

<Card title="Rédiger des prompts efficaces" horizontal icon="pen" href="/fr/agent/effective-prompts">
Obtenez de meilleurs résultats grâce à des prompts ciblés.
</Card>
</Card>
<Card title="Automatiser avec des workflows" horizontal icon="refresh-cw" href="/fr/agent/workflows">
Automatisez les tâches récurrentes et la maintenance de la documentation avec des workflows.
</Card>
Loading