Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Base de conocimiento

Oficial3Dv0.3.22aigd.knowledge
Instalar ¿Aún no tienes la app? Descárgala gratis
O desde el terminal
gamedev pkg add aigd.knowledge

Resumen

La base de conocimiento del proyecto: notas Markdown en .ai-game-dev/knowledge/, versionadas con el proyecto, indexadas como grafo y buscables por el agente. El agente registra decisiones de diseño y convenciones, organiza las notas en espacios, reescribe los enlaces al mover y encuentra enlaces rotos; la app de escritorio muestra las notas como un grafo 3D.

La base de conocimiento del proyecto para el agente de AI Game Dev: notas Markdown en .ai-game-dev/knowledge/, versionadas con el proyecto y compartidas con el equipo mediante git. El paquete indexa las notas y sus enlaces como un grafo, da al agente herramientas para explorarlas, buscarlas, enlazarlas y organizarlas, y muestra el grafo en una ventana 3D. Encaja con equipos de juego que quieren que las decisiones de diseño, las convenciones y el funcionamiento de sus sistemas queden escritos donde tanto las personas como el agente puedan encontrarlos.

Qué puedes hacer

  • Hacer que el agente registre las decisiones de diseño y sus motivos, las convenciones y los detalles poco obvios que pueden dar problemas mientras trabajas, en el espacio temático correcto.
  • Preguntar al agente qué decidió el equipo sobre un sistema; puede buscar en las notas para responder.
  • Organizar las notas en espacios (carpetas con un README.md), y mover o renombrar notas y carpetas sin romper los enlaces.
  • Encontrar enlaces rotos y notas huérfanas, y ver cómo se conecta todo en el grafo.
  • Explorar tú mismo las notas en la ventana de grafo 3D o en la vista previa del panel lateral de la app de escritorio.

Ejemplos de solicitudes

  • "Apunta que elegimos un paso de física fijo de 60 Hz para el sistema de combate, y por qué."
  • "¿Qué dice la base de conocimiento sobre nuestro formato de guardado?"
  • "Crea un espacio para el sistema de inventario y mueve ahí las notas de objetos."
  • "Revisa la base de conocimiento en busca de enlaces rotos y corrígelos."
  • /kb systems (los totales de la base de conocimiento y los enlaces rotos, con el árbol del espacio systems)

Cómo funciona

Las notas son archivos Markdown sin más bajo <project>/.ai-game-dev/knowledge/, así que viven en el control de versiones junto a tu juego. Un espacio es una carpeta con un README.md: un # Title y después una descripción de un párrafo. Las notas se enlazan entre sí con rutas desde la raíz de la base de conocimiento, por ejemplo [Combat](/systems/combat.md); también se indexan los enlaces relativos y los wikilinks ([[Combat]]).

El agente ve la lista de espacios de nivel superior en sus instrucciones y va bajando de un espacio a otro. Lee y escribe notas con sus herramientas de archivos habituales y usa estas herramientas para lo demás:

HerramientaQué hace
kb_space_getAbrir un espacio: su descripción, los espacios hijos y las notas.
kb_space_createCrear un espacio: una carpeta con un README.md (título y descripción).
kb_searchBúsqueda clasificada de notas por título, ruta y texto, con fragmentos.
kb_linksEnlaces salientes, enlaces entrantes y enlaces rotos de una nota, o de todas las notas de una carpeta.
kb_moveMover o renombrar una nota o carpeta y reescribir todos los enlaces que apuntan a ella.
kb_lintEnlaces rotos, notas huérfanas, problemas de convenciones y sugerencias.

Al agente se le indica que registre solo conocimiento importante y duradero (decisiones y sus motivos, convenciones, cómo funciona un sistema, detalles poco obvios), que busque primero y actualice una nota existente en lugar de duplicarla, y que base cada dato en lo que dijiste o en lo que muestra el código.

El paquete aporta:

  • la capacidad Base de conocimiento, activada de forma predeterminada;
  • el comando /kb [folder or note] (CLI y escritorio): notas, carpetas, enlaces, enlaces rotos y huérfanos, y después el árbol;
  • en la app de escritorio, la ventana de grafo 3D (desde la barra de estado, el menú de herramientas de la sesión o "Abrir en el grafo de la base de conocimiento" en una nota o carpeta del explorador de archivos), una vista de la base de conocimiento en el panel derecho y un consejo que apunta a ella. El grafo se actualiza en vivo mientras el agente escribe notas.

Requisitos

  • AI Game Dev 0.25.11 o posterior. La ventana de grafo y el panel lateral forman parte de la app de escritorio.
  • Una carpeta de proyecto; git para compartir las notas con tu equipo.

Licencia

Apache-2.0.

Versiones

Versiones de Base de conocimiento
VersiónPublicadaRequiere la aplicación
0.3.22Última0.25.11 o posterior
0.3.210.25.11 o posterior
0.3.200.25.11 o posterior
0.3.190.25.11 o posterior
0.3.180.25.11 o posterior
0.3.170.25.11 o posterior
0.3.160.25.11 o posterior
0.3.150.25.11 o posterior
0.3.70.22.0 o posterior
0.3.60.22.0 o posterior
0.3.50.22.0 o posterior
0.3.40.22.0 o posterior
0.3.30.22.0 o posterior
0.3.20.22.0 o posterior
0.2.10.20.0 o posterior

Instalar

En la app de escritorio

Abre la ventana Paquetes (el icono de paquete en la barra de estado), selecciona Explorar, busca aigd.knowledge y haz clic en Añadir al proyecto.

¿Aún no tienes la app? Descarga AI Game Dev gratis para Windows, macOS o Linux.

Desde el terminal

Con la CLI gamedev, en la carpeta de tu proyecto:

gamedev pkg add aigd.knowledge

Requisitos

  • AI Game Dev 0.25.11 o posterior

Más sobre los paquetes

Instalar
gamedev pkg add aigd.knowledge