github/sim
1
0
Fork 0
mirror of https://github.com/simstudioai/sim.git synced 2026-02-16 17:35:49 -05:00
Code Issues Packages Projects Releases Wiki Activity

feat(i18n): update translations (#1843)

Browse Source
This commit is contained in:
Waleed
2025-11-07 13:03:05 -08:00
committed by GitHub
parent a31dc733cf
commit eb459d0ab9
76 changed files with 23592 additions and 267 deletions
Download Patch File Download Diff File Expand all files Collapse all files

294
apps/docs/content/docs/es/tools/confluence.mdx
View File

@@ -42,7 +42,7 @@ En Sim, la integración con Confluence permite a tus agentes acceder y aprovecha
## Instrucciones de uso
Integra Confluence en el flujo de trabajo. Puede leer y actualizar una página. Requiere OAuth.
Integra Confluence en el flujo de trabajo. Puede leer, crear, actualizar, eliminar páginas, gestionar comentarios, adjuntos, etiquetas y buscar contenido.
## Herramientas
@@ -91,6 +91,298 @@ Actualiza una página de Confluence utilizando la API de Confluence.
| `title` | string | Título de página actualizado |
| `success` | boolean | Estado de éxito de la operación de actualización |
### `confluence_create_page`
Crear una nueva página en un espacio de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `spaceId` | string | Sí | ID del espacio de Confluence donde se creará la página |
| `title` | string | Sí | Título de la nueva página |
| `content` | string | Sí | Contenido de la página en formato de almacenamiento de Confluence \(HTML\) |
| `parentId` | string | No | ID de la página padre si se está creando una página hija |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de creación |
| `pageId` | string | ID de la página creada |
| `title` | string | Título de la página |
| `url` | string | URL de la página |
### `confluence_delete_page`
Eliminar una página de Confluence (la mueve a la papelera donde puede ser restaurada).
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence a eliminar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de eliminación |
| `pageId` | string | ID de página eliminada |
| `deleted` | boolean | Estado de eliminación |
### `confluence_search`
Buscar contenido en páginas de Confluence, publicaciones de blog y otro contenido.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `query` | string | Sí | Cadena de consulta de búsqueda |
| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de búsqueda |
| `results` | array | Resultados de búsqueda |
### `confluence_create_comment`
Añadir un comentario a una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence donde comentar |
| `comment` | string | Sí | Texto del comentario en formato de almacenamiento de Confluence |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de creación |
| `commentId` | string | ID del comentario creado |
| `pageId` | string | ID de la página |
### `confluence_list_comments`
Listar todos los comentarios en una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence de la que listar comentarios |
| `limit` | number | No | Número máximo de comentarios a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `comments` | array | Lista de comentarios |
### `confluence_update_comment`
Actualizar un comentario existente en una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `commentId` | string | Sí | ID del comentario de Confluence a actualizar |
| `comment` | string | Sí | Texto del comentario actualizado en formato de almacenamiento de Confluence |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de actualización |
| `commentId` | string | ID del comentario actualizado |
| `updated` | boolean | Estado de actualización |
### `confluence_delete_comment`
Eliminar un comentario de una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `commentId` | string | Sí | ID del comentario de Confluence a eliminar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de eliminación |
| `commentId` | string | ID del comentario eliminado |
| `deleted` | boolean | Estado de eliminación |
### `confluence_list_attachments`
Listar todos los archivos adjuntos en una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence de la que listar los archivos adjuntos |
| `limit` | number | No | Número máximo de archivos adjuntos a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `attachments` | array | Lista de adjuntos |
### `confluence_delete_attachment`
Eliminar un adjunto de una página de Confluence (se mueve a la papelera).
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `attachmentId` | string | Sí | ID del adjunto de Confluence a eliminar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la eliminación |
| `attachmentId` | string | ID del adjunto eliminado |
| `deleted` | boolean | Estado de la eliminación |
### `confluence_add_label`
Añadir una etiqueta a una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence a la que añadir la etiqueta |
| `labelName` | string | Sí | Nombre de la etiqueta a añadir |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la operación |
| `pageId` | string | ID de la página |
| `labelName` | string | Nombre de la etiqueta |
| `added` | boolean | Estado de la adición |
### `confluence_list_labels`
Listar todas las etiquetas en una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence de la que listar etiquetas |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `labels` | array | Lista de etiquetas |
### `confluence_remove_label`
Eliminar una etiqueta de una página de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence de la que eliminar la etiqueta |
| `labelName` | string | Sí | Nombre de la etiqueta a eliminar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la operación |
| `pageId` | string | ID de la página |
| `labelName` | string | Nombre de la etiqueta |
| `removed` | boolean | Estado de eliminación |
### `confluence_get_space`
Obtener detalles sobre un espacio específico de Confluence.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `spaceId` | string | Sí | ID del espacio de Confluence a recuperar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `spaceId` | string | ID del espacio |
| `name` | string | Nombre del espacio |
| `key` | string | Clave del espacio |
| `type` | string | Tipo de espacio |
| `status` | string | Estado del espacio |
| `url` | string | URL del espacio |
### `confluence_list_spaces`
Listar todos los espacios de Confluence accesibles para el usuario.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `limit` | number | No | Número máximo de espacios a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `spaces` | array | Lista de espacios |
## Notas
- Categoría: `tools`

618
apps/docs/content/docs/es/tools/discord.mdx
View File

@@ -56,7 +56,7 @@ Los componentes de Discord en Sim utilizan una carga diferida eficiente, obtenie
## Instrucciones de uso
Integra Discord en el flujo de trabajo. Puede enviar y recibir mensajes, obtener información del servidor y obtener información de un usuario. Requiere clave API de bot.
Integración completa con Discord: mensajes, hilos, canales, roles, miembros, invitaciones y webhooks.
## Herramientas
@@ -98,7 +98,7 @@ Recuperar mensajes de un canal de Discord
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `messages` | array | Array de mensajes de Discord con metadatos completos |
| `data` | object | Contenedor para datos de mensajes |
### `discord_get_server`
@@ -136,6 +136,620 @@ Recuperar información sobre un usuario de Discord
| `message` | string | Mensaje de éxito o error |
| `data` | object | Información del usuario de Discord |
### `discord_edit_message`
Editar un mensaje existente en un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a editar |
| `content` | string | No | El nuevo contenido de texto para el mensaje |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos actualizados del mensaje de Discord |
### `discord_delete_message`
Eliminar un mensaje de un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a eliminar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_add_reaction`
Añadir una reacción con emoji a un mensaje de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje al que reaccionar |
| `emoji` | string | Sí | El emoji para reaccionar \(emoji unicode o emoji personalizado en formato nombre:id\) |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_remove_reaction`
Eliminar una reacción de un mensaje de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje con la reacción |
| `emoji` | string | Sí | El emoji a eliminar \(emoji unicode o emoji personalizado en formato nombre:id\) |
| `userId` | string | No | El ID del usuario cuya reacción se eliminará \(omitir para eliminar la propia reacción del bot\) |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_pin_message`
Fijar un mensaje en un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a fijar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_unpin_message`
Desfijar un mensaje en un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a desfijar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_create_thread`
Crear un hilo en un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord donde crear el hilo |
| `name` | string | Sí | El nombre del hilo \(1-100 caracteres\) |
| `messageId` | string | No | El ID del mensaje para crear un hilo a partir de él \(si se crea desde un mensaje existente\) |
| `autoArchiveDuration` | number | No | Duración en minutos para auto-archivar el hilo \(60, 1440, 4320, 10080\) |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del hilo creado |
### `discord_join_thread`
Unirse a un hilo en Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `threadId` | string | Sí | El ID del hilo al que unirse |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_leave_thread`
Abandonar un hilo en Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `threadId` | string | Sí | El ID del hilo que se va a abandonar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_archive_thread`
Archivar o desarchivar un hilo en Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `threadId` | string | Sí | El ID del hilo que se va a archivar/desarchivar |
| `archived` | boolean | Sí | Si se debe archivar \(true\) o desarchivar \(false\) el hilo |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos actualizados del hilo |
### `discord_create_channel`
Crear un nuevo canal en un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `name` | string | Sí | El nombre del canal \(1-100 caracteres\) |
| `type` | number | No | Tipo de canal \(0=texto, 2=voz, 4=categoría, 5=anuncio, 13=escenario\) |
| `topic` | string | No | Tema del canal \(0-1024 caracteres\) |
| `parentId` | string | No | ID de la categoría padre para el canal |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del canal creado |
### `discord_update_channel`
Actualizar un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord a actualizar |
| `name` | string | No | El nuevo nombre para el canal |
| `topic` | string | No | El nuevo tema para el canal |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del canal actualizado |
### `discord_delete_channel`
Eliminar un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord a eliminar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_get_channel`
Obtener información sobre un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord a recuperar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del canal |
### `discord_create_role`
Crear un nuevo rol en un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `name` | string | Sí | El nombre del rol |
| `color` | number | No | Valor de color RGB como entero \(p. ej., 0xFF0000 para rojo\) |
| `hoist` | boolean | No | Si se deben mostrar los miembros del rol por separado de los miembros en línea |
| `mentionable` | boolean | No | Si el rol puede ser mencionado |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del rol creado |
### `discord_update_role`
Actualizar un rol en un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `roleId` | string | Sí | El ID del rol a actualizar |
| `name` | string | No | El nuevo nombre para el rol |
| `color` | number | No | Valor de color RGB como entero |
| `hoist` | boolean | No | Si se deben mostrar los miembros del rol por separado |
| `mentionable` | boolean | No | Si el rol puede ser mencionado |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del rol actualizado |
### `discord_delete_role`
Eliminar un rol de un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `roleId` | string | Sí | El ID del rol a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_assign_role`
Asignar un rol a un miembro en un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `userId` | string | Sí | El ID del usuario al que asignar el rol |
| `roleId` | string | Sí | El ID del rol a asignar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_remove_role`
Eliminar un rol de un miembro en un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `userId` | string | Sí | El ID del usuario al que quitar el rol |
| `roleId` | string | Sí | El ID del rol a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_kick_member`
Expulsar a un miembro de un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `userId` | string | Sí | El ID del usuario a expulsar |
| `reason` | string | No | Motivo para expulsar al miembro |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_ban_member`
Banear a un miembro de un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `userId` | string | Sí | El ID del usuario a banear |
| `reason` | string | No | Motivo para banear al miembro |
| `deleteMessageDays` | number | No | Número de días para eliminar mensajes \(0-7\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_unban_member`
Desbanear a un miembro de un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `userId` | string | Sí | El ID del usuario a desbanear |
| `reason` | string | No | Motivo para desbanear al miembro |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_get_member`
Obtener información sobre un miembro en un servidor de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `userId` | string | Sí | El ID del usuario a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del miembro |
### `discord_update_member`
Actualizar un miembro en un servidor de Discord (p. ej., cambiar apodo)
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
| `userId` | string | Sí | El ID del usuario a actualizar |
| `nick` | string | No | Nuevo apodo para el miembro \(null para eliminar\) |
| `mute` | boolean | No | Si se debe silenciar al miembro en canales de voz |
| `deaf` | boolean | No | Si se debe ensordecer al miembro en canales de voz |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos actualizados del miembro |
### `discord_create_invite`
Crear un enlace de invitación para un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord para el que crear una invitación |
| `maxAge` | number | No | Duración de la invitación en segundos \(0 = nunca expira, predeterminado 86400\) |
| `maxUses` | number | No | Número máximo de usos \(0 = ilimitado, predeterminado 0\) |
| `temporary` | boolean | No | Si la invitación otorga membresía temporal |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos de la invitación creada |
### `discord_get_invite`
Obtener información sobre una invitación de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `inviteCode` | string | Sí | El código de invitación a recuperar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos de la invitación |
### `discord_delete_invite`
Eliminar una invitación de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `inviteCode` | string | Sí | El código de invitación a eliminar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
### `discord_create_webhook`
Crear un webhook en un canal de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `channelId` | string | Sí | El ID del canal de Discord donde crear el webhook |
| `name` | string | Sí | Nombre del webhook \(1-80 caracteres\) |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del webhook creado |
### `discord_execute_webhook`
Ejecutar un webhook de Discord para enviar un mensaje
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `webhookId` | string | Sí | El ID del webhook |
| `webhookToken` | string | Sí | El token del webhook |
| `content` | string | Sí | El contenido del mensaje a enviar |
| `username` | string | No | Sobrescribir el nombre de usuario predeterminado del webhook |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Mensaje enviado a través del webhook |
### `discord_get_webhook`
Obtener información sobre un webhook de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `webhookId` | string | Sí | El ID del webhook a recuperar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del webhook |
### `discord_delete_webhook`
Eliminar un webhook de Discord
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Sí | El token del bot para autenticación |
| `webhookId` | string | Sí | El ID del webhook a eliminar |
| `serverId` | string | Sí | El ID del servidor de Discord \(ID del guild\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito o error |
## Notas
- Categoría: `tools`

36
apps/docs/content/docs/es/tools/exa.mdx
View File

@@ -59,6 +59,17 @@ Busca en la web usando Exa AI. Devuelve resultados de búsqueda relevantes con t
| `numResults` | number | No | Número de resultados a devolver \(predeterminado: 10, máximo: 25\) |
| `useAutoprompt` | boolean | No | Si se debe usar autoprompt para mejorar la consulta \(predeterminado: false\) |
| `type` | string | No | Tipo de búsqueda: neural, keyword, auto o fast \(predeterminado: auto\) |
| `includeDomains` | string | No | Lista separada por comas de dominios a incluir en los resultados |
| `excludeDomains` | string | No | Lista separada por comas de dominios a excluir de los resultados |
| `startPublishedDate` | string | No | Filtrar resultados publicados después de esta fecha \(formato ISO 8601, ej., 2024-01-01\) |
| `endPublishedDate` | string | No | Filtrar resultados publicados antes de esta fecha \(formato ISO 8601\) |
| `startCrawlDate` | string | No | Filtrar resultados rastreados después de esta fecha \(formato ISO 8601\) |
| `endCrawlDate` | string | No | Filtrar resultados rastreados antes de esta fecha \(formato ISO 8601\) |
| `category` | string | No | Filtrar por categoría: company, research_paper, news_article, pdf, github, tweet, movie, song, personal_site |
| `text` | boolean | No | Incluir contenido de texto completo en los resultados \(predeterminado: false\) |
| `highlights` | boolean | No | Incluir fragmentos destacados en los resultados \(predeterminado: false\) |
| `summary` | boolean | No | Incluir resúmenes generados por IA en los resultados \(predeterminado: false\) |
| `livecrawl` | string | No | Modo de rastreo en vivo: always, fallback, o never \(predeterminado: never\) |
| `apiKey` | string | Sí | Clave API de Exa AI |
#### Salida
@@ -75,9 +86,13 @@ Recupera el contenido de páginas web usando Exa AI. Devuelve el título, conten
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ---------- | ----------- |
| `urls` | string | Sí | Lista de URLs separadas por comas para recuperar contenido |
| `text` | boolean | No | Si es true, devuelve el texto completo de la página con configuración predeterminada. Si es false, desactiva la devolución de texto. |
| `urls` | string | Sí | Lista separada por comas de URLs de las que recuperar contenido |
| `text` | boolean | No | Si es true, devuelve el texto completo de la página con la configuración predeterminada. Si es false, desactiva la devolución de texto. |
| `summaryQuery` | string | No | Consulta para guiar la generación del resumen |
| `subpages` | number | No | Número de subpáginas a rastrear desde las URLs proporcionadas |
| `subpageTarget` | string | No | Palabras clave separadas por comas para dirigirse a subpáginas específicas \(por ejemplo, "docs,tutorial,about"\) |
| `highlights` | boolean | No | Incluir fragmentos destacados en los resultados \(predeterminado: false\) |
| `livecrawl` | string | No | Modo de rastreo en vivo: always, fallback o never \(predeterminado: never\) |
| `apiKey` | string | Sí | Clave API de Exa AI |
#### Salida
@@ -93,10 +108,21 @@ Encuentra páginas web similares a una URL determinada utilizando Exa AI. Devuel
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| --------- | ---- | ---------- | ----------- |
| `url` | string | Sí | La URL para encontrar enlaces similares |
| `numResults` | number | No | Número de enlaces similares a devolver \(predeterminado: 10, máximo: 25\) |
| `text` | boolean | No | Si se debe incluir el texto completo de las páginas similares |
| `includeDomains` | string | No | Lista separada por comas de dominios a incluir en los resultados |
| `excludeDomains` | string | No | Lista separada por comas de dominios a excluir de los resultados |
| `excludeSourceDomain` | boolean | No | Excluir el dominio de origen de los resultados \(predeterminado: false\) |
| `startPublishedDate` | string | No | Filtrar resultados publicados después de esta fecha \(formato ISO 8601, por ejemplo, 2024-01-01\) |
| `endPublishedDate` | string | No | Filtrar resultados publicados antes de esta fecha \(formato ISO 8601\) |
| `startCrawlDate` | string | No | Filtrar resultados rastreados después de esta fecha \(formato ISO 8601\) |
| `endCrawlDate` | string | No | Filtrar resultados rastreados antes de esta fecha \(formato ISO 8601\) |
| `category` | string | No | Filtrar por categoría: company, research_paper, news_article, pdf, github, tweet, movie, song, personal_site |
| `highlights` | boolean | No | Incluir fragmentos destacados en los resultados \(predeterminado: false\) |
| `summary` | boolean | No | Incluir resúmenes generados por IA en los resultados \(predeterminado: false\) |
| `livecrawl` | string | No | Modo de rastreo en vivo: always, fallback o never \(predeterminado: never\) |
| `apiKey` | string | Sí | Clave API de Exa AI |
#### Salida
@@ -131,9 +157,9 @@ Realiza investigaciones exhaustivas utilizando IA para generar informes detallad
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| --------- | ---- | -------- | ----------- |
| `query` | string | Sí | Consulta o tema de investigación |
| `includeText` | boolean | No | Incluir contenido de texto completo en los resultados |
| `model` | string | No | Modelo de investigación: exa-research-fast, exa-research \(predeterminado\), o exa-research-pro |
| `apiKey` | string | Sí | Clave API de Exa AI |
#### Salida

103
apps/docs/content/docs/es/tools/firecrawl.mdx
View File

@@ -1,6 +1,6 @@
---
title: Firecrawl
description: Rastrea o busca en la web
description: Raspa, busca, rastrea, mapea y extrae datos web
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -58,7 +58,7 @@ Esto permite a tus agentes recopilar información de sitios web, extraer datos e
## Instrucciones de uso
Integra Firecrawl en el flujo de trabajo. Puede buscar, extraer o rastrear sitios web. Requiere clave API.
Integra Firecrawl en el flujo de trabajo. Puede raspar páginas, buscar en la web, rastrear sitios web completos, mapear estructuras de URL y extraer datos estructurados usando IA.
## Herramientas
@@ -70,8 +70,26 @@ Extrae contenido estructurado de páginas web con soporte integral de metadatos.
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `url` | string | Sí | La URL de la que extraer contenido |
| `scrapeOptions` | json | No | Opciones para la extracción de contenido |
| `url` | string | Sí | La URL de donde extraer contenido |
| `formats` | json | No | Formatos de salida \(markdown, html, rawHtml, links, images, screenshot\). Predeterminado: \["markdown"\] |
| `onlyMainContent` | boolean | No | Extraer solo el contenido principal, excluyendo encabezados, navegación, pies de página \(predeterminado: true\) |
| `includeTags` | json | No | Etiquetas HTML a conservar en la salida |
| `excludeTags` | json | No | Etiquetas HTML a eliminar de la salida |
| `maxAge` | number | No | Devolver versión en caché si es más reciente que esta edad en ms \(predeterminado: 172800000\) |
| `headers` | json | No | Encabezados de solicitud personalizados \(cookies, user-agent, etc.\) |
| `waitFor` | number | No | Retraso en milisegundos antes de la obtención \(predeterminado: 0\) |
| `mobile` | boolean | No | Emular dispositivo móvil \(predeterminado: false\) |
| `skipTlsVerification` | boolean | No | Omitir verificación de certificado TLS \(predeterminado: true\) |
| `timeout` | number | No | Tiempo de espera de solicitud en milisegundos |
| `parsers` | json | No | Controles de procesamiento de archivos \(por ejemplo, \["pdf"\]\) |
| `actions` | json | No | Operaciones previas al raspado \(esperar, clic, desplazamiento, captura de pantalla, etc.\) |
| `location` | json | No | Configuración geográfica \(país, idiomas\) |
| `removeBase64Images` | boolean | No | Eliminar imágenes base64 de la salida \(predeterminado: true\) |
| `blockAds` | boolean | No | Habilitar bloqueo de anuncios y ventanas emergentes \(predeterminado: true\) |
| `proxy` | string | No | Tipo de proxy: básico, sigiloso o automático \(predeterminado: auto\) |
| `storeInCache` | boolean | No | Almacenar la página en caché \(predeterminado: true\) |
| `zeroDataRetention` | boolean | No | Habilitar modo de retención de datos cero \(predeterminado: false\) |
| `scrapeOptions` | json | No | Opciones para raspado de contenido \(heredado, preferir parámetros de nivel superior\) |
| `apiKey` | string | Sí | Clave API de Firecrawl |
#### Salida
@@ -91,6 +109,15 @@ Busca información en la web usando Firecrawl
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `query` | string | Sí | La consulta de búsqueda a utilizar |
| `limit` | number | No | Número máximo de resultados a devolver (1-100, predeterminado: 5) |
| `sources` | json | No | Fuentes de búsqueda: ["web"], ["images"], o ["news"] (predeterminado: ["web"]) |
| `categories` | json | No | Filtrar por categorías: ["github"], ["research"], o ["pdf"] |
| `tbs` | string | No | Búsqueda basada en tiempo: qdr:h (hora), qdr:d (día), qdr:w (semana), qdr:m (mes), qdr:y (año) |
| `location` | string | No | Ubicación geográfica para los resultados (ej., "San Francisco, California, United States") |
| `country` | string | No | Código de país ISO para geolocalización (predeterminado: US) |
| `timeout` | number | No | Tiempo de espera en milisegundos (predeterminado: 60000) |
| `ignoreInvalidURLs` | boolean | No | Excluir URLs inválidas de los resultados (predeterminado: false) |
| `scrapeOptions` | json | No | Configuración avanzada de extracción para resultados de búsqueda |
| `apiKey` | string | Sí | Clave API de Firecrawl |
#### Salida
@@ -108,8 +135,22 @@ Rastrea sitios web completos y extrae contenido estructurado de todas las págin
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `url` | string | Sí | La URL del sitio web a rastrear |
| `limit` | number | No | Número máximo de páginas a rastrear \(predeterminado: 100\) |
| `limit` | number | No | Número máximo de páginas a rastrear (predeterminado: 100) |
| `onlyMainContent` | boolean | No | Extraer solo el contenido principal de las páginas |
| `prompt` | string | No | Instrucción en lenguaje natural para generar automáticamente opciones de rastreo |
| `maxDiscoveryDepth` | number | No | Límite de profundidad para el descubrimiento de URL (las páginas raíz tienen profundidad 0) |
| `sitemap` | string | No | Si usar datos del mapa del sitio: "skip" o "include" (predeterminado: "include") |
| `crawlEntireDomain` | boolean | No | Seguir URLs hermanas/padres o solo rutas hijas (predeterminado: false) |
| `allowExternalLinks` | boolean | No | Seguir enlaces a sitios web externos (predeterminado: false) |
| `allowSubdomains` | boolean | No | Seguir enlaces de subdominio (predeterminado: false) |
| `ignoreQueryParameters` | boolean | No | Evitar volver a extraer la misma ruta con diferentes parámetros de consulta (predeterminado: false) |
| `delay` | number | No | Segundos entre extracciones para cumplir con límites de tasa |
| `maxConcurrency` | number | No | Límite de extracciones concurrentes |
| `excludePaths` | json | No | Array de patrones regex para URLs a excluir |
| `includePaths` | json | No | Array de patrones regex para URLs a incluir exclusivamente |
| `webhook` | json | No | Configuración de webhook para notificaciones de rastreo |
| `scrapeOptions` | json | No | Configuración avanzada de extracción |
| `zeroDataRetention` | boolean | No | Habilitar retención de datos cero (predeterminado: false) |
| `apiKey` | string | Sí | Clave API de Firecrawl |
#### Salida
@@ -118,6 +159,58 @@ Rastrea sitios web completos y extrae contenido estructurado de todas las págin
| --------- | ---- | ----------- |
| `pages` | array | Array de páginas rastreadas con su contenido y metadatos |
### `firecrawl_map`
Obtén una lista completa de URLs de cualquier sitio web de forma rápida y confiable. Útil para descubrir todas las páginas de un sitio sin necesidad de rastrearlas.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `url` | string | Sí | La URL base para mapear y descubrir enlaces |
| `search` | string | No | Filtrar resultados por relevancia a un término de búsqueda (ej., "blog") |
| `sitemap` | string | No | Controla el uso del sitemap: "skip", "include" (predeterminado), o "only" |
| `includeSubdomains` | boolean | No | Incluir URLs de subdominios (predeterminado: true) |
| `ignoreQueryParameters` | boolean | No | Excluir URLs que contengan cadenas de consulta (predeterminado: true) |
| `limit` | number | No | Número máximo de enlaces a devolver (máx: 100.000, predeterminado: 5.000) |
| `timeout` | number | No | Tiempo de espera de la solicitud en milisegundos |
| `location` | json | No | Contexto geográfico para proxy (país, idiomas) |
| `apiKey` | string | Sí | Clave API de Firecrawl |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la operación de mapeo fue exitosa |
| `links` | array | Array de URLs descubiertas del sitio web |
### `firecrawl_extract`
Extrae datos estructurados de páginas web completas utilizando instrucciones en lenguaje natural y esquema JSON. Función agente potente para la extracción inteligente de datos.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `urls` | json | Sí | Array de URLs de las que extraer datos (admite formato glob) |
| `prompt` | string | No | Instrucciones en lenguaje natural para el proceso de extracción |
| `schema` | json | No | Esquema JSON que define la estructura de los datos a extraer |
| `enableWebSearch` | boolean | No | Habilitar búsqueda web para encontrar información complementaria (predeterminado: false) |
| `ignoreSitemap` | boolean | No | Ignorar archivos sitemap.xml durante el escaneo (predeterminado: false) |
| `includeSubdomains` | boolean | No | Extender el escaneo a subdominios (predeterminado: true) |
| `showSources` | boolean | No | Devolver fuentes de datos en la respuesta (predeterminado: false) |
| `ignoreInvalidURLs` | boolean | No | Omitir URLs inválidas en el array (predeterminado: true) |
| `scrapeOptions` | json | No | Opciones avanzadas de configuración de extracción |
| `apiKey` | string | Sí | Clave API de Firecrawl |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la operación de extracción fue exitosa |
| `data` | object | Datos estructurados extraídos según el esquema o prompt |
| `sources` | array | Fuentes de datos \(solo si showSources está habilitado\) |
## Notas
- Categoría: `tools`

68
apps/docs/content/docs/es/tools/jina.mdx
View File

@@ -1,6 +1,6 @@
---
title: Jina
description: Convertir contenido de sitios web en texto
description: Busca en la web o extrae contenido de URLs
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -62,7 +62,7 @@ Esta integración es particularmente valiosa para crear agentes que necesitan re
## Instrucciones de uso
Integra Jina en el flujo de trabajo. Extrae contenido de sitios web. Requiere clave API.
Integra Jina AI en el flujo de trabajo. Busca en la web y obtén resultados compatibles con LLM, o extrae contenido limpio de URLs específicas con opciones de análisis avanzadas.
## Herramientas
@@ -73,18 +73,78 @@ Extrae y procesa contenido web en texto limpio y compatible con LLM usando Jina
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| --------- | ---- | -------- | ----------- |
| `url` | string | Sí | La URL para leer y convertir a markdown |
| `useReaderLMv2` | boolean | No | Si se debe usar ReaderLM-v2 para mejor calidad |
| `useReaderLMv2` | boolean | No | Si se debe usar ReaderLM-v2 para mejor calidad \(3x costo de tokens\) |
| `gatherLinks` | boolean | No | Si se deben recopilar todos los enlaces al final |
| `jsonResponse` | boolean | No | Si se debe devolver la respuesta en formato JSON |
| `apiKey` | string | Sí | Tu clave API de Jina AI |
| `targetSelector` | string | No | Selector CSS para dirigirse a elementos específicos de la página \(p.ej., "#main-content"\) |
| `waitForSelector` | string | No | Selector CSS para esperar antes de extraer contenido \(útil para páginas dinámicas\) |
| `removeSelector` | string | No | Selector CSS para elementos a excluir \(p.ej., "header, footer, .ad"\) |
| `timeout` | number | No | Máximo de segundos para esperar la carga de la página |
| `withImagesummary` | boolean | No | Recopilar todas las imágenes de la página con metadatos |
| `retainImages` | string | No | Controlar la inclusión de imágenes: "none" elimina todas, "all" mantiene todas |
| `returnFormat` | string | No | Formato de salida: markdown, html, text, screenshot o pageshot |
| `withIframe` | boolean | No | Incluir contenido de iframe en la extracción |
| `withShadowDom` | boolean | No | Extraer contenido de Shadow DOM |
| `setCookie` | string | No | Reenviar cookies de autenticación \(desactiva el almacenamiento en caché\) |
| `proxyUrl` | string | No | URL de proxy HTTP para enrutamiento de solicitudes |
| `proxy` | string | No | Código de país para proxy \(p.ej., "US", "UK"\) o "auto"/"none" |
| `engine` | string | No | Motor de renderizado: browser, direct o cf-browser-rendering |
| `tokenBudget` | number | No | Máximo de tokens para la solicitud \(control de costos\) |
| `noCache` | boolean | No | Omitir contenido en caché para recuperación en tiempo real |
| `cacheTolerance` | number | No | Vida útil personalizada de caché en segundos |
| `withGeneratedAlt` | boolean | No | Generar texto alternativo para imágenes usando VLM |
| `baseUrl` | string | No | Establecer como "final" para seguir la cadena de redirección |
| `locale` | string | No | Configuración regional del navegador para renderizado \(p.ej., "en-US"\) |
| `robotsTxt` | string | No | User-Agent de bot para verificación de robots.txt |
| `dnt` | boolean | No | Do Not Track - evita almacenamiento en caché/seguimiento |
| `noGfm` | boolean | No | Desactivar GitHub Flavored Markdown |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | El contenido extraído de la URL, procesado en texto limpio y compatible con LLM |
| `links` | array | Lista de enlaces encontrados en la página (cuando gatherLinks o withLinksummary está activado) |
| `images` | array | Lista de imágenes encontradas en la página (cuando withImagesummary está activado) |
### `jina_search`
Busca en la web y devuelve los 5 mejores resultados con contenido compatible con LLM. Cada resultado se procesa automáticamente a través de la API de Jina Reader. Admite filtrado geográfico, restricciones de sitios y paginación.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `q` | string | Sí | Cadena de consulta de búsqueda |
| `apiKey` | string | Sí | Tu clave API de Jina AI |
| `gl` | string | No | Código de país de dos letras para resultados específicos geográficamente (p. ej., "US", "UK", "JP") |
| `location` | string | No | Ubicación a nivel de ciudad para resultados de búsqueda localizados |
| `hl` | string | No | Código de idioma de dos letras para resultados (p. ej., "en", "es", "fr") |
| `num` | number | No | Número máximo de resultados por página (predeterminado: 5) |
| `page` | number | No | Número de página para paginación (desplazamiento) |
| `site` | string | No | Restringir resultados a dominio(s) específico(s). Puede estar separado por comas para múltiples sitios (p. ej., "jina.ai,github.com") |
| `withFavicon` | boolean | No | Incluir favicons de sitios web en los resultados |
| `withImagesummary` | boolean | No | Recopilar todas las imágenes de las páginas de resultados con metadatos |
| `withLinksummary` | boolean | No | Recopilar todos los enlaces de las páginas de resultados |
| `retainImages` | string | No | Control de inclusión de imágenes: "none" elimina todas, "all" mantiene todas |
| `noCache` | boolean | No | Omitir contenido en caché para recuperación en tiempo real |
| `withGeneratedAlt` | boolean | No | Generar texto alternativo para imágenes usando VLM |
| `respondWith` | string | No | Establecer en "no-content" para obtener solo metadatos sin contenido de página |
| `returnFormat` | string | No | Formato de salida: markdown, html, text, screenshot o pageshot |
| `engine` | string | No | Motor de renderizado: browser o direct |
| `timeout` | number | No | Segundos máximos de espera para la carga de la página |
| `setCookie` | string | No | Reenviar cookies de autenticación |
| `proxyUrl` | string | No | URL de proxy HTTP para enrutamiento de solicitudes |
| `locale` | string | No | Configuración regional del navegador para renderizado (p. ej., "en-US") |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `results` | array | Array de resultados de búsqueda, cada uno contiene título, descripción, url y contenido compatible con LLM |
## Notas

370
apps/docs/content/docs/es/tools/jira.mdx
View File

@@ -134,6 +134,376 @@ Recuperar múltiples incidencias de Jira en bloque
| `success` | boolean | Estado de éxito de la operación |
| `output` | array | Array de incidencias de Jira con resumen, descripción, marcas de tiempo de creación y actualización |
### `jira_delete_issue`
Eliminar una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira a eliminar \(p. ej., PROJ-123\) |
| `deleteSubtasks` | boolean | No | Si se deben eliminar las subtareas. Si es falso, las incidencias principales con subtareas no se pueden eliminar. |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de la incidencia eliminada con marca de tiempo, clave de incidencia y estado de éxito |
### `jira_assign_issue`
Asignar una incidencia de Jira a un usuario
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira a asignar \(p. ej., PROJ-123\) |
| `accountId` | string | Sí | ID de cuenta del usuario al que asignar la incidencia. Usa "-1" para asignación automática o null para desasignar. |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de la asignación con marca de tiempo, clave de incidencia, ID del asignado y estado de éxito |
### `jira_transition_issue`
Mover una incidencia de Jira entre estados de flujo de trabajo (p. ej., Pendiente -> En progreso)
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira a transicionar \(p. ej., PROJ-123\) |
| `transitionId` | string | Sí | ID de la transición a ejecutar \(p. ej., "11" para "Pendiente", "21" para "En progreso"\) |
| `comment` | string | No | Comentario opcional para añadir al transicionar la incidencia |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de la transición con marca de tiempo, clave de incidencia, ID de transición y estado de éxito |
### `jira_search_issues`
Buscar incidencias de Jira usando JQL (Jira Query Language)
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `jql` | string | Sí | Cadena de consulta JQL para buscar incidencias \(p. ej., "project = PROJ AND status = Open"\) |
| `startAt` | number | No | El índice del primer resultado a devolver \(para paginación\) |
| `maxResults` | number | No | Número máximo de resultados a devolver \(predeterminado: 50\) |
| `fields` | array | No | Array de nombres de campos a devolver \(predeterminado: \['summary', 'status', 'assignee', 'created', 'updated'\]\) |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Resultados de búsqueda con marca de tiempo, recuento total, detalles de paginación y array de incidencias coincidentes |
### `jira_add_comment`
Añadir un comentario a una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira a la que añadir el comentario \(p. ej., PROJ-123\) |
| `body` | string | Sí | Texto del cuerpo del comentario |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles del comentario con marca de tiempo, clave de incidencia, ID del comentario, cuerpo y estado de éxito |
### `jira_get_comments`
Obtener todos los comentarios de una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira de la que obtener comentarios \(p. ej., PROJ-123\) |
| `startAt` | number | No | Índice del primer comentario a devolver \(predeterminado: 0\) |
| `maxResults` | number | No | Número máximo de comentarios a devolver \(predeterminado: 50\) |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Datos de comentarios con marca de tiempo, clave de incidencia, recuento total y array de comentarios |
### `jira_update_comment`
Actualizar un comentario existente en una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de incidencia de Jira que contiene el comentario \(p. ej., PROJ-123\) |
| `commentId` | string | Sí | ID del comentario a actualizar |
| `body` | string | Sí | Texto actualizado del comentario |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles del comentario actualizado con marca de tiempo, clave de incidencia, ID de comentario, texto del cuerpo y estado de éxito |
### `jira_delete_comment`
Eliminar un comentario de una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de incidencia de Jira que contiene el comentario \(p. ej., PROJ-123\) |
| `commentId` | string | Sí | ID del comentario a eliminar |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de eliminación con marca de tiempo, clave de incidencia, ID de comentario y estado de éxito |
### `jira_get_attachments`
Obtener todos los adjuntos de una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira de la que obtener los adjuntos \(p. ej., PROJ-123\) |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Datos de adjuntos con marca de tiempo, clave de incidencia y array de adjuntos |
### `jira_delete_attachment`
Eliminar un adjunto de una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `attachmentId` | string | Sí | ID del adjunto a eliminar |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de eliminación con marca de tiempo, ID de adjunto y estado de éxito |
### `jira_add_worklog`
Añadir una entrada de registro de trabajo de seguimiento de tiempo a una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira a la que añadir el registro de trabajo \(p. ej., PROJ-123\) |
| `timeSpentSeconds` | number | Sí | Tiempo dedicado en segundos |
| `comment` | string | No | Comentario opcional para la entrada del registro de trabajo |
| `started` | string | No | Hora de inicio opcional en formato ISO \(por defecto es la hora actual\) |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles del registro de trabajo con marca de tiempo, clave de incidencia, ID del registro de trabajo, tiempo dedicado en segundos y estado de éxito |
### `jira_get_worklogs`
Obtener todas las entradas de registro de trabajo de una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira de la que obtener los registros de trabajo \(p. ej., PROJ-123\) |
| `startAt` | number | No | Índice del primer registro de trabajo a devolver \(predeterminado: 0\) |
| `maxResults` | number | No | Número máximo de registros de trabajo a devolver \(predeterminado: 50\) |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Datos de registros de trabajo con marca de tiempo, clave de incidencia, recuento total y array de registros de trabajo |
### `jira_update_worklog`
Actualizar una entrada existente de registro de trabajo en una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de incidencia de Jira que contiene el registro de trabajo \(p. ej., PROJ-123\) |
| `worklogId` | string | Sí | ID de la entrada de registro de trabajo a actualizar |
| `timeSpentSeconds` | number | No | Tiempo empleado en segundos |
| `comment` | string | No | Comentario opcional para la entrada de registro de trabajo |
| `started` | string | No | Hora de inicio opcional en formato ISO |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de actualización del registro de trabajo con marca de tiempo, clave de incidencia, ID de registro de trabajo y estado de éxito |
### `jira_delete_worklog`
Eliminar una entrada de registro de trabajo de una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de incidencia de Jira que contiene el registro de trabajo \(p. ej., PROJ-123\) |
| `worklogId` | string | Sí | ID de la entrada de registro de trabajo a eliminar |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de eliminación con marca de tiempo, clave de incidencia, ID de registro de trabajo y estado de éxito |
### `jira_create_issue_link`
Crear una relación de enlace entre dos incidencias de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `inwardIssueKey` | string | Sí | Clave de incidencia de Jira para la incidencia de entrada \(p. ej., PROJ-123\) |
| `outwardIssueKey` | string | Sí | Clave de incidencia de Jira para la incidencia de salida \(p. ej., PROJ-456\) |
| `linkType` | string | Sí | El tipo de relación de enlace \(p. ej., "Bloquea", "Se relaciona con", "Duplica"\) |
| `comment` | string | No | Comentario opcional para añadir al enlace de la incidencia |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles del enlace de incidencia con marca de tiempo, clave de incidencia de entrada, clave de incidencia de salida, tipo de enlace y estado de éxito |
### `jira_delete_issue_link`
Eliminar un enlace entre dos incidencias de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `linkId` | string | Sí | ID del enlace de incidencia a eliminar |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de eliminación con marca de tiempo, ID del enlace y estado de éxito |
### `jira_add_watcher`
Añadir un observador a una incidencia de Jira para recibir notificaciones sobre actualizaciones
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira a la que añadir el observador \(p. ej., PROJ-123\) |
| `accountId` | string | Sí | ID de cuenta del usuario que se añadirá como observador |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles del observador con marca de tiempo, clave de incidencia, ID de cuenta del observador y estado de éxito |
### `jira_remove_watcher`
Eliminar un observador de una incidencia de Jira
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) |
| `issueKey` | string | Sí | Clave de la incidencia de Jira de la que eliminar el observador \(p. ej., PROJ-123\) |
| `accountId` | string | Sí | ID de cuenta del usuario que se eliminará como observador |
| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `output` | object | Detalles de eliminación con marca de tiempo, clave de incidencia, ID de cuenta del observador y estado de éxito |
## Notas
- Categoría: `tools`

811
apps/docs/content/docs/es/tools/linear.mdx
View File

@@ -1,6 +1,6 @@
---
title: Linear
description: Lee y crea incidencias en Linear
description: Interactúa con incidencias, proyectos y más de Linear
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -38,7 +38,7 @@ En Sim, la integración con Linear permite a tus agentes interactuar sin problem
## Instrucciones de uso
Integra Linear en el flujo de trabajo. Puede leer y crear incidencias. Requiere OAuth.
Integra Linear en el flujo de trabajo. Puede gestionar incidencias, comentarios, proyectos, etiquetas, estados de flujo de trabajo, ciclos, archivos adjuntos y más.
## Herramientas
@@ -59,6 +59,22 @@ Obtener y filtrar incidencias de Linear
| --------- | ---- | ----------- |
| `issues` | array | Array de incidencias del equipo y proyecto de Linear especificados, cada una contiene id, título, descripción, estado, teamId y projectId |
### `linear_get_issue`
Obtener una incidencia individual por ID desde Linear con detalles completos
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia de Linear |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `issue` | object | La incidencia con detalles completos |
### `linear_create_issue`
Crear una nueva incidencia en Linear
@@ -78,6 +94,797 @@ Crear una nueva incidencia en Linear
| --------- | ---- | ----------- |
| `issue` | object | La incidencia creada que contiene id, título, descripción, estado, teamId y projectId |
### `linear_update_issue`
Actualizar una incidencia existente en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia de Linear a actualizar |
| `title` | string | No | Nuevo título de la incidencia |
| `description` | string | No | Nueva descripción de la incidencia |
| `stateId` | string | No | ID del estado del flujo de trabajo \(estado\) |
| `assigneeId` | string | No | ID del usuario al que asignar la incidencia |
| `priority` | number | No | Prioridad \(0=Sin prioridad, 1=Urgente, 2=Alta, 3=Normal, 4=Baja\) |
| `estimate` | number | No | Estimación en puntos |
| `labelIds` | array | No | Array de IDs de etiquetas para establecer en la incidencia |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `issue` | object | La incidencia actualizada |
### `linear_archive_issue`
Archivar una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia de Linear para archivar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la operación de archivo fue exitosa |
| `issueId` | string | El ID de la incidencia archivada |
### `linear_unarchive_issue`
Desarchivar (restaurar) una incidencia archivada en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia de Linear para desarchivar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la operación de desarchivado fue exitosa |
| `issueId` | string | El ID de la incidencia desarchivada |
### `linear_delete_issue`
Eliminar (enviar a la papelera) una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia de Linear para eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la operación de eliminación fue exitosa |
### `linear_search_issues`
Buscar incidencias en Linear utilizando búsqueda de texto completo
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `query` | string | Sí | Cadena de consulta de búsqueda |
| `teamId` | string | No | Filtrar por ID de equipo |
| `includeArchived` | boolean | No | Incluir incidencias archivadas en los resultados de búsqueda |
| `first` | number | No | Número de resultados a devolver \(predeterminado: 50\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `issues` | array | Array de incidencias coincidentes |
### `linear_add_label_to_issue`
Añadir una etiqueta a una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia en Linear |
| `labelId` | string | Sí | ID de la etiqueta para añadir a la incidencia |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la etiqueta se añadió correctamente |
| `issueId` | string | El ID de la incidencia |
### `linear_remove_label_from_issue`
Eliminar una etiqueta de una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia en Linear |
| `labelId` | string | Sí | ID de la etiqueta para eliminar de la incidencia |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la etiqueta se eliminó correctamente |
| `issueId` | string | El ID de la incidencia |
### `linear_create_comment`
Añadir un comentario a una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia de Linear para comentar |
| `body` | string | Sí | Texto del comentario \(admite Markdown\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `comment` | object | El comentario creado |
### `linear_update_comment`
Editar un comentario en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `commentId` | string | Sí | ID del comentario a actualizar |
| `body` | string | Sí | Nuevo texto del comentario \(admite Markdown\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `comment` | object | El comentario actualizado |
### `linear_delete_comment`
Eliminar un comentario de Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `commentId` | string | Sí | ID del comentario a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la operación de eliminación fue exitosa |
### `linear_list_comments`
Listar todos los comentarios de una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia en Linear |
| `first` | number | No | Número de comentarios a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `comments` | array | Array de comentarios sobre la incidencia |
### `linear_list_projects`
Listar proyectos en Linear con filtrado opcional
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | No | Filtrar por ID de equipo |
| `includeArchived` | boolean | No | Incluir proyectos archivados |
| `first` | number | No | Número de proyectos a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `projects` | array | Array de proyectos |
### `linear_get_project`
Obtener un solo proyecto por ID desde Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID del proyecto en Linear |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `project` | object | El proyecto con todos los detalles |
### `linear_create_project`
Crear un nuevo proyecto en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | Sí | ID del equipo donde crear el proyecto |
| `name` | string | Sí | Nombre del proyecto |
| `description` | string | No | Descripción del proyecto |
| `leadId` | string | No | ID del usuario líder del proyecto |
| `startDate` | string | No | Fecha de inicio del proyecto (formato ISO) |
| `targetDate` | string | No | Fecha objetivo del proyecto (formato ISO) |
| `priority` | number | No | Prioridad del proyecto (0-4) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `project` | object | El proyecto creado |
### `linear_update_project`
Actualizar un proyecto existente en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID del proyecto a actualizar |
| `name` | string | No | Nuevo nombre del proyecto |
| `description` | string | No | Nueva descripción del proyecto |
| `state` | string | No | Estado del proyecto (planned, started, completed, canceled) |
| `leadId` | string | No | ID del usuario líder del proyecto |
| `startDate` | string | No | Fecha de inicio del proyecto (formato ISO) |
| `targetDate` | string | No | Fecha objetivo del proyecto (formato ISO) |
| `priority` | number | No | Prioridad del proyecto (0-4) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `project` | object | El proyecto actualizado |
### `linear_archive_project`
Archivar un proyecto en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID del proyecto a archivar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la operación de archivo fue exitosa |
| `projectId` | string | El ID del proyecto archivado |
### `linear_list_users`
Listar todos los usuarios en el espacio de trabajo de Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `includeDisabled` | boolean | No | Incluir usuarios deshabilitados/inactivos |
| `first` | number | No | Número de usuarios a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `users` | array | Array de usuarios del espacio de trabajo |
### `linear_list_teams`
Listar todos los equipos en el espacio de trabajo de Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `first` | number | No | Número de equipos a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `teams` | array | Array de equipos |
### `linear_get_viewer`
Obtener la información del usuario autenticado actualmente (visualizador)
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `user` | object | El usuario autenticado actualmente |
### `linear_list_labels`
Listar todas las etiquetas en el espacio de trabajo o equipo de Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | No | Filtrar por ID de equipo |
| `first` | number | No | Número de etiquetas a devolver (predeterminado: 50) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `labels` | array | Array de etiquetas |
### `linear_create_label`
Crear una nueva etiqueta en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `name` | string | Sí | Nombre de la etiqueta |
| `color` | string | No | Color de la etiqueta (formato hexadecimal, p. ej., "#ff0000") |
| `description` | string | No | Descripción de la etiqueta |
| `teamId` | string | No | ID del equipo (si se omite, crea una etiqueta de espacio de trabajo) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `label` | object | La etiqueta creada |
### `linear_update_label`
Actualizar una etiqueta existente en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `labelId` | string | Sí | ID de la etiqueta a actualizar |
| `name` | string | No | Nuevo nombre de la etiqueta |
| `color` | string | No | Nuevo color de la etiqueta \(formato hex\) |
| `description` | string | No | Nueva descripción de la etiqueta |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `label` | object | La etiqueta actualizada |
### `linear_archive_label`
Archivar una etiqueta en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `labelId` | string | Sí | ID de la etiqueta a archivar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la operación de archivo fue exitosa |
| `labelId` | string | El ID de la etiqueta archivada |
### `linear_list_workflow_states`
Listar todos los estados de flujo de trabajo (estados) en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | No | Filtrar por ID de equipo |
| `first` | number | No | Número de estados a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `states` | array | Array de estados de flujo de trabajo |
### `linear_create_workflow_state`
Crear un nuevo estado de flujo de trabajo (estado) en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | Sí | ID del equipo donde crear el estado |
| `name` | string | Sí | Nombre del estado (p. ej., "En revisión") |
| `color` | string | Sí | Color del estado (formato hex) |
| `type` | string | Sí | Tipo de estado: "backlog", "unstarted", "started", "completed", o "canceled" |
| `description` | string | No | Descripción del estado |
| `position` | number | No | Posición en el flujo de trabajo |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `state` | object | El estado de flujo de trabajo creado |
### `linear_update_workflow_state`
Actualizar un estado de flujo de trabajo existente en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `stateId` | string | Sí | ID del estado de flujo de trabajo a actualizar |
| `name` | string | No | Nuevo nombre del estado |
| `color` | string | No | Nuevo color del estado (formato hex) |
| `description` | string | No | Nueva descripción del estado |
| `position` | number | No | Nueva posición en el flujo de trabajo |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `state` | object | El estado del flujo de trabajo actualizado |
### `linear_list_cycles`
Listar ciclos (sprints/iteraciones) en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | No | Filtrar por ID de equipo |
| `first` | number | No | Número de ciclos a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `cycles` | array | Array de ciclos |
### `linear_get_cycle`
Obtener un solo ciclo por ID desde Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `cycleId` | string | Sí | ID del ciclo |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `cycle` | object | El ciclo con todos los detalles |
### `linear_create_cycle`
Crear un nuevo ciclo (sprint/iteración) en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | Sí | ID del equipo donde crear el ciclo |
| `startsAt` | string | Sí | Fecha de inicio del ciclo \(formato ISO\) |
| `endsAt` | string | Sí | Fecha de finalización del ciclo \(formato ISO\) |
| `name` | string | No | Nombre del ciclo \(opcional, se generará automáticamente si no se proporciona\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `cycle` | object | El ciclo creado |
### `linear_get_active_cycle`
Obtener el ciclo actualmente activo para un equipo
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `teamId` | string | Sí | ID del equipo |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `cycle` | object | El ciclo activo \(null si no hay ciclo activo\) |
### `linear_create_attachment`
Añadir un adjunto a una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia a la que adjuntar |
| `url` | string | Sí | URL del adjunto |
| `title` | string | No | Título del adjunto |
| `subtitle` | string | No | Subtítulo/descripción del adjunto |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `attachment` | object | El adjunto creado |
### `linear_list_attachments`
Listar todos los adjuntos de una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia |
| `first` | number | No | Número de adjuntos a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `attachments` | array | Array de adjuntos |
### `linear_update_attachment`
Actualizar los metadatos de un adjunto en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `attachmentId` | string | Sí | ID del adjunto a actualizar |
| `title` | string | No | Nuevo título del adjunto |
| `subtitle` | string | No | Nuevo subtítulo del adjunto |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `attachment` | object | El adjunto actualizado |
### `linear_delete_attachment`
Eliminar un adjunto de Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `attachmentId` | string | Sí | ID del adjunto a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la operación de eliminación fue exitosa |
### `linear_create_issue_relation`
Vincular dos incidencias en Linear (bloquea, se relaciona con, duplica)
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia de origen |
| `relatedIssueId` | string | Sí | ID de la incidencia de destino a vincular |
| `type` | string | Sí | Tipo de relación: "blocks", "blocked", "duplicate", "related" |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `relation` | object | La relación de incidencia creada |
### `linear_list_issue_relations`
Listar todas las relaciones (dependencias) para una incidencia en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | Sí | ID de la incidencia |
| `first` | number | No | Número de relaciones a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `relations` | array | Array de relaciones de incidencias |
### `linear_delete_issue_relation`
Eliminar una relación entre dos incidencias en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `relationId` | string | Sí | ID de la relación a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la operación de eliminación fue exitosa |
### `linear_create_favorite`
Marcar como favorito una incidencia, proyecto, ciclo o etiqueta en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `issueId` | string | No | ID de la incidencia para marcar como favorito |
| `projectId` | string | No | ID del proyecto para marcar como favorito |
| `cycleId` | string | No | ID del ciclo para marcar como favorito |
| `labelId` | string | No | ID de la etiqueta para marcar como favorito |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `favorite` | object | El favorito creado |
### `linear_list_favorites`
Listar todos los elementos marcados como favoritos para el usuario actual en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `first` | number | No | Número de favoritos a devolver (predeterminado: 50) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `favorites` | array | Array de elementos favoritos |
### `linear_create_project_update`
Publicar una actualización de estado para un proyecto en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID del proyecto para el que publicar la actualización |
| `body` | string | Sí | Mensaje de actualización (admite Markdown) |
| `health` | string | No | Salud del proyecto: "onTrack", "atRisk", o "offTrack" |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `update` | object | La actualización del proyecto creada |
### `linear_list_project_updates`
Listar todas las actualizaciones de estado para un proyecto en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID del proyecto |
| `first` | number | No | Número de actualizaciones a devolver (predeterminado: 50) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `updates` | array | Array de actualizaciones del proyecto |
### `linear_create_project_link`
Añadir un enlace externo a un proyecto en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID del proyecto al que añadir el enlace |
| `url` | string | Sí | URL del enlace externo |
| `label` | string | No | Etiqueta/título del enlace |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `link` | object | El enlace del proyecto creado |
### `linear_list_notifications`
Listar notificaciones para el usuario actual en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `first` | number | No | Número de notificaciones a devolver \(predeterminado: 50\) |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `notifications` | array | Array de notificaciones |
### `linear_update_notification`
Marcar una notificación como leída o no leída en Linear
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `notificationId` | string | Sí | ID de la notificación a actualizar |
| `readAt` | string | No | Marca de tiempo para marcar como leída \(formato ISO\). Pasa null u omite para marcar como no leída |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `notification` | object | La notificación actualizada |
## Notas
- Categoría: `tools`

9
apps/docs/content/docs/es/tools/linkup.mdx
View File

@@ -53,11 +53,18 @@ Busca información en la web usando Linkup
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| --------- | ---- | ---------- | ----------- |
| `q` | string | Sí | La consulta de búsqueda |
| `depth` | string | Sí | Profundidad de búsqueda \(debe ser "standard" o "deep"\) |
| `outputType` | string | Sí | Tipo de salida a devolver \(debe ser "sourcedAnswer" o "searchResults"\) |
| `apiKey` | string | Sí | Introduce tu clave API de Linkup |
| `includeImages` | boolean | No | Si se deben incluir imágenes en los resultados de búsqueda |
| `fromDate` | string | No | Fecha de inicio para filtrar resultados \(formato AAAA-MM-DD\) |
| `toDate` | string | No | Fecha de fin para filtrar resultados \(formato AAAA-MM-DD\) |
| `excludeDomains` | string | No | Lista separada por comas de nombres de dominio a excluir de los resultados de búsqueda |
| `includeDomains` | string | No | Lista separada por comas de nombres de dominio a los que restringir los resultados de búsqueda |
| `includeInlineCitations` | boolean | No | Añadir citas en línea a las respuestas \(solo se aplica cuando outputType es "sourcedAnswer"\) |
| `includeSources` | boolean | No | Incluir fuentes en la respuesta |
#### Salida

220
apps/docs/content/docs/es/tools/microsoft_planner.mdx
View File

@@ -1,6 +1,6 @@
---
title: Microsoft Planner
description: Lee y crea tareas en Microsoft Planner
description: Gestiona tareas, planes y buckets en Microsoft Planner
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -121,7 +121,7 @@ En Sim, la integración de Microsoft Planner permite a tus agentes crear, leer y
## Instrucciones de uso
Integra Microsoft Planner en el flujo de trabajo. Puede leer y crear tareas. Requiere OAuth.
Integra Microsoft Planner en el flujo de trabajo. Gestiona tareas, planes, buckets y detalles de tareas incluyendo listas de verificación y referencias.
## Herramientas
@@ -167,6 +167,222 @@ Crear una nueva tarea en Microsoft Planner
| `task` | object | El objeto de tarea creado con todas sus propiedades |
| `metadata` | object | Metadatos que incluyen planId, taskId y taskUrl |
### `microsoft_planner_update_task`
Actualizar una tarea en Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | Sí | El ID de la tarea a actualizar |
| `etag` | string | Sí | El valor ETag de la tarea a actualizar (encabezado If-Match) |
| `title` | string | No | El nuevo título de la tarea |
| `bucketId` | string | No | El ID del bucket al que mover la tarea |
| `dueDateTime` | string | No | La fecha y hora de vencimiento para la tarea (formato ISO 8601) |
| `startDateTime` | string | No | La fecha y hora de inicio para la tarea (formato ISO 8601) |
| `percentComplete` | number | No | El porcentaje de finalización de la tarea (0-100) |
| `priority` | number | No | La prioridad de la tarea (0-10) |
| `assigneeUserId` | string | No | El ID del usuario al que asignar la tarea |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la tarea se actualizó correctamente |
| `task` | object | El objeto de tarea actualizado con todas sus propiedades |
| `metadata` | object | Metadatos que incluyen taskId, planId y taskUrl |
### `microsoft_planner_delete_task`
Eliminar una tarea de Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | Sí | El ID de la tarea a eliminar |
| `etag` | string | Sí | El valor ETag de la tarea a eliminar (encabezado If-Match) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la tarea se eliminó correctamente |
| `deleted` | boolean | Confirmación de eliminación |
| `metadata` | object | Metadatos adicionales |
### `microsoft_planner_list_plans`
Listar todos los planes en un grupo de Microsoft 365
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `groupId` | string | Sí | El ID del grupo de Microsoft 365 |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si los planes se recuperaron correctamente |
| `plans` | array | Array de objetos de plan |
| `metadata` | object | Metadatos que incluyen groupId y count |
### `microsoft_planner_read_plan`
Obtener detalles de un plan específico de Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `planId` | string | Sí | El ID del plan a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si el plan se recuperó correctamente |
| `plan` | object | El objeto de plan con todas sus propiedades |
| `metadata` | object | Metadatos que incluyen planId y planUrl |
### `microsoft_planner_list_buckets`
Listar todos los buckets en un plan de Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `planId` | string | Sí | El ID del plan |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si los buckets se recuperaron correctamente |
| `buckets` | array | Array de objetos bucket |
| `metadata` | object | Metadatos que incluyen planId y count |
### `microsoft_planner_read_bucket`
Obtener detalles de un bucket específico
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `bucketId` | string | Sí | El ID del bucket a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si el bucket se recuperó correctamente |
| `bucket` | object | El objeto bucket con todas sus propiedades |
| `metadata` | object | Metadatos que incluyen bucketId y planId |
### `microsoft_planner_create_bucket`
Crear un nuevo bucket en un plan de Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `planId` | string | Sí | El ID del plan donde se creará el bucket |
| `name` | string | Sí | El nombre del bucket |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si el bucket se creó correctamente |
| `bucket` | object | El objeto bucket creado con todas sus propiedades |
| `metadata` | object | Metadatos que incluyen bucketId y planId |
### `microsoft_planner_update_bucket`
Actualizar un bucket en Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `bucketId` | string | Sí | El ID del bucket a actualizar |
| `name` | string | No | El nuevo nombre del bucket |
| `etag` | string | Sí | El valor ETag del bucket a actualizar (encabezado If-Match) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si el bucket se actualizó correctamente |
| `bucket` | object | El objeto bucket actualizado con todas sus propiedades |
| `metadata` | object | Metadatos que incluyen bucketId y planId |
### `microsoft_planner_delete_bucket`
Eliminar un bucket de Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `bucketId` | string | Sí | El ID del bucket a eliminar |
| `etag` | string | Sí | El valor ETag del bucket a eliminar (encabezado If-Match) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si el bucket se eliminó correctamente |
| `deleted` | boolean | Confirmación de eliminación |
| `metadata` | object | Metadatos adicionales |
### `microsoft_planner_get_task_details`
Obtener información detallada sobre una tarea, incluyendo lista de verificación y referencias
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | Sí | El ID de la tarea |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si los detalles de la tarea se recuperaron correctamente |
| `taskDetails` | object | Los detalles de la tarea incluyendo descripción, lista de verificación y referencias |
| `metadata` | object | Metadatos incluyendo taskId |
### `microsoft_planner_update_task_details`
Actualizar detalles de la tarea incluyendo descripción, elementos de la lista de verificación y referencias en Microsoft Planner
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | Sí | El ID de la tarea |
| `etag` | string | Sí | El valor ETag de los detalles de la tarea a actualizar (encabezado If-Match) |
| `description` | string | No | La descripción de la tarea |
| `checklist` | object | No | Elementos de la lista de verificación como objeto JSON |
| `references` | object | No | Referencias como objeto JSON |
| `previewType` | string | No | Tipo de vista previa: automatic, noPreview, checklist, description, o reference |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si los detalles de la tarea se actualizaron correctamente |
| `taskDetails` | object | El objeto de detalles de la tarea actualizado con todas sus propiedades |
| `metadata` | object | Metadatos incluyendo taskId |
## Notas
- Categoría: `tools`

207
apps/docs/content/docs/es/tools/microsoft_teams.mdx
View File

@@ -1,6 +1,6 @@
---
title: Microsoft Teams
description: Lee, escribe y crea mensajes
description: Gestionar mensajes, reacciones y miembros en Teams
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -97,7 +97,7 @@ En Sim, la integración con Microsoft Teams permite a tus agentes interactuar di
## Instrucciones de uso
Integra Microsoft Teams en el flujo de trabajo. Puede leer y escribir mensajes de chat, y leer y escribir mensajes de canal. Se puede usar en modo de activación para iniciar un flujo de trabajo cuando se envía un mensaje a un chat o canal. Para mencionar a usuarios en mensajes, envuelve su nombre en etiquetas `<at>`: `<at>userName</at>`
Integra Microsoft Teams en el flujo de trabajo. Lee, escribe, actualiza y elimina mensajes de chat y canal. Responde a mensajes, añade reacciones y lista miembros de equipos/canales. Se puede usar en modo disparador para iniciar un flujo de trabajo cuando se envía un mensaje a un chat o canal. Para mencionar usuarios en mensajes, envuelve su nombre en etiquetas `<at>`: `<at>userName</at>`
## Herramientas
@@ -199,6 +199,209 @@ Escribir o enviar un mensaje a un canal de Microsoft Teams
| `url` | string | URL web del mensaje |
| `updatedContent` | boolean | Si el contenido se actualizó correctamente |
### `microsoft_teams_update_chat_message`
Actualizar un mensaje existente en un chat de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `chatId` | string | Sí | El ID del chat que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a actualizar |
| `content` | string | Sí | El nuevo contenido para el mensaje |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la actualización fue exitosa |
| `messageId` | string | ID del mensaje actualizado |
| `updatedContent` | boolean | Si el contenido se actualizó correctamente |
### `microsoft_teams_update_channel_message`
Actualizar un mensaje existente en un canal de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | Sí | El ID del equipo |
| `channelId` | string | Sí | El ID del canal que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a actualizar |
| `content` | string | Sí | El nuevo contenido para el mensaje |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la actualización fue exitosa |
| `messageId` | string | ID del mensaje actualizado |
| `updatedContent` | boolean | Si el contenido se actualizó correctamente |
### `microsoft_teams_delete_chat_message`
Eliminar de forma suave un mensaje en un chat de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `chatId` | string | Sí | El ID del chat que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la eliminación fue exitosa |
| `deleted` | boolean | Confirmación de eliminación |
| `messageId` | string | ID del mensaje eliminado |
### `microsoft_teams_delete_channel_message`
Eliminar de forma suave un mensaje en un canal de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | Sí | El ID del equipo |
| `channelId` | string | Sí | El ID del canal que contiene el mensaje |
| `messageId` | string | Sí | El ID del mensaje a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la eliminación fue exitosa |
| `deleted` | boolean | Confirmación de eliminación |
| `messageId` | string | ID del mensaje eliminado |
### `microsoft_teams_reply_to_message`
Responder a un mensaje existente en un canal de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | Sí | El ID del equipo |
| `channelId` | string | Sí | El ID del canal |
| `messageId` | string | Sí | El ID del mensaje al que responder |
| `content` | string | Sí | El contenido de la respuesta |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la respuesta fue exitosa |
| `messageId` | string | ID del mensaje de respuesta |
| `updatedContent` | boolean | Si el contenido se envió correctamente |
### `microsoft_teams_get_message`
Obtener un mensaje específico de un chat o canal de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | No | El ID del equipo \(para mensajes de canal\) |
| `channelId` | string | No | El ID del canal \(para mensajes de canal\) |
| `chatId` | string | No | El ID del chat \(para mensajes de chat\) |
| `messageId` | string | Sí | El ID del mensaje a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la recuperación fue exitosa |
| `content` | string | El contenido del mensaje |
| `metadata` | object | Metadatos del mensaje incluyendo remitente, marca de tiempo, etc. |
### `microsoft_teams_set_reaction`
Añadir una reacción con emoji a un mensaje en Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | No | El ID del equipo \(para mensajes de canal\) |
| `channelId` | string | No | El ID del canal \(para mensajes de canal\) |
| `chatId` | string | No | El ID del chat \(para mensajes de chat\) |
| `messageId` | string | Sí | El ID del mensaje al que reaccionar |
| `reactionType` | string | Sí | La reacción con emoji \(p. ej., ❤️, 👍, 😊\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la reacción se añadió correctamente |
| `reactionType` | string | El emoji que se añadió |
| `messageId` | string | ID del mensaje |
### `microsoft_teams_unset_reaction`
Eliminar una reacción con emoji de un mensaje en Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | No | El ID del equipo \(para mensajes de canal\) |
| `channelId` | string | No | El ID del canal \(para mensajes de canal\) |
| `chatId` | string | No | El ID del chat \(para mensajes de chat\) |
| `messageId` | string | Sí | El ID del mensaje |
| `reactionType` | string | Sí | La reacción con emoji a eliminar \(p. ej., ❤️, 👍, 😊\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la reacción se eliminó correctamente |
| `reactionType` | string | El emoji que fue eliminado |
| `messageId` | string | ID del mensaje |
### `microsoft_teams_list_team_members`
Listar todos los miembros de un equipo de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | Sí | El ID del equipo |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si el listado fue exitoso |
| `members` | array | Array de miembros del equipo |
| `memberCount` | number | Número total de miembros |
### `microsoft_teams_list_channel_members`
Listar todos los miembros de un canal de Microsoft Teams
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `teamId` | string | Sí | El ID del equipo |
| `channelId` | string | Sí | El ID del canal |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si el listado fue exitoso |
| `members` | array | Array de miembros del canal |
| `memberCount` | number | Número total de miembros |
## Notas
- Categoría: `tools`

49
apps/docs/content/docs/es/tools/parallel_ai.mdx
View File

@@ -1,6 +1,6 @@
---
title: Parallel AI
description: Buscar con Parallel AI
description: Investigación web con Parallel AI
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -70,7 +70,7 @@ En Sim, la integración con Parallel AI permite a tus agentes realizar búsqueda
## Instrucciones de uso
Integra Parallel AI en el flujo de trabajo. Puede buscar en la web. Requiere clave API.
Integra Parallel AI en el flujo de trabajo. Puede buscar en la web, extraer información de URLs y realizar investigaciones profundas.
## Herramientas
@@ -95,6 +95,51 @@ Busca en la web usando Parallel AI. Proporciona resultados de búsqueda completo
| --------- | ---- | ----------- |
| `results` | array | Resultados de búsqueda con extractos de páginas relevantes |
### `parallel_extract`
Extrae información específica de URLs concretas utilizando Parallel AI. Procesa las URLs proporcionadas para obtener contenido relevante basado en tu objetivo.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ---------- | ----------- |
| `urls` | string | Sí | Lista de URLs separadas por comas para extraer información |
| `objective` | string | Sí | Qué información extraer de las URLs proporcionadas |
| `excerpts` | boolean | Sí | Incluir extractos relevantes del contenido |
| `full_content` | boolean | Sí | Incluir contenido completo de la página |
| `apiKey` | string | Sí | Clave API de Parallel AI |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `results` | array | Información extraída de las URLs proporcionadas |
### `parallel_deep_research`
Realiza investigaciones exhaustivas y profundas en la web utilizando Parallel AI. Sintetiza información de múltiples fuentes con citas. Puede tardar hasta 15 minutos en completarse.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ---------- | ----------- |
| `input` | string | Sí | Consulta o pregunta de investigación \(hasta 15.000 caracteres\) |
| `processor` | string | No | Nivel de cómputo: base, lite, pro, ultra, ultra2x, ultra4x, ultra8x \(predeterminado: base\) |
| `output_schema` | string | No | Descripción del formato de salida deseado. Usa "text" para informes en markdown con citas, o describe un formato JSON estructurado |
| `include_domains` | string | No | Lista de dominios separados por comas para restringir la investigación \(política de fuentes\) |
| `exclude_domains` | string | No | Lista de dominios separados por comas para excluir de la investigación \(política de fuentes\) |
| `apiKey` | string | Sí | Clave API de Parallel AI |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `status` | string | Estado de la tarea (en ejecución, completada, fallida) |
| `run_id` | string | ID único para esta tarea de investigación |
| `message` | string | Mensaje de estado (para tareas en ejecución) |
| `content` | object | Resultados de la investigación (estructurados según output_schema) |
| `basis` | array | Citas y fuentes con extractos y niveles de confianza |
## Notas
- Categoría: `tools`

243
apps/docs/content/docs/es/tools/reddit.mdx
View File

@@ -38,7 +38,7 @@ Estas operaciones permiten a tus agentes acceder y analizar contenido de Reddit
## Instrucciones de uso
Integra Reddit en el flujo de trabajo. Puede obtener publicaciones y comentarios de un subreddit. Requiere OAuth.
Integra Reddit en flujos de trabajo. Lee publicaciones, comentarios y busca contenido. Envía publicaciones, vota, responde, edita y administra tu cuenta de Reddit.
## Herramientas
@@ -54,6 +54,11 @@ Obtener publicaciones de un subreddit con diferentes opciones de ordenación
| `sort` | string | No | Método de ordenación para publicaciones: "hot", "new", "top", o "rising" \(predeterminado: "hot"\) |
| `limit` | number | No | Número máximo de publicaciones a devolver \(predeterminado: 10, máximo: 100\) |
| `time` | string | No | Filtro de tiempo para publicaciones ordenadas por "top": "day", "week", "month", "year", o "all" \(predeterminado: "day"\) |
| `after` | string | No | Nombre completo de un elemento para obtener elementos posteriores \(para paginación\) |
| `before` | string | No | Nombre completo de un elemento para obtener elementos anteriores \(para paginación\) |
| `count` | number | No | Recuento de elementos ya vistos en el listado \(usado para numeración\) |
| `show` | string | No | Mostrar elementos que normalmente serían filtrados \(p. ej., "all"\) |
| `sr_detail` | boolean | No | Expandir detalles del subreddit en la respuesta |
#### Salida
@@ -70,10 +75,20 @@ Obtener comentarios de una publicación específica de Reddit
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `postId` | string | Sí | El ID de la publicación de Reddit de la que se obtendrán los comentarios |
| `postId` | string | Sí | El ID de la publicación de Reddit de la que obtener comentarios |
| `subreddit` | string | Sí | El subreddit donde se encuentra la publicación \(sin el prefijo r/\) |
| `sort` | string | No | Método de ordenación para los comentarios: "confidence", "top", "new", "controversial", "old", "random", "qa" \(predeterminado: "confidence"\) |
| `sort` | string | No | Método de ordenación para comentarios: "confidence", "top", "new", "controversial", "old", "random", "qa" \(predeterminado: "confidence"\) |
| `limit` | number | No | Número máximo de comentarios a devolver \(predeterminado: 50, máximo: 100\) |
| `depth` | number | No | Profundidad máxima de subárboles en el hilo \(controla niveles de comentarios anidados\) |
| `context` | number | No | Número de comentarios principales a incluir |
| `showedits` | boolean | No | Mostrar información de edición para comentarios |
| `showmore` | boolean | No | Incluir elementos "cargar más comentarios" en la respuesta |
| `showtitle` | boolean | No | Incluir título de la publicación en la respuesta |
| `threaded` | boolean | No | Devolver comentarios en formato anidado/jerarquizado |
| `truncate` | number | No | Entero para truncar la profundidad de comentarios |
| `after` | string | No | Nombre completo de un elemento para obtener elementos posteriores \(para paginación\) |
| `before` | string | No | Nombre completo de un elemento para obtener elementos anteriores \(para paginación\) |
| `count` | number | No | Recuento de elementos ya vistos en el listado \(usado para numeración\) |
#### Salida
@@ -81,6 +96,228 @@ Obtener comentarios de una publicación específica de Reddit
| --------- | ---- | ----------- |
| `post` | object | Información de la publicación incluyendo ID, título, autor, contenido y metadatos |
### `reddit_get_controversial`
Obtener publicaciones controvertidas de un subreddit
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `subreddit` | string | Sí | El nombre del subreddit del que obtener publicaciones \(sin el prefijo r/\) |
| `time` | string | No | Filtro de tiempo para publicaciones controvertidas: "hour", "day", "week", "month", "year", o "all" \(predeterminado: "all"\) |
| `limit` | number | No | Número máximo de publicaciones a devolver \(predeterminado: 10, máximo: 100\) |
| `after` | string | No | Nombre completo de un elemento para obtener elementos posteriores \(para paginación\) |
| `before` | string | No | Nombre completo de un elemento para obtener elementos anteriores \(para paginación\) |
| `count` | number | No | Recuento de elementos ya vistos en el listado \(usado para numeración\) |
| `show` | string | No | Mostrar elementos que normalmente serían filtrados \(p. ej., "all"\) |
| `sr_detail` | boolean | No | Expandir detalles del subreddit en la respuesta |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `subreddit` | string | Nombre del subreddit del que se obtuvieron las publicaciones |
| `posts` | array | Array de publicaciones controvertidas con título, autor, URL, puntuación, recuento de comentarios y metadatos |
### `reddit_get_gilded`
Obtener publicaciones premiadas/con medallas de un subreddit
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `subreddit` | string | Sí | El nombre del subreddit del que obtener publicaciones \(sin el prefijo r/\) |
| `limit` | number | No | Número máximo de publicaciones a devolver \(predeterminado: 10, máximo: 100\) |
| `after` | string | No | Nombre completo de un elemento para obtener elementos posteriores \(para paginación\) |
| `before` | string | No | Nombre completo de un elemento para obtener elementos anteriores \(para paginación\) |
| `count` | number | No | Recuento de elementos ya vistos en el listado \(usado para numeración\) |
| `show` | string | No | Mostrar elementos que normalmente serían filtrados \(p. ej., "all"\) |
| `sr_detail` | boolean | No | Expandir detalles del subreddit en la respuesta |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `subreddit` | string | Nombre del subreddit del que se obtuvieron las publicaciones |
| `posts` | array | Array de publicaciones premiadas/con insignias con título, autor, URL, puntuación, recuento de comentarios y metadatos |
### `reddit_search`
Buscar publicaciones dentro de un subreddit
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `subreddit` | string | Sí | El nombre del subreddit en el que buscar \(sin el prefijo r/\) |
| `query` | string | Sí | Texto de la consulta de búsqueda |
| `sort` | string | No | Método de ordenación para los resultados de búsqueda: "relevance", "hot", "top", "new", o "comments" \(predeterminado: "relevance"\) |
| `time` | string | No | Filtro de tiempo para los resultados de búsqueda: "hour", "day", "week", "month", "year", o "all" \(predeterminado: "all"\) |
| `limit` | number | No | Número máximo de publicaciones a devolver \(predeterminado: 10, máximo: 100\) |
| `restrict_sr` | boolean | No | Restringir la búsqueda solo al subreddit especificado \(predeterminado: true\) |
| `after` | string | No | Nombre completo de un elemento para obtener elementos posteriores \(para paginación\) |
| `before` | string | No | Nombre completo de un elemento para obtener elementos anteriores \(para paginación\) |
| `count` | number | No | Recuento de elementos ya vistos en el listado \(usado para numeración\) |
| `show` | string | No | Mostrar elementos que normalmente serían filtrados \(por ejemplo, "all"\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `subreddit` | string | Nombre del subreddit donde se realizó la búsqueda |
| `posts` | array | Array de publicaciones de resultados de búsqueda con título, autor, URL, puntuación, recuento de comentarios y metadatos |
### `reddit_submit_post`
Enviar una nueva publicación a un subreddit (texto o enlace)
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `subreddit` | string | Sí | El nombre del subreddit donde publicar \(sin el prefijo r/\) |
| `title` | string | Sí | Título de la publicación \(máximo 300 caracteres\) |
| `text` | string | No | Contenido de texto para una publicación de texto \(admite markdown\) |
| `url` | string | No | URL para una publicación de enlace \(no se puede usar con texto\) |
| `nsfw` | boolean | No | Marcar publicación como NSFW |
| `spoiler` | boolean | No | Marcar publicación como spoiler |
| `send_replies` | boolean | No | Enviar notificaciones de respuesta a la bandeja de entrada \(predeterminado: true\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la publicación se envió correctamente |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos de la publicación incluyendo ID, nombre, URL y permalink |
### `reddit_vote`
Votar positivamente, negativamente o quitar voto a una publicación o comentario de Reddit
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `id` | string | Sí | Nombre completo del elemento para votar \(p. ej., t3_xxxxx para publicación, t1_xxxxx para comentario\) |
| `dir` | number | Sí | Dirección del voto: 1 \(voto positivo\), 0 \(quitar voto\), o -1 \(voto negativo\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si el voto fue exitoso |
| `message` | string | Mensaje de éxito o error |
### `reddit_save`
Guardar una publicación o comentario de Reddit en tus elementos guardados
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `id` | string | Sí | Nombre completo del elemento a guardar \(p. ej., t3_xxxxx para publicación, t1_xxxxx para comentario\) |
| `category` | string | No | Categoría bajo la cual guardar \(función de Reddit Gold\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si el guardado fue exitoso |
| `message` | string | Mensaje de éxito o error |
### `reddit_unsave`
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `subreddit` | string | Nombre del subreddit |
| `posts` | json | Datos de publicaciones |
| `post` | json | Datos de una sola publicación |
| `comments` | json | Datos de comentarios |
### `reddit_reply`
Añadir una respuesta de comentario a una publicación o comentario de Reddit
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `parent_id` | string | Sí | Nombre completo del elemento al que responder (p. ej., t3_xxxxx para publicación, t1_xxxxx para comentario) |
| `text` | string | Sí | Texto del comentario en formato markdown |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la respuesta se publicó correctamente |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del comentario incluyendo ID, nombre, enlace permanente y cuerpo |
### `reddit_edit`
Editar el texto de tu propia publicación o comentario de Reddit
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `thing_id` | string | Sí | Nombre completo del elemento a editar (p. ej., t3_xxxxx para publicación, t1_xxxxx para comentario) |
| `text` | string | Sí | Nuevo contenido de texto en formato markdown |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la edición fue exitosa |
| `message` | string | Mensaje de éxito o error |
| `data` | object | Datos del contenido actualizado |
### `reddit_delete`
Eliminar tu propia publicación o comentario de Reddit
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `id` | string | Sí | Nombre completo del elemento a eliminar (p. ej., t3_xxxxx para publicación, t1_xxxxx para comentario) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la eliminación fue exitosa |
| `message` | string | Mensaje de éxito o error |
### `reddit_subscribe`
Suscribirse o cancelar la suscripción a un subreddit
#### Entrada
| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `subreddit` | string | Sí | El nombre del subreddit \(sin el prefijo r/\) |
| `action` | string | Sí | Acción a realizar: "sub" para suscribirse o "unsub" para cancelar la suscripción |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la acción de suscripción fue exitosa |
| `message` | string | Mensaje de éxito o error |
## Notas
- Categoría: `tools`

1066
apps/docs/content/docs/es/tools/stripe.mdx Normal file
View File

File diff suppressed because it is too large Load Diff

310
apps/docs/content/docs/es/tools/supabase.mdx
View File

@@ -75,7 +75,7 @@ Ya sea que estés construyendo herramientas internas, automatizando procesos de
## Instrucciones de uso
Integra Supabase en el flujo de trabajo. Puede obtener muchas filas, obtener, crear, actualizar, eliminar y actualizar/insertar una fila.
Integra Supabase en el flujo de trabajo. Admite operaciones de base de datos (consulta, inserción, actualización, eliminación, upsert), búsqueda de texto completo, funciones RPC, conteo de filas, búsqueda vectorial y gestión completa de almacenamiento (subir, descargar, listar, mover, copiar, eliminar archivos y buckets).
## Herramientas
@@ -202,6 +202,51 @@ Insertar o actualizar datos en una tabla de Supabase (operación upsert)
| `message` | string | Mensaje de estado de la operación |
| `results` | array | Array de registros insertados o actualizados |
### `supabase_count`
Contar filas en una tabla de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `table` | string | Sí | Nombre de la tabla Supabase de la que contar filas |
| `filter` | string | No | Filtro PostgREST \(p. ej., "status=eq.active"\) |
| `countType` | string | No | Tipo de conteo: exact, planned o estimated \(predeterminado: exact\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `count` | number | Número de filas que coinciden con el filtro |
### `supabase_text_search`
Realizar búsqueda de texto completo en una tabla de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `table` | string | Sí | Nombre de la tabla Supabase en la que buscar |
| `column` | string | Sí | La columna en la que buscar |
| `query` | string | Sí | La consulta de búsqueda |
| `searchType` | string | No | Tipo de búsqueda: plain, phrase o websearch \(predeterminado: websearch\) |
| `language` | string | No | Idioma para la configuración de búsqueda de texto \(predeterminado: english\) |
| `limit` | number | No | Número máximo de filas a devolver |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | array | Array de registros que coinciden con la consulta de búsqueda |
### `supabase_vector_search`
Realizar búsqueda de similitud usando pgvector en una tabla de Supabase
@@ -210,11 +255,11 @@ Realizar búsqueda de similitud usando pgvector en una tabla de Supabase
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `functionName` | string | Sí | Nombre de la función PostgreSQL que realiza la búsqueda vectorial \(p. ej., match_documents\) |
| `projectId` | string | Sí | ID de tu proyecto Supabase (p. ej., jdrkgepadsdopsntdlom) |
| `functionName` | string | Sí | Nombre de la función PostgreSQL que realiza la búsqueda vectorial (p. ej., match_documents) |
| `queryEmbedding` | array | Sí | El vector/embedding de consulta para buscar elementos similares |
| `matchThreshold` | number | No | Umbral mínimo de similitud \(0-1\), típicamente 0.7-0.9 |
| `matchCount` | number | No | Número máximo de resultados a devolver \(predeterminado: 10\) |
| `matchThreshold` | number | No | Umbral mínimo de similitud (0-1), típicamente 0.7-0.9 |
| `matchCount` | number | No | Número máximo de resultados a devolver (predeterminado: 10) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
@@ -222,7 +267,260 @@ Realizar búsqueda de similitud usando pgvector en una tabla de Supabase
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | array | Array de registros con puntuaciones de similitud de la búsqueda vectorial. Cada registro incluye un campo de similitud \(0-1\) que indica cuán similar es al vector de consulta. |
| `results` | array | Array de registros con puntuaciones de similitud de la búsqueda vectorial. Cada registro incluye un campo de similitud (0-1) que indica cuán similar es al vector de consulta. |
### `supabase_rpc`
Llamar a una función PostgreSQL en Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase (p. ej., jdrkgepadsdopsntdlom) |
| `functionName` | string | Sí | Nombre de la función PostgreSQL a llamar |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | json | Resultado devuelto por la función |
### `supabase_storage_upload`
Subir un archivo a un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `path` | string | Sí | La ruta donde se almacenará el archivo \(p. ej., "carpeta/archivo.jpg"\) |
| `fileContent` | string | Sí | El contenido del archivo \(codificado en base64 para archivos binarios, o texto plano\) |
| `contentType` | string | No | Tipo MIME del archivo \(p. ej., "image/jpeg", "text/plain"\) |
| `upsert` | boolean | No | Si es verdadero, sobrescribe el archivo existente \(predeterminado: false\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | object | Resultado de la subida incluyendo ruta del archivo y metadatos |
### `supabase_storage_download`
Descargar un archivo de un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `path` | string | Sí | La ruta al archivo para descargar \(p. ej., "carpeta/archivo.jpg"\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `fileContent` | string | Contenido del archivo \(codificado en base64 si es binario, texto plano en caso contrario\) |
| `contentType` | string | Tipo MIME del archivo |
| `isBase64` | boolean | Indica si el contenido del archivo está codificado en base64 |
### `supabase_storage_list`
Listar archivos en un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `path` | string | No | La ruta de la carpeta desde donde listar archivos \(predeterminado: raíz\) |
| `limit` | number | No | Número máximo de archivos a devolver \(predeterminado: 100\) |
| `offset` | number | No | Número de archivos a omitir \(para paginación\) |
| `sortBy` | string | No | Columna para ordenar: name, created_at, updated_at \(predeterminado: name\) |
| `sortOrder` | string | No | Orden de clasificación: asc o desc \(predeterminado: asc\) |
| `search` | string | No | Término de búsqueda para filtrar archivos por nombre |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | array | Array de objetos de archivo con metadatos |
### `supabase_storage_delete`
Eliminar archivos de un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `paths` | array | Sí | Array de rutas de archivos a eliminar \(p. ej., \["carpeta/archivo1.jpg", "carpeta/archivo2.jpg"\]\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | array | Array de objetos de archivos eliminados |
### `supabase_storage_move`
Mover un archivo dentro de un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `fromPath` | string | Sí | La ruta actual del archivo \(p. ej., "carpeta/viejo.jpg"\) |
| `toPath` | string | Sí | La nueva ruta para el archivo \(p. ej., "nuevacarpeta/nuevo.jpg"\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | object | Resultado de la operación de movimiento |
### `supabase_storage_copy`
Copiar un archivo dentro de un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `fromPath` | string | Sí | La ruta del archivo de origen \(p. ej., "carpeta/origen.jpg"\) |
| `toPath` | string | Sí | La ruta para el archivo copiado \(p. ej., "carpeta/copia.jpg"\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | object | Resultado de la operación de copia |
### `supabase_storage_create_bucket`
Crear un nuevo bucket de almacenamiento en Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket a crear |
| `isPublic` | boolean | No | Si el bucket debe ser accesible públicamente \(predeterminado: false\) |
| `fileSizeLimit` | number | No | Tamaño máximo de archivo en bytes \(opcional\) |
| `allowedMimeTypes` | array | No | Array de tipos MIME permitidos \(p. ej., \["image/png", "image/jpeg"\]\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | object | Información del bucket creado |
### `supabase_storage_list_buckets`
Listar todos los buckets de almacenamiento en Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | array | Array de objetos de bucket |
### `supabase_storage_delete_bucket`
Eliminar un bucket de almacenamiento en Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket a eliminar |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `results` | object | Resultado de la operación de eliminación |
### `supabase_storage_get_public_url`
Obtener la URL pública para un archivo en un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `path` | string | Sí | La ruta al archivo \(p. ej., "carpeta/archivo.jpg"\) |
| `download` | boolean | No | Si es verdadero, fuerza la descarga en lugar de mostrar en línea \(predeterminado: false\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `publicUrl` | string | La URL pública para acceder al archivo |
### `supabase_storage_create_signed_url`
Crear una URL firmada temporal para un archivo en un bucket de almacenamiento de Supabase
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `projectId` | string | Sí | ID de tu proyecto Supabase \(p. ej., jdrkgepadsdopsntdlom\) |
| `bucket` | string | Sí | El nombre del bucket de almacenamiento |
| `path` | string | Sí | La ruta al archivo \(p. ej., "carpeta/archivo.jpg"\) |
| `expiresIn` | number | Sí | Número de segundos hasta que expire la URL \(p. ej., 3600 para 1 hora\) |
| `download` | boolean | No | Si es verdadero, fuerza la descarga en lugar de mostrar en línea \(predeterminado: false\) |
| `apiKey` | string | Sí | Tu clave secreta de rol de servicio de Supabase |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de estado de la operación |
| `signedUrl` | string | La URL firmada temporal para acceder al archivo |
## Notas

78
apps/docs/content/docs/es/tools/tavily.mdx
View File

@@ -71,6 +71,21 @@ Realiza búsquedas web potenciadas por IA usando Tavily
| --------- | ---- | -------- | ----------- |
| `query` | string | Sí | La consulta de búsqueda a ejecutar |
| `max_results` | number | No | Número máximo de resultados \(1-20\) |
| `topic` | string | No | Tipo de categoría: general, noticias o finanzas \(predeterminado: general\) |
| `search_depth` | string | No | Alcance de búsqueda: básico \(1 crédito\) o avanzado \(2 créditos\) \(predeterminado: básico\) |
| `include_answer` | string | No | Respuesta generada por LLM: true/basic para respuesta rápida o advanced para detallada |
| `include_raw_content` | string | No | Contenido HTML analizado: true/markdown o formato de texto |
| `include_images` | boolean | No | Incluir resultados de búsqueda de imágenes |
| `include_image_descriptions` | boolean | No | Añadir texto descriptivo para imágenes |
| `include_favicon` | boolean | No | Incluir URLs de favicon |
| `chunks_per_source` | number | No | Número máximo de fragmentos relevantes por fuente \(1-3, predeterminado: 3\) |
| `time_range` | string | No | Filtrar por actualidad: día/d, semana/w, mes/m, año/y |
| `start_date` | string | No | Fecha de publicación más temprana \(formato AAAA-MM-DD\) |
| `end_date` | string | No | Fecha de publicación más reciente \(formato AAAA-MM-DD\) |
| `include_domains` | string | No | Lista separada por comas de dominios permitidos \(máx. 300\) |
| `exclude_domains` | string | No | Lista separada por comas de dominios bloqueados \(máx. 150\) |
| `country` | string | No | Potenciar resultados del país especificado \(solo tema general\) |
| `auto_parameters` | boolean | No | Configuración automática de parámetros basada en la intención de la consulta |
| `apiKey` | string | Sí | Clave API de Tavily |
#### Salida
@@ -88,8 +103,11 @@ Extrae contenido en bruto de múltiples páginas web simultáneamente usando Tav
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `urls` | string | Sí | URL o array de URLs para extraer contenido |
| `urls` | string | Sí | URL o array de URLs de donde extraer contenido |
| `extract_depth` | string | No | La profundidad de extracción \(básica=1 crédito/5 URLs, avanzada=2 créditos/5 URLs\) |
| `format` | string | No | Formato de salida: markdown o texto \(predeterminado: markdown\) |
| `include_images` | boolean | No | Incorporar imágenes en la salida de extracción |
| `include_favicon` | boolean | No | Añadir URL del favicon para cada resultado |
| `apiKey` | string | Sí | Clave API de Tavily |
#### Salida
@@ -98,6 +116,64 @@ Extrae contenido en bruto de múltiples páginas web simultáneamente usando Tav
| --------- | ---- | ----------- |
| `results` | array | La URL que fue extraída |
### `tavily_crawl`
Rastrea y extrae contenido sistemáticamente de sitios web usando Tavily
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `url` | string | Sí | La URL raíz para comenzar el rastreo |
| `instructions` | string | No | Instrucciones en lenguaje natural para el rastreador \(cuesta 2 créditos por 10 páginas\) |
| `max_depth` | number | No | Qué tan lejos de la URL base explorar \(1-5, predeterminado: 1\) |
| `max_breadth` | number | No | Enlaces seguidos por nivel de página \(≥1, predeterminado: 20\) |
| `limit` | number | No | Total de enlaces procesados antes de detenerse \(≥1, predeterminado: 50\) |
| `select_paths` | string | No | Patrones regex separados por comas para incluir rutas de URL específicas \(ej., /docs/.*\) |
| `select_domains` | string | No | Patrones regex separados por comas para restringir el rastreo a ciertos dominios |
| `exclude_paths` | string | No | Patrones regex separados por comas para omitir rutas de URL específicas |
| `exclude_domains` | string | No | Patrones regex separados por comas para bloquear ciertos dominios |
| `allow_external` | boolean | No | Incluir enlaces de dominios externos en los resultados \(predeterminado: true\) |
| `include_images` | boolean | No | Incorporar imágenes en la salida del rastreo |
| `extract_depth` | string | No | Profundidad de extracción: básica \(1 crédito/5 páginas\) o avanzada \(2 créditos/5 páginas\) |
| `format` | string | No | Formato de salida: markdown o texto \(predeterminado: markdown\) |
| `include_favicon` | boolean | No | Añadir URL del favicon para cada resultado |
| `apiKey` | string | Sí | Clave API de Tavily |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `base_url` | string | La URL base que fue rastreada |
| `results` | array | La URL de la página rastreada |
### `tavily_map`
Descubre y visualiza la estructura de sitios web usando Tavily
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `url` | string | Sí | La URL raíz para comenzar el mapeo |
| `instructions` | string | No | Guía en lenguaje natural para el comportamiento de mapeo \(cuesta 2 créditos por cada 10 páginas\) |
| `max_depth` | number | No | Qué tan lejos de la URL base explorar \(1-5, predeterminado: 1\) |
| `max_breadth` | number | No | Enlaces a seguir por nivel \(predeterminado: 20\) |
| `limit` | number | No | Total de enlaces a procesar \(predeterminado: 50\) |
| `select_paths` | string | No | Patrones regex separados por comas para filtrar rutas de URL \(ej., /docs/.*\) |
| `select_domains` | string | No | Patrones regex separados por comas para restringir el mapeo a dominios específicos |
| `exclude_paths` | string | No | Patrones regex separados por comas para excluir rutas de URL específicas |
| `exclude_domains` | string | No | Patrones regex separados por comas para excluir dominios |
| `allow_external` | boolean | No | Incluir enlaces de dominios externos en los resultados \(predeterminado: true\) |
| `apiKey` | string | Sí | Clave API de Tavily |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `base_url` | string | La URL base que fue mapeada |
| `results` | array | URL descubierta |
## Notas
- Categoría: `tools`