Ayuda
Resumen
Qué es Hive y la decisión de arquitectura que más importa.
Aiqbee Hive es un grafo de conocimiento autoalojado diseñado para que lo lean y escriban agentes de IA. Se ejecuta como un único contenedor con PostgreSQL detrás y se expone de dos maneras:
- MCP (Model Context Protocol) — 34 herramientas que un LLM puede invocar directamente. Es la interfaz principal y la que conviene usar al crear un agente o asistente.
- REST (
/api/v1) — una pequeña API de gestión para aprovisionamiento y automatización: crear Brains, listarlos, modificar ajustes. No está pensada para el tráfico de agentes.
El vocabulario
| Término | Qué es |
|---|---|
| Brain | Un grafo de conocimiento. El acceso se concede por Brain, y una conexión MCP se limita exactamente a uno. |
| Neurona | Una unidad de conocimiento: un título más contenido, opcionalmente con fecha. Se incorpora a los embeddings al escribir, por lo que admite búsqueda semántica. |
| Tipo de neurona | Una categoría (Decisión, Nota de reunión, Estándar). Los tipos pueden tener sus propias reglas de acceso en Seguridad avanzada. |
| Sinapsis | Un enlace descrito entre dos neuronas. La descripción importa: es lo que permite a un agente explicar por qué dos cosas se relacionan. |
| Cuenta de servicio | Una identidad no humana con sus propias credenciales de cliente. Aquello con lo que debería autenticarse su integración. |
Cómo toma forma un Brain
Los tipos de neurona son el esquema, y se definen por Brain. Antes de escribir, un agente debe llamar a aiqbee_get_neuron_types y usar un id de tipo real: no se pueden adivinar, y un id incorrecto se rechaza. Los tipos pueden crearse sobre la marcha con aiqbee_add_neuron_type, pero un Brain con cuarenta tipos casi duplicados es peor que uno con ocho buenos, por lo que conviene reutilizar los existentes.
Siguientes pasos
- Patrón de integración: léalo antes de escribir código.
- Conexión mediante MCP: configuración de la cuenta de servicio y una llamada funcional.
- Referencia de herramientas: las 34 herramientas.
- Exportación & importación OKF: traslade un Brain como un paquete markdown portátil.