Crea un agente «Pregúntale a la empresa»: respuestas en lenguaje claro sobre tu wiki, tu código y tus datos, con cada fuente citada

El caso, en movimiento

01 / 04La carpetaLas piezas que anclan al agente

Tu equipo pregunta siempre lo mismo (quién lleva qué) y las respuestas están repartidas. Tres archivos hacen de tabla de rutas.

Plataforma / pregunta-a-la-empresa

• YAMLcatalogo-de-servicios.yaml
• MDglosario.md
• MDdirectorio-de-equipos.md

3 archivos

02 / 04ClaudeRevisa cada sitio por turno

Tus archivos de referencia, la wiki, el código y el almacén de datos, uno detrás de otro.

Claude lee tus archivos de referencia

• ✓La wiki
• ✓El código
• ✓El almacén de datos

03 / 04La respuestaEl responsable, con cada fuente enlazada

Las cinco fuentes coinciden. Claude da el equipo responsable y señala una página de la wiki que va dos columnas por detrás del almacén.

de quién es la tabla de pedidos (datos inventados)

Catálogo de servicios	verde	equipo de Comercio
Archivo de responsables del código	verde	equipo de Comercio
Wiki, modelo de datos	amarillo	dos columnas por detrás
Almacén de datos	verde	tabla de pedidos
Directorio de equipos	verde	Priya Ramos, a quien preguntar

04 / 04ProgramadasY cada viernes, lo que no supo contestar

Las preguntas sin respuesta, agrupadas por tema y con un responsable sugerido.

◷ Tarea programada ActivaInforme de huecos

Viernes a las 16:00

Tu equipo sigue preguntando de quién es cada cosa y las respuestas están dispersas. Haces a la skill una pregunta real, con cada fuente citada y un responsable identificado. Claude revisa cada sitio por turno: tus archivos de referencia, la wiki, el código y el almacén de datos. Obtienes la respuesta y el responsable, con cada fuente enlazada, y cuando la respuesta es correcta le pides a Claude que la guarde como una skill que todo el equipo pueda ejecutar.

Configuración

Prueba un plugin

El plugin de Engineering trae /documentation como punto de partida, ya preparado para ampliarse por las fuentes conectadas, citar lo que encuentra y nombrar a un responsable cuando no está seguro. Si quien administra tu cuenta gestiona los plugins y todavía no está disponible, sáltatelo: nada de lo que sigue lo necesita.

Conecta tus herramientas

Claude rinde más cuando trabaja directamente con vuestros sistemas, y los permisos los pones tú (cómo se controla el acceso a las herramientas). Se configuran en Personalizar → Conectores.

¿Quieres probar la tarea antes de configurar nada? Añade tus archivos a una carpeta de trabajo, apunta a Claude a la carpeta y empieza con el prompt.

Configura tu carpeta de trabajo

Arrastra a una carpeta los archivos que anclan al agente: la exportación del catálogo de servicios, el directorio de equipos, el glosario y el documento de incorporación de «dónde encontrar las cosas». Pasan a ser la tabla de rutas que el agente consulta antes de buscar en ningún otro sitio. Crea un proyecto a partir de esa carpeta para que el catálogo y las reglas básicas sigan unidos al agente mientras evoluciona.

El prompt

Copia esto en Claude, con la carpeta Plataforma / pregunta-a-la-empresa añadida:

Crea un agente interno de «pregúntale a la empresa» para el equipo técnico. Cuando alguien pregunte «cómo consigo una clave de API de pruebas», «de quién es la tabla de pedidos» o «por qué se ralentizaron los despliegues el mes pasado», encuentra la respuesta en nuestros sistemas, cita la fuente de cada parte y dime a quién preguntar si no estás seguro. Primero consigue una buena respuesta y luego conviértela en una skill compartida.

Por qué funciona

• Prompt1

  Da un ejemplo de cada tipo de pregunta. Un «cómo se hace», una búsqueda de responsable y un «por qué cambió esta métrica» cubren los tipos de pregunta que el equipo hace de verdad.

• Prompt2

  Cita la fuente, siempre. El equipo se fía del enlace, no de la prosa: las citas hacen verificable la respuesta.

• Prompt3

  Nombra un responsable cuando no estés seguro. Pedir «el equipo o el canal responsable» le da a Claude algo a lo que agarrarse cuando no está seguro. Recibes una referencia a la que preguntar en lugar de una suposición que comprobar.

• Fuente

  Pon los documentos de referencia en la carpeta de trabajo. El catálogo de servicios y el directorio de equipos le dicen a Claude dónde buscar y a quién señalar.

Para que el borrador salga mejor

• Practicar

  Dale un ejemplo que te guste. Ponlo en la carpeta y Claude seguirá su estructura y su voz.

• Practicar

  Pídele que señale la incertidumbre. Añade «señala todo lo que no tengas claro» y sabrás dónde mirar primero al revisar el borrador.

Haz que Claude trabaje para ti

La skill /documentation del plugin es un punto de partida genérico. Cuando el paso 2 conteste bien a tus tres preguntas, dile a Claude que escriba tu versión de la skill: qué espacios de la wiki y qué repositorios mirar primero, el umbral de «no estoy seguro», el tono y los sistemas que quedan fuera. Con unos minutos de conversación, la skill hablará vuestro idioma técnico para siempre.

Convierte lo que hemos hecho en esta tarea hasta ahora en una skill, o edita la skill /documentation con mis correcciones.

Hazlo repetible

Compártelo como artefacto

Cuando el agente responda bien a tus preguntas de prueba, publícalo como un artefacto, para que cualquier persona de la organización tenga un enlace desde el que preguntar. El artefacto ejecuta por detrás la skill compartida; el equipo de plataforma es dueño de la skill y la sigue afinando.

Registra cada pregunta que no supo contestar

El agente mejora cuando sabes dónde se queda corto. Escribe /schedule o abre Programadas en la barra lateral y una ejecución semanal dejará en tu carpeta las preguntas sin contestar, para que el equipo de plataforma rellene los huecos.

/schedule Cada viernes a las 16:00, enumera las preguntas que /documentation no pudo contestar con seguridad esta semana, agrúpalas por tema y escríbelas en Plataforma/pregunta-a-la-empresa/huecos-<semana>.md con un responsable sugerido para cada una.

Compártelo con tus compañeros

Tu /documentation personalizada lleva ya tus fuentes, tu tabla de rutas y tus reglas de confianza. Compártela con todo el espacio de trabajo para que cada persona del equipo pregunte a la empresa de la misma manera y la respuesta a «¿cómo hago…?» deje de depender de quién esté en el canal.

Qué cambia para la organización

Las preguntas internas reciben una respuesta con fuentes de tu wiki, tu código y tu almacén de datos, con un responsable nombrado cuando el agente no está seguro. El equipo revisa una sola respuesta en lugar de buscar en cada sistema.

Esto se hace para las preguntas cotidianas del equipo técnico. El mismo enfoque sirve para buscar guías de guardia, consultar el catálogo de datos y recibir a las personas nuevas: cada una se convierte en una skill dentro del plugin compartido del equipo.

De cara al futuro

En una empresa tecnológica de aquí, así se usa

En una pyme tecnológica o en una agencia con equipo técnico, las respuestas no están en una wiki ordenada, sino repartidas entre un Notion que nadie actualiza, un Drive con carpetas por cliente y dos o tres personas que «lo saben». Cuando una de ellas se va de vacaciones o deja la empresa, el equipo se da cuenta de lo que sabía solo ella.

El agente no necesita Confluence ni un almacén de datos para empezar. Una carpeta con el listado de clientes y quién los lleva, el directorio de personas y equipos, el glosario del producto y el documento de «cómo se hace X» es una tabla de rutas suficiente. Si vuestra wiki está en Notion o en Google Drive, conéctala (Notion, Google Drive); si está en otro sitio, exporta las páginas importantes a la carpeta.

Crea un agente interno de «pregúntale a la empresa» para toda la agencia, no solo para el equipo técnico. Cuando alguien pregunte «quién lleva el cliente [nombre]», «dónde está el contrato y la última propuesta de [cliente]» o «cómo damos de alta a un proveedor», busca la respuesta en la carpeta y en nuestro [Notion o Drive], cita el documento de donde sale cada dato y, si dos documentos se contradicen, enséñame los dos. Si no estás seguro, dime a quién preguntar, no te inventes la respuesta. Primero consigue una buena respuesta y luego conviértela en una skill compartida.

Una regla que el agente debe cumplir desde el primer día: que contestar con una fuente desactualizada es peor que no contestar. Pídele que indique la fecha del documento y que avise cuando tenga más de un año.

Decides tú qué documentos entran en la carpeta y quién se señala como responsable. Claude cita y ordena; la información es vuestra.