Aprende¶
Las secciones de abajo son la forma recomendada de aprender AgenticOS, en orden. Léelas como un curso: cada una da por leídas las anteriores, y ninguna da por supuesto que hayas leído el código.
Primeros pasos¶
Necesitas un stack en marcha y un agent que te responda. Unos veinte minutos.
-
Docker Compose, o los servicios a mano. Cinco minutos hasta un stack que puedes abrir en un navegador.
-
Una clave de provider, un agent, una versión publicada, un run que costó algo.
-
Spec, versión, exposición, disparador, run. Cinco sustantivos. Todo lo demás se construye con ellos, así que esta es la página a la que volver cuando algo te sorprenda.
Tip
Lee Conceptos aunque tengas prisa. Casi toda la confusión sobre esta plataforma es uno de esos cinco sustantivos tomado por otro — un spec por una versión, una exposición por un disparador.
¿Perdido en la consola?
La consola es el mapa de todas las áreas — para qué sirve cada una y qué página la explica.
Construye el agent¶
Ahora hazlo bueno. Cada página de aquí es una cosa que le das al agent, y son independientes — coge las que tu agent necesite.
-
Qué modelo debería usar este agent — de pesos abiertos o cerrados, qué dispara la factura, y cómo cambiar de opinión más adelante.
-
27 providers, perfiles de modelo, alternativas de reserva, y lo que cuesta de verdad un token.
-
Saber hacer escrito que el agent carga solo cuando decide que es relevante.
-
Conocimiento permanente escrito una vez y ligado a muchos agents — un glosario, una guía de tono, una matriz de escalado.
-
Subir, parsear, trocear, embeber. Colecciones, y sincronizar en una de ellas una carpeta de Drive o un bucket.
-
Cualquier servidor MCP por URL, y 59 en el selector con OAuth ya montado.
-
Archivos y una shell, aislados, con un tiempo de vida.
-
Un run que ocurre según un horario o ante un evento, sin que nadie escriba nada.
Ponlo delante de las personas¶
Un agent al que nadie puede llegar es un draft. Así es como sale de la consola.
-
stagingyproductioncomo nombres fijados a versiones, para que publicar y lanzar sean dos decisiones. -
Chat web, una página alojada, un widget embebible, la API HTTP, Slack, Telegram y Mattermost — un único runner detrás de todos ellos.
-
Su identidad, su política de registro, sus avisos. Las cosas que son de la instalación y no de un agent.
-
Llevar la plataforma a un servidor.
-
Quién hace qué, unos primeros noventa días realistas, lo que cuesta, y las preguntas que hará tu revisión de seguridad.
Mantenlo bajo control¶
La parte que la mayoría de frameworks de agentes te deja a ti. Léela antes de dar a un agent una herramienta que gasta dinero o que escribe en algún sitio.
-
Tres capas: lo que permite un rol, lo que amplía un grant, lo que un scope deja alcanzar a una herramienta.
-
Budgets comprobados antes de la petición, aprobaciones decididas una sola vez, alertas, y un rastro de auditoría que guarda el valor y no la fila.
-
Un único mecanismo para cada credencial en reposo, y deliberadamente ningún segundo.
Guías prácticas — recetas¶
Respuestas cortas a preguntas concretas, una vez que te manejas por aquí.
- Escribe las instrucciones de un agent
- Configura las fuentes de sincronización
- Usa las valoraciones de los mensajes
¿Buscas cómo ampliar la plataforma en Python — una capability nueva, un conector nuevo, un endpoint nuevo? Eso está en Recursos.
Adónde ir después¶
Cuando ya sabes cómo se comporta la plataforma y quieres saber exactamente qué hace un ajuste, un comando o un campo del spec, eso es la Referencia.