Skip to main content
Knowledge está obsoleto y se eliminará en una futura actualización. El Knowledge existente se está migrando automáticamente a Skills en Plugins: la migración se está implementando de forma gradual y no requiere ninguna acción de tu parte. Usa Skills para las nuevas instrucciones y el contexto que quieras compartir con Devin. Consulta las preguntas frecuentes sobre la migración para obtener más información.

¿Qué es Knowledge?

Al igual que incorporar a un nuevo ingeniero, incorporar a Devin requiere una inversión inicial en transferencia de conocimiento. Knowledge es una colección de consejos, recomendaciones e instrucciones que Devin puede consultar en todas las sesiones. Puedes ampliar continuamente el banco de Knowledge de Devin con el tiempo, y Devin recordará automáticamente el Knowledge relevante cuando sea necesario. Usa la función Knowledge para compartir documentación, consejos, bibliotecas internas personalizadas y otros materiales que Devin pueda necesitar.

¿Cómo creo Knowledge?

Navega a Settings → Recursos → Knowledge y haz clic en Create knowledge en la esquina superior derecha. Tu Trigger Description ayudará a Devin a recordar la Knowledge relevante en los momentos adecuados. Puede ser una frase o una oración sencilla. Devin recuperará un elemento de Knowledge cuando su trabajo actual esté relacionado con los triggers especificados, y todos los elementos de Knowledge requieren una Trigger Description. El contenido debe consistir en unas cuantas oraciones con información relevante.

Macros

Puedes asignar una macro a cualquier elemento de Knowledge: un identificador corto que empieza por ! (por ejemplo, !deploy-checklist). Las macros te permiten hacer referencia rápidamente a Knowledge en tus prompts escribiendo el nombre de la macro. Las macros solo pueden contener letras, números y guiones, y deben ser únicas dentro de tu organización.

Habilitar y deshabilitar Knowledge

Cada elemento de Knowledge puede habilitarse o deshabilitarse individualmente para cada usuario. Deshabilitar un elemento de Knowledge evita que Devin lo recupere en tus sesiones, sin eliminarlo de la organización. Esto es útil cuando un elemento de Knowledge es temporalmente irrelevante para tu trabajo, pero puede ser útil para compañeros de equipo o en el futuro.

Sugerencias de Knowledge

Devin sugerirá automáticamente Knowledge para recordar según tus comentarios en el chat. Edita el Knowledge sugerido antes de guardarlo o descarta el Knowledge si no es útil. También puedes pedirle a Devin que regenere una sugerencia de Knowledge basada en tus comentarios. Esto puede facilitar iterar sobre el Knowledge sugerido en lugar de editarlo manualmente. Devin también puede sugerir actualizaciones a elementos de Knowledge existentes, además de sugerir nuevos elementos de Knowledge.

¿Qué debe incluir Knowledge?

Recomendamos incluir los aspectos de tus prompts o playbooks que sueles repetir con frecuencia. Algunos ejemplos son errores comunes y sus soluciones asociadas, prácticas de conformidad con el código, flujos de trabajo de despliegue, flujos de trabajo de pruebas, cómo interactuar con herramientas propietarias, etc.

Organizar Knowledge con carpetas

Puedes organizar los elementos de Knowledge en carpetas para gestionarlos más fácilmente. Las carpetas admiten:
  • Jerarquía anidada — Crea subcarpetas para construir un árbol de Knowledge estructurado.
  • Habilitar/deshabilitar en bloque — Habilita o deshabilita una carpeta completa. Cuando una carpeta está deshabilitada, todos los elementos de Knowledge que contiene se deshabilitan para tus sesiones.
  • Mover elementos — Arrastra elementos de Knowledge entre carpetas o usa la acción de mover para reorganizarlos.
  • Organización automática — Selecciona varios elementos de Knowledge y deja que Devin los clasifique automáticamente en carpetas lógicas.
Las carpetas son especialmente útiles cuando tu organización tiene una gran cantidad de elementos de Knowledge que abarcan distintos equipos, proyectos o flujos de trabajo.

Consejos y trucos

  1. Crea Knowledge específico orientado a un único flujo de trabajo o acción. Devin leerá todo el contenido de Knowledge, así que mantenlo relevante y actualizado.
    • Divide tu Knowledge en partes más pequeñas siempre que sea posible. Devin puede acceder a varios “elementos” de Knowledge a la vez.
  2. Adquiere el hábito de añadir y actualizar Knowledge. Este se comparte en toda tu organización y mejorará continuamente a Devin para tu equipo con el tiempo.
  3. Devin recupera Knowledge cuando es relevante, no todo a la vez ni todo al principio. Asegúrate de que el desencadenante de recuperación sea muy relevante para el contenido.
  4. Usa carpetas para agrupar Knowledge relacionado (p. ej., por proyecto, equipo o flujo de trabajo) para que puedas habilitar o deshabilitar rápidamente conjuntos de Knowledge a medida que cambia tu enfoque.

Knowledge de organización y Enterprise Knowledge

El Knowledge puede tener como ámbito una sola organización o toda tu empresa. Lo que muestra la página Knowledge depende de la organización en la que te encuentres:
  • Organizaciones no primarias — La página Knowledge tiene dos pestañas:
    • Organization (predeterminada) — elementos de Knowledge con ámbito en tu organización actual. Son visibles para todos los miembros de la organización y constituyen el ámbito predeterminado de los nuevos elementos de Knowledge.
    • Suggestions — Sugerencias de knowledge generadas por IA a partir de tus interacciones en las sesiones.
  • Organización primaria — La página Knowledge muestra una única vista de Enterprise Knowledge, sin pestañas. El Enterprise Knowledge se aplica a todas las organizaciones de tu empresa, y son los Admin de Enterprise quienes lo crean y lo gestionan aquí.
Las organizaciones no primarias no tienen una pestaña Enterprise. Si tu organización pertenece a una empresa, usa el enlace Looking for enterprise knowledge? de la página Knowledge para abrir el Enterprise Knowledge en la organización primaria de tu empresa.
Los elementos de Knowledge de Enterprise resultan especialmente útiles para compartir estándares de código de toda la compañía, lineamientos de arquitectura, procedimientos de despliegue y cualquier otro contexto que deba aplicarse de forma uniforme en todos los equipos y organizaciones.

Promover Knowledge de organización a la empresa

Si un elemento de Knowledge de organización resulta lo bastante útil como para compartirlo en toda tu empresa, puedes promoverlo directamente desde el editor de Knowledge. Abre el elemento y luego haz clic en Promover a la empresa en la pestaña Detalles. El elemento pasa del ámbito de la organización al ámbito de empresa y queda disponible para todas las organizaciones de tu empresa. La promoción requiere permisos para gestionar Enterprise Knowledge y solo está disponible para elementos de Knowledge creados por usuarios en organizaciones que pertenecen a una empresa.

Fijar Knowledge a repos

Puedes elegir si Knowledge se aplica a ningún repo, a un repo específico o a todos los repos:
  • Fijar a ningún repo: Knowledge solo se consulta cuando Devin determina que es relevante para tu contexto actual.
  • Fijar a un repo específico: Knowledge se usa siempre que Devin trabaja en ese repo específico.
  • Fijar a todos los repos: Knowledge se aplica automáticamente a todos los repos en los que Devin trabaje en cualquier sesión.

Preguntas frecuentes sobre la migración de Knowledge a Skills

Las notas de Knowledge se van a retirar y se sustituirán por Skills, la forma estándar de darle a Devin instrucciones reutilizables. Devin se encarga de migrar tus notas a skills por ti. El día del cambio no cambia nada para tu equipo y no tienes que hacer nada.

Cómo se corresponde una nota con una skill

Por ejemplo, esta nota: se convierte en esta skill:
SKILL.md

Preguntas frecuentes

No. Las skills migradas se cargan a partir de su descripción, del mismo modo que las notas se cargaban a partir de su trigger.
En la Devin app, en Customize → Plugins → Knowledge, agrupadas según tus carpetas originales.
En Devin, igual que tus notas. A diferencia de las skills que confirmas en un repositorio como archivos SKILL.md, las skills migradas se guardan en plugins gestionados por Devin, no en tus repositorios. No se confirma nada en tus repositorios y no tienes que agregar ni mantener ningún archivo.
Ve a Customize → Skills y abre la skill para editarla. Las skills de la organización pueden editarlas los Admin de la organización y los miembros con el permiso Manage Knowledge; las skills de Enterprise, los Admin de Enterprise.
Escribe Skills. Funcionan en cualquier entorno donde se ejecute Devin: la web app, la CLI y Devin Desktop.

Para usuarios de la API

Los endpoints de notas de Knowledge /v3/organizations/{org_id}/knowledge/notes[/{note_id}] y /v3/enterprise/knowledge/notes[/{note_id}], además de los endpoints /knowledge/folders correspondientes.
En el caso de las notas, los endpoints de skills (v3 beta), en /v3beta1/organizations/{org_id}/managed-plugins y /v3beta1/enterprise/managed-plugins:Los endpoints de listado se paginan con first y after, igual que los demás endpoints de v3.
Las notas migradas se encuentran en el paquete knowledge, identificadas por su slug. Lístalas todas con GET .../managed-plugins/bundles/knowledge/skills u obtén una concreta con GET .../managed-plugins/bundles/knowledge/skills/deploying-to-staging.