Exportar#
Por la API
Exportar e importar la definición del agente se hace por la API v1
(/api/v1/agentes); la pantalla todavía no tiene botón para eso. Duplicar un agente
dentro del mismo workspace se hace por la pantalla (lista de Agentes › Duplicar).
Un agente se convierte en un archivo con la definición entera: objetivo, instrucciones, tablas, herramientas, bases de conocimiento y equipo.
Las referencias salen por nombre, nunca por identificador interno. Un identificador de otro entorno no significa nada en el destino — importar así crearía un agente que parece configurado y no funciona.
Ninguna credencial sale en el archivo.
Importar#
Al importar, la plataforma busca cada referencia por el nombre en el destino y dice, ítem por ítem, lo que no encontró:
La tabla
gold_vendas_2024no existe en este workspace · base "Políticas" no encontrada
El agente importado nace siempre como borrador, con los pendientes visibles. Un agente importado "con éxito" que responde mal porque la mitad de las referencias no se resolvió es el peor desenlace posible.
Y cuando hay dos nombres iguales en el destino, no se vincula nada: elegir uno de los dos sería invisible, porque el nombre en la pantalla estaría correcto.
API#
Hay una API para leer: listar agentes, exportar la definición, consultar ejecuciones. La descripción técnica (OpenAPI) está disponible en la propia API.
Ejecutar un agente con una clave de API todavía no existe. La razón es la misma regla de permisos de las otras pantallas: toda ejecución ocurre con el permiso de una persona, y una clave no es una persona. Hacer que la clave se hiciera pasar por alguien funcionaría — y la auditoría pasaría a decir que esa persona preguntó, cuando no fue ella. Preferimos no tener el recurso a tener un recurso que miente.