Un agente solo puede elegir bien si sabe qué acciones tiene disponibles. Una lista general de documentación no basta: la aplicación puede habilitar solo una parte, el entorno puede carecer de una función o el modo de permisos puede impedir una acción. IaGenify SDK 0.3.2 añade un mapa de capacidades basado en las herramientas reales de cada ejecución.
Describe la ejecución real, no la plataforma en teoría
Al empezar, el agente recibe un resumen compacto de los grupos de herramientas activos y sus acciones. Si la aplicación retira una herramienta, desaparece del mapa. Si el entorno no ofrece una acción, el agente no recibe una promesa falsa de que puede realizarla. Así su planificación se ajusta a lo que realmente se ejecuta.
Un catálogo ayuda con varias decisiones
El mismo catálogo ayuda al agente a elegir operaciones, encontrar su documentación detallada y a los desarrolladores a entender dónde vive cada capacidad. El resumen explica qué existe; la referencia explica cómo usarlo. Separar ambos niveles mantiene breve el mapa inicial y hace más útiles las explicaciones posteriores.
La cobertura se puede comprobar, no solo recordar
Una comprobación de contrato compara los métodos de los recursos del SDK con el código de herramientas del agente. Cada método debe estar disponible mediante una herramienta o tener una razón documentada para quedar fuera. Así, una capacidad desconectada se detecta durante el desarrollo, sin depender de sincronizar varias listas a mano.
El control también evita accesos accidentales. Algunos métodos deben quedar fuera porque gestionan autoridad de cuenta o secretos; otros no existen en determinados entornos. El catálogo diferencia esos límites deliberados de un descuido.
Un mapa compacto puede describir un SDK amplio
La versión mide el acceso por acciones y no solo por nombres de herramientas. Una herramienta puede incluir varias operaciones, por lo que contar nombres oculta lo que puede hacer el agente. Un resumen conciso da contexto al modelo sin una larga serie de consultas previas.
Un agente debe planificar desde las capacidades que tiene en su ejecución, no desde un folleto de todo lo que quizá admita la plataforma.
IaGenify SDK 0.3.2 facilita mantener la frontera entre el SDK y el ciclo del agente: las capacidades vienen del catálogo de ejecución y una comprobación de contrato vigila que los recursos públicos y las herramientas no diverjan.
Preguntas frecuentes
¿El mapa activa todos los métodos del SDK?
No. Describe lo que está disponible en esa ejecución; la selección de la aplicación, el entorno y los permisos siguen aplicándose.
¿En qué se diferencia de la documentación?
Resume lo que la ejecución puede hacer; la documentación explica cómo usar una operación.
¿Por qué contar acciones y no nombres de herramientas?
Una herramienta puede agrupar varias operaciones, así que las acciones describen mejor lo que puede hacer el agente.
¿Las operaciones sensibles se exponen automáticamente?
No. Las relacionadas con autoridad de cuenta o secretos pueden excluirse con una razón documentada y comprobable.