Worker Configuration — Habilidades y Herramientas (Skills & Tools)
URL:
https://app.getdarwin.ai/ou/{orgId}/workforce/worker/{workerId}?tab=toolbox
1. Habilidades (Skills)
"Una habilidad es un conjunto de instrucciones reutilizables que le enseñan a tu worker a realizar una tarea que aparece con frecuencia, por ejemplo agendar una reunión en Google Calendar o buscar un cliente en tu CRM. Escribes las instrucciones una sola vez y, si quieres, agregas las herramientas que la tarea necesita. A partir de ahí puedes reutilizar esa habilidad en cuantas etapas del pipeline quieras: cuando la adjuntas a una etapa, sus instrucciones se agregan a esa etapa automáticamente, así que nunca necesitas copiar y reescribir el mismo prompt."
1.1 Tus Habilidades (Panel Izquierdo)
| Elemento | Descripción |
|---|---|
| Título | "Tus habilidades" (heading 6) |
| Descripción | "Las habilidades que creaste para este worker." |
| Estado vacío | "Aún no hay habilidades. Haz clic en 'Agregar habilidad' para crear una." |
| Agregar habilidad | Button — Crea una nueva habilidad personalizada |
1.2 Configuración de la Habilidad (Panel Derecho)
| Elemento | Tipo | Descripción |
|---|---|---|
| Buscar habilidades | Textbox | Busca en la biblioteca de habilidades |
| Destacados | Button (filtro) | Habilidades destacadas |
| Todos | Button (filtro) | Todas las habilidades |
| Agendamiento | Button (filtro) | Habilidades de agendamiento/calendario |
| CRM | Button (filtro) | Habilidades de CRM |
| Planillas | Button (filtro) | Habilidades de planillas |
| Paginación | Navegación | Página X de Y |
1.3 Biblioteca de Habilidades Prediseñadas
| Habilidad | Descripción | Integración |
|---|---|---|
| Habilidad en blanco | Empezar desde cero | — |
| Agendar reuniones en Google Calendar | Verifica la disponibilidad y agenda reuniones | Google Calendar |
| Buscar información en HubSpot | Busca contactos, empresas y negocios | HubSpot |
| Crear o actualizar un cliente en HubSpot | Crea un nuevo contacto o actualiza uno existente | HubSpot |
| Buscar información en Google Sheets | Busca filas en una planilla por columna clave | Google Sheets |
1.3 Panel: Habilidad en Blanco (Nueva Skill)
Al hacer clic en "Habilidad en blanco":
| Elemento | Descripción |
|---|---|
| Configuración de la habilidad | Heading 6 |
| Cambiar habilidad | Button — volver a la biblioteca |
Campos:
| Campo | Obligatorio | Descripción |
|---|---|---|
| Nombre de la habilidad * | ✅ | Nombre único de la habilidad |
| Instrucciones | — | Textbox multilínea — prompt de la habilidad |
| Herramientas opcionales | — | Combobox multiselect + "Agregar nueva herramienta" |
Acciones: Cancelar / Guardar (deshabilitado hasta completar Nombre)
1.4 Panel: Skill Prediseñada (Google Calendar)
Al seleccionar una habilidad lista:
| Campo | Contenido (ej: Google Calendar) |
|---|---|
| Nombre de la habilidad * | "Agendar reuniones en Google Calendar" |
| Selector de Idioma | Combobox PT/EN/ES |
| Instrucciones | Flujo de 5 pasos: Disponibilidad → Recopilar datos → Agendar → Confirmar → Reagendar. Usa la variable {date}. |
| Herramientas necesarias | Google Calendar con "Conectar Google Calendar" |
Acciones: Cancelar / Guardar (deshabilitado, tooltip: "Conecta las herramientas necesarias para guardar esta habilidad.")
⚠️ Las habilidades prediseñadas requieren herramientas CONECTADAS. Las habilidades en blanco tienen herramientas opcionales.
2. Herramientas (Tools)
"Una herramienta es una conexión con un servicio externo que tu worker puede usar mientras conversa con un cliente. Puedes conectarla a más de 1.000 apps y servicios para que tu worker actúe por su cuenta, por ejemplo consultar disponibilidad y agendar un evento en un calendario, buscar o actualizar un contacto en un CRM, leer una fila de una planilla, o llamar a tu propia API. Conectas una herramienta aquí una sola vez y luego puedes usarla de dos formas: habilitarla en las etapas del pipeline donde el worker deba tenerla, o adjuntarla a una habilidad para que la herramienta acompañe a esa habilidad dondequiera que se use."
2.1 Tus Herramientas (Panel Izquierdo)
| Elemento | Descripción |
|---|---|
| Título | "Tus herramientas" (heading 6) |
| Descripción | "Las herramientas que conectaste para este worker." |
| Estado vacío | "Empieza agregando tu primera herramienta para desbloquear las capacidades de este empleado-IA." |
| Agregar Herramienta | Button — Conecta una nueva herramienta |
2.2 Configuración de Herramienta (Panel Derecho)
| Elemento | Tipo | Descripción |
|---|---|---|
| Título | Heading 6 | "Configuración de Herramienta" |
| Instrucción | Texto | "Los campos obligatorios están marcados con *." |
| Tipo de Herramienta * | Campo obligatorio | "Conecta tu Empleado-IA a más de 1.000 aplicaciones y herramientas." |
| Buscar apps y herramientas... | Textbox | Busca en la biblioteca de integraciones |
2.3 Herramientas Disponibles
| Herramienta | Categoría |
|---|---|
| Custom HTTP Request | API Personalizada |
| FireCrawl | Web Scraping |
| Google Calendar | Calendario |
| Google Drive | Almacenamiento |
| Google Sheets | Planillas |
| HubSpot | CRM |
| Pipedrive | CRM |
| Salesforce | CRM |
| Zoho CRM | CRM |
2.3 Configuración Completa: Custom HTTP Request
Al seleccionar "Custom HTTP Request":
Cabecera: "Seleccionado: Custom HTTP Request" + "Cambiar selección". Soporta GET/POST/PUT/DELETE/PATCH con headers y payloads. (Requiere contacto con el equipo de Darwin para generarlo — sin autoservicio.)
Campos Obligatorios:
| Campo | Tipo | Descripción |
|---|---|---|
| Nombre * | Textbox | Título corto y único (ej: "CRM Webhook") |
| URL * | Textbox | URL HTTPS del endpoint MCP (debe terminar con /sse) |
| Método * | Combobox | GET, POST, PUT, DELETE, PATCH |
| Endpoint * | Textbox | Ruta del endpoint |
Campos Opcionales:
| Campo | Descripción |
|---|---|
| Descripción | Resumen de una frase de la integración |
| Importar de cURL / JSON | Importa una configuración lista |
Incluir Respuesta: Body ✅ (predeterminado) / Status ✅ (predeterminado)
Headers: "Agregar Headers" — Authorization, Content-Type, Accept, Cache-Control
Body: Toggle Formulario (key-value) / JSON (raw). "Agregar Campos de Body"
Inputs: "Detectar inputs" + "Agregar Input". Contexto ej: "El correo electrónico proporcionado por el humano como string."
Guardar: Deshabilitado hasta completar Nombre, URL, Método, Endpoint
2.4 Herramientas OAuth (Google, HubSpot, etc.)
Flujo de autorización OAuth específico de cada servicio (conectar cuenta, autorizar permisos).
3. Comparativo: Skill en Blanco vs Prediseñada
| Característica | En Blanco | Prediseñada |
|---|---|---|
| Instrucciones | Vacías | Flujo detallado con {date} |
| Idioma | — | Selector PT/EN/ES |
| Herramientas | Opcionales | Necesarias |
| Guardar habilitado | Después del Nombre | Después de conectar herramientas |
4. Relaciones
| Módulo | Relación |
|---|---|
| Automatización de Etapas | Skills/tools vinculadas vía @Nombre |
| Pipelines | Instrucciones de la skill inyectadas en la etapa |
| Workflows (Albato) | Integraciones complementarias |
| Base de Conocimiento | Las tools pueden consultar datos |