Para agentes

Agentes

Un agente debería poder entregarle a alguien una base de datos funcionando sin que ninguna persona abra un panel. Esto es todo lo que publicamos para que pueda hacerlo.

01

La premisa

Una parte creciente de los proyectos los empieza un agente y solo los revisa una persona. Ese agente necesita tres cosas de un proveedor de bases de datos: una forma de averiguar qué es el producto, una forma de actuar sobre la cuenta y una forma de devolverle a la persona algo que funcione.

Publicamos las tres. Nada de esto es una superficie de demostración: el servidor MCP y la CLI llaman a la misma API que el panel, con los mismos permisos y el mismo registro de auditoría.

02

Descubrimiento

  • -/llms.txt - el índice que un asistente lee primero y que apunta a todo lo demás
  • -/agents.md - instrucciones ejecutables para aprovisionar una base de datos en nombre de una persona
  • -/pricing.md, /about.md, /changelog.md - espejos en markdown de las páginas de marketing, generados desde las mismas fuentes que el HTML
  • -/webmcp.md - la superficie de herramientas de navegador que publica el panel
  • -El sitio de documentación publica su propio índice y un corpus completo para recuperación
  • -Un feed RSS del changelog, para que un agente atento a cambios incompatibles no tenga que sondear una página

03

Actuar sobre una cuenta

Dos superficies, la misma API. El servidor MCP encaja cuando el agente vive en un editor o un cliente de chat; la CLI encaja cuando el agente tiene una consola.

Ambas se autentican con una clave de API acotada a la organización, o mediante un inicio de sesión por dispositivo que la persona aprueba en el navegador. Un agente nunca necesita, y nunca debería recibir, una contraseña.

# In a shell
capydb login
capydb create --name my-app
capydb env pull

# In an editor, over MCP
npx -y @capydb/mcp

04

Agentes en el navegador

El panel publica una superficie de herramientas para los agentes de navegador que la admiten, de modo que un agente que maneja la página actúe mediante herramientas con nombre en lugar de adivinar el DOM. Las herramientas destructivas piden confirmación por la misma interfaz que vería una persona.

La superficie publicada está documentada en /webmcp.md y es deliberadamente un subconjunto: las restauraciones que sobrescriben producción no se exponen en absoluto a un agente.

05

Salvaguardas

  • -El SQL destructivo a través del servidor MCP exige crear antes un punto de restauración
  • -La restauración que sobrescribe producción no se expone como herramienta de agente en ninguna superficie
  • -Las claves de API están acotadas a una organización y pueden revocarse desde el panel en cuanto una ejecución se tuerce
  • -Las bases de preview tienen tiempo de vida, para que un experimento no se convierta en silencio en una factura
  • -Toda acción de un agente aparece en el registro de auditoría del espacio de trabajo, bajo la clave que la ejecutó

06

Por qué aquí resulta fácil

Porque no hay una API de datos propietaria que aprender. El agente aprovisiona una celda, obtiene una URL PostgreSQL estándar y luego usa el controlador que el proyecto ya tiene. Todo lo que un agente ya sabe de Postgres se transfiere sin cambios, y esa es la diferencia entre una tarea que funciona al primer intento y otra que necesita tres rondas de consulta a la documentación.