Manuales de contratación
Una biblioteca solo para el equipo con el material de contratación que reutilizas, documentos y enlaces marcados para que Kit los muestre al configurar etapas y los agentes de IA puedan leerlos.
Los manuales están en Contratación → Manuales, en /hiring/playbooks. Un manual es un grupo con nombre de recursos: documentos en Markdown escritos dentro de Kit y enlaces a material que vive en otro sitio.
Nada de un manual se muestra nunca a los candidatos. Es de uso interno del equipo: el portal de empleo, el portal del candidato y los correos de candidatura no leen de ahí.
El manual de un equipo de ingeniería podría contener:
| Recurso | Tipo |
|---|---|
| Vídeo de presentación de la empresa | Enlace (YouTube, se reproduce integrado) |
| Cómo hacemos la llamada inicial | Documento |
| Lista de comprobación de revisión de código (backend) | Documento |
| Banco de preguntas de encaje cultural | Documento |
| Logística de la jornada presencial (Google Doc) | Enlace |
Quién puede hacer qué
| Leer | Crear, editar, eliminar, reordenar | |
|---|---|---|
| Miembro de Contratación | Sí | No |
| Admin de Contratación | Sí | Sí |
Los niveles son por módulo: un admin de Contratación que solo sea miembro en Outreach conserva aquí el acceso de escritura completo. Consulta Roles del equipo.
Documentos y enlaces
Un documento es Markdown que escribes en Kit. El editor tiene un selector Escribir / Vista previa; se renderizan encabezados, tablas, listas de tareas, tachado y URLs sueltas. El HTML sin procesar se descarta, no se escapa. El contenido tiene un tope de 100 000 caracteres.
Un enlace es una URL a algo que ya guardas en otro sitio. Pulsa Obtener vista previa y los enlaces de YouTube, Vimeo y Loom obtienen un reproductor integrado; el resto se guarda como enlace simple, que es lo habitual con documentos y wikis. No hay subida de archivos: deja el archivo donde ya está y enlázalo.
Warning
El tipo de un recurso queda fijado al guardarlo. Un documento no puede convertirse después en un enlace, ni al revés: cambiarlo dejaría huérfanos el contenido y todas sus versiones. Para cambiar de tipo, crea un recurso nuevo y elimina el antiguo.
Los administradores pueden arrastrar los recursos para ordenarlos en la página del manual. Reordenar se desactiva mientras el filtro esté en uso, porque una lista filtrada es un subconjunto.
Sugerencias al configurar etapas
Al añadir o editar un recurso, marca tipos de etapa en Sugerir al configurar etapas: Enviar solicitud, Ejercicio de código, Entrevista, Oferta, Revisión de portafolio, Cuestionario, Verificación de referencias, Llamada de preselección, Prueba práctica, Revisión del equipo, Presentación en vídeo, Respuesta en vídeo. Revisión de portafolio significa trabajo anterior; Prueba práctica, una nueva tarea con un enunciado privado.
Quien abra una etapa de ese tipo verá entonces un panel De tu manual con los recursos marcados. Cada uno se abre en una pestaña nueva, así que no se pierde nada sin guardar de la etapa.
El panel tiene un botón para ocultarlo, y ocultarlo tiene un alcance limitado:
- Por persona. Ocultarlo nunca lo oculta para nadie más.
- Por tipo de etapa. Ocultarlo en las etapas de Entrevista lo deja visible en las de Ejercicio de código.
- Vuelve con cualquier añadido posterior. Un recurso marcado después de que alguien ocultara el panel se lo devuelve. Silenciarlo una vez no entierra lo que el equipo escriba el mes que viene.
Historial de versiones
Cada guardado que cambia el título, el contenido o el enlace de un recurso deja una instantánea. Quien pueda editarlo verá debajo un control compacto llamado Historial. Al principio está cerrado para que el documento siga siendo lo principal. Al abrirlo aparecen las seis versiones más recientes; las anteriores quedan tras un segundo desplegable. Cada entrada indica quién la guardó y qué campos cambiaron.
Ver abre una versión pasada. Restaurar vuelve a aplicarla, y restaurar es una acción hacia delante: escribe una versión nueva con el contenido antiguo en lugar de rebobinar el rastro. No se borra nada, y siempre puedes volver restaurando otra vez.
Al eliminar un recurso se elimina su historial con él.
Encontrar un recurso
| Dónde | Con qué coincide |
|---|---|
| Filtro en la página de un manual (aparece a partir de 8 recursos) | Fragmento del título, del contenido o de la URL |
| Cmd+K | Nombres de manuales y títulos de recursos |
hiring_search_playbooks (agentes) |
Texto completo, ordenado por relevancia, en títulos, contenidos y nombres de manuales |
La búsqueda es por palabras clave, no semántica: «puntuación de la puesta en común» encuentra esas palabras, no una paráfrasis.
Para agentes de IA
Seis herramientas cubren el ciclo de búsqueda, creación y comprobación. Las cuatro herramientas de lectura necesitan acceso al módulo Contratación y que la conexión tenga el ámbito hiring_read o hiring_write. Las dos herramientas de escritura requieren en concreto hiring_write, una suscripción activa y permisos de administración del módulo Contratación. Para conectar un cliente, consulta Agente de IA y herramientas MCP.
| Herramienta | Qué devuelve |
|---|---|
hiring_list_playbooks |
Todos los manuales con sus recursos por título, tipo, id, slug y tipos de etapa. Sin el contenido de los documentos: esto es el mapa. |
hiring_get_playbook |
Un manual por id pbk_ o slug, con los contenidos truncados a 2000 caracteres y marcados cuando se truncan. |
hiring_read_resource |
Un recurso por id rsc_ o slug, completo: todo el contenido, o la URL de un enlace. |
hiring_search_playbooks |
Coincidencias ordenadas por relevancia con un fragmento resaltado y el id rsc_ con el que continuar. Los fragmentos son extractos. |
hiring_create_playbook |
Un manual nuevo y vacío, solo para el equipo. Devuelve su id pbk_ y su URL web. |
hiring_add_resource |
Añade un documento o un enlace al final de un manual. Puedes indicar los tipos de etapa en los que Kit debe sugerir el recurso. Devuelve su id rsc_ para comprobarlo. |
Consulta la lista o busca primero para evitar duplicados. Crea el manual si hace falta, añade los recursos de uno en uno y comprueba el resultado con hiring_get_playbook o hiring_read_resource. hiring_get_playbook ofrece una vista general de todo el manual, pero, como trunca el contenido, no debe ser la última llamada antes de que un agente responda a una pregunta detallada.
Checklist rápido
- Un manual por tipo de contratación, no uno por equipo
- Marca todo lo procedimental con los tipos de etapa a los que se aplica
- Enlaza al material que ya se mantiene en otro sitio; escribe documentos en Kit solo para aquello de lo que Kit es la sede
- Acierta con el tipo a la primera: después no se puede cambiar
- Pregúntale a tu asistente de IA algo cuya respuesta ya conoces, para comprobar que lee el recurso correcto