Herramientas

La pestaña Herramientas en el Agent Builder le permite agregar herramientas y flujos de trabajo personalizados a sus agentes. A diferencia de los Toolkits (que son integraciones preconstruidas), las Herramientas son herramientas y flujos de trabajo personalizados creados por el usuario que extienden las capacidades de su agente con funcionalidad específica adaptada a sus necesidades.

​

Descripción General

Las Herramientas le permiten:

• Agregar Herramientas Personalizadas: Adjunte herramientas personalizadas que ha creado en su proyecto
• Agregar Flujos de Trabajo: Incluya flujos de trabajo/acciones que ejecuten procesos de múltiples pasos
• Crear Nuevas Herramientas: Construya nuevas herramientas personalizadas directamente desde el agent builder
• Gestionar la Configuración de Herramientas: Configure cómo las herramientas son utilizadas por el agente
• Explorar la Biblioteca de Herramientas: Acceda a miles de herramientas preconstruidas de la biblioteca pública

​

Herramientas vs. Toolkits

Entender la diferencia le ayuda a elegir el enfoque correcto: Cuándo Usar Herramientas:

• Necesita lógica de negocio personalizada
• Desea crear flujos de trabajo reutilizables
• Necesita integrar con APIs personalizadas
• Desea combinar múltiples operaciones en una herramienta

Cuándo Usar Toolkits:

• Necesita integraciones estándar (Gmail, Slack, etc.)
• Desea autenticación preconfigurada
• Necesita operaciones comunes (enviar correo, crear tarea, etc.)

​

Acceder a la Pestaña de Herramientas

1. Abra el Agent Builder
   • Navegue a Agentes en la barra lateral
   • Haga clic en Editar en un agente existente o Crear Agente
   • Se abrirá el Agent Builder
2. Navegue a la Pestaña de Herramientas
   • En la barra lateral izquierda, haga clic en Herramientas
   • La pestaña de Herramientas se mostrará con sus herramientas seleccionadas y opciones para agregar más

​

Agregar Herramientas a Su Agente

​

Agregar Herramientas Personalizadas Existentes

1. Abra el Selector de Herramientas
   • Haga clic en el botón + Agregar Herramienta en la pestaña de Herramientas
   • Se abrirá el modal del Selector de Herramientas
2. Explore las Herramientas Disponibles
   • Herramientas Personalizadas: Herramientas que ha creado en su proyecto
   • Herramientas Públicas: Herramientas de la biblioteca pública (más de 9,000 disponibles)
   • Flujos de Trabajo: Flujos de trabajo existentes de su proyecto
3. Busque y Filtre
   • Use la barra de búsqueda para encontrar herramientas específicas
   • Filtre por categoría o tipo
   • Explore por popularidad o adiciones recientes
4. Seleccione una Herramienta
   • Haga clic en una herramienta para ver sus detalles
   • Revise la descripción y las entradas de la herramienta
   • Haga clic en Agregar para adjuntarla a su agente

​

Crear una Nueva Herramienta Personalizada

1. Desde el Selector de Herramientas
   • Haga clic en + Agregar Herramienta en la pestaña de Herramientas
   • Haga clic en Crear Herramienta Personalizada en el modal
   • Será redirigido al Tool Builder
2. Desde Estado Vacío
   • Si no tiene herramientas, haga clic en Cree Su Primera Herramienta
   • Esto abre el Tool Builder para una nueva herramienta
3. Configure Su Herramienta
   • Nombre: Dé a su herramienta un nombre descriptivo
   • Descripción: Explique qué hace la herramienta
   • Entradas: Defina los parámetros de entrada
   • Pasos: Configure los pasos de ejecución de la herramienta
   • Guardar: Guarde como borrador o publique
4. Regrese al Agente
   • Después de crearla, la herramienta estará disponible en su proyecto
   • Regrese al agent builder y agréguela a través del selector de Herramientas

​

Agregar Flujos de Trabajo

1. Abra el Selector de Herramientas
   • Haga clic en + Agregar Herramienta en la pestaña de Herramientas
   • Haga clic en Crear Flujo de Trabajo en el modal
2. Seleccione el Desencadenante del Flujo de Trabajo
   • Elija el tipo de desencadenante:
     • Entrada de Formulario: El usuario completa un formulario
     • Carga de Archivo: El usuario carga archivos
     • Manual: Ejecutar bajo demanda
3. Configure el Flujo de Trabajo
   • Configure los pasos del flujo de trabajo
   • Defina entradas y salidas
   • Configure los ajustes del desencadenante
4. Agregue al Agente
   • Una vez creado, el flujo de trabajo aparecerá en su lista de herramientas
   • Puede ser ejecutado por el agente cuando sea necesario

​

Gestionar Herramientas

​

Ver Herramientas Agregadas

La pestaña Herramientas muestra:

• Barra Lateral: Muestra todas las herramientas agregadas al agente
  • Herramientas personalizadas
  • Flujos de trabajo
  • Acciones de su proyecto
• Área Principal: Muestra detalles de la herramienta y opciones de gestión

​

Estado de las Herramientas

Las herramientas pueden tener diferentes estados:

• Activa: La herramienta está lista para usar
• Borrador: La herramienta se está editando (aún no publicada)
• Publicada: La herramienta ha sido publicada y está disponible

​

Configurar Herramientas

1. Editar Configuración de Herramienta
   • Haga clic en Configurar en una herramienta agregada
   • Ajuste la configuración específica de la herramienta
   • Establezca requisitos de aprobación (si es necesario)
2. Configuración de Aprobación de Herramientas
   • Ejecución automática: La herramienta se ejecuta automáticamente cuando se activa
   • Requiere Aprobación: El agente solicita confirmación antes de ejecutar
3. Valores Predeterminados de Entrada
   • Establezca valores predeterminados para las entradas de la herramienta
   • Configure entradas requeridas vs. opcionales

​

Eliminar Herramientas

1. Eliminar del Agente
   • Haga clic en el botón X en una herramienta en la barra lateral
   • O haga clic en Eliminar en los detalles de la herramienta
   • Confirme la eliminación
2. Eliminar Herramienta Personalizada
   • Para herramientas personalizadas, puede eliminarlas completamente
   • Haga clic en el menú de tres puntos en una herramienta personalizada
   • Seleccione Eliminar
   • Nota: Esto elimina permanentemente la herramienta de su proyecto

​

Tipos de Herramientas

​

Herramientas Personalizadas

Las herramientas personalizadas son herramientas que crea con:

• Lógica Personalizada: Sus propias reglas y procesos de negocio
• Integraciones API: Conecte con sus propias APIs
• Operaciones de Múltiples Pasos: Combine múltiples acciones
• Procesamiento de Datos: Transforme y manipule datos

Creación de Herramientas Personalizadas:

1. Defina entradas (parámetros que acepta la herramienta)
2. Configure pasos (qué hace la herramienta)
3. Configure el manejo de errores
4. Pruebe la herramienta
5. Publique cuando esté lista

​

Flujos de Trabajo

Los flujos de trabajo son procesos de múltiples pasos que pueden:

• Ejecutar Secuencias: Ejecutar múltiples operaciones en orden
• Manejar Desencadenantes: Responder a entradas de formularios o cargas de archivos
• Procesar Datos: Transformar datos a través de múltiples pasos
• Integrar Servicios: Conectar múltiples servicios entre sí

Desencadenantes de Flujos de Trabajo:

• Entrada de Formulario: El usuario proporciona entrada a través de un formulario
• Carga de Archivo: El usuario carga archivos para procesamiento
• Manual: Ejecutar bajo demanda por el agente

​

Herramientas Públicas

La biblioteca pública de herramientas incluye:

• Más de 9,000 Herramientas: Herramientas preconstruidas de la comunidad
• Varias Categorías: Comunicación, productividad, datos, etc.
• Listas para Usar: Clone y personalice según sus necesidades
• Actualizadas Regularmente: Nuevas herramientas agregadas frecuentemente

Uso de Herramientas Públicas:

1. Explore la biblioteca pública
2. Encuentre una herramienta que se adapte a sus necesidades
3. Clone la herramienta en su proyecto
4. Personalice si es necesario
5. Agréguela a su agente

​

Mejores Prácticas

​

Organización de Herramientas

1. Nombres Claros: Use nombres descriptivos que expliquen el propósito de la herramienta
2. Buena Documentación: Agregue descripciones claras para cada herramienta
3. Agrupe Herramientas Relacionadas: Organice herramientas por función o categoría
4. Control de Versiones: Use borradores para pruebas antes de publicar

​

Selección de Herramientas

1. Comience Simple: Empiece con herramientas básicas y agregue complejidad gradualmente
2. Pruebe a Fondo: Pruebe las herramientas antes de agregarlas a agentes de producción
3. Considere el Rendimiento: Demasiadas herramientas pueden ralentizar las respuestas del agente
4. Revise Regularmente: Elimine herramientas no utilizadas para mantener la eficiencia de los agentes

​

Configuración de Herramientas

1. Establezca Valores Predeterminados Apropiados: Configure valores predeterminados razonables
2. Use Aprobación Cuando Sea Necesario: Requiera aprobación para operaciones sensibles
3. Maneje Errores: Asegúrese de que las herramientas tengan un manejo de errores adecuado
4. Documente las Entradas: Documente claramente qué hace cada entrada

​

Casos de Uso

​

Agente de Soporte al Cliente

Herramientas Necesarias:

• Herramienta de Creación de Tickets: Herramienta personalizada para crear tickets de soporte
• Búsqueda en Base de Conocimiento: Herramienta para buscar documentación
• Escalamiento de Problemas: Flujo de trabajo para escalar a un agente humano

​

Agente de Análisis de Datos

Herramientas Necesarias:

• Herramienta de Procesamiento de Datos: Herramienta personalizada para transformación de datos
• Generación de Informes: Flujo de trabajo para generar informes
• Exportación de Datos: Herramienta para exportar resultados

​

Agente de Creación de Contenido

Herramientas Necesarias:

• Generador de Contenido: Herramienta personalizada para creación de contenido
• Generación de Imágenes: Herramienta para crear imágenes
• Flujo de Trabajo de Publicación: Flujo de trabajo para publicar contenido

​

Solución de Problemas

​

La Herramienta No Aparece

Problema: La herramienta no se muestra en el selector Soluciones:

• Verifique si la herramienta está publicada (los borradores pueden no aparecer)
• Confirme que está en el proyecto correcto
• Actualice la lista de herramientas
• Verifique los permisos de la herramienta

​

La Herramienta No Se Ejecuta

Problema: El agente no usa la herramienta Soluciones:

• Verifique que la herramienta esté agregada al agente
• Revise la configuración de la herramienta
• Revise el prompt del sistema del agente (puede necesitar mencionar la herramienta)
• Pruebe la herramienta de forma independiente

​

Errores de Ejecución de Herramientas

Problema: La herramienta falla cuando se ejecuta Soluciones:

• Verifique que las entradas de la herramienta sean correctas
• Revise la configuración de la herramienta
• Revise los mensajes de error en los registros de ejecución de herramientas
• Pruebe la herramienta con entradas de ejemplo

​

La Aprobación No Funciona

Problema: La herramienta se ejecuta sin aprobación cuando debería requerirla Soluciones:

• Verifique la configuración de aprobación en la configuración de la herramienta
• Confirme que el agente tiene permiso para solicitar aprobación
• Revise la configuración de aprobación de la herramienta

​

Documentación Relacionada

• Flujos de Trabajo - Aprenda sobre la creación de flujos de trabajo
• Toolkits - Comprenda las integraciones preconstruidas
• Agent Builder - Guía general de configuración de agentes