openai/plugins es un repositorio de muestra relacionado con los primeros complementos de OpenAI. Aunque el sistema de herramientas OpenAI actual ha evolucionado hacia llamadas de funciones, herramientas, Agentes SDK, MCP, etc., este almacén todavía tiene un valor de referencia: puede ayudar a comprender cómo se comercializó por primera vez la cuestión de “dejar que el modelo llame a herramientas externas”.
Para los desarrolladores de hoy, parece más datos históricos y muestras de diseño que una plantilla de referencia para nuevos proyectos.
¿Por qué todavía vale la pena verlo?
Los problemas centrales de la invocación de herramientas de IA no han cambiado:
- ¿Cómo sabe el modelo qué herramientas están disponibles?
- Cómo describir las capacidades de la herramienta;
- Cómo declarar parámetros;
- Cómo se devuelven los resultados;
- Cómo manejar los permisos y la confirmación del usuario;
- Cómo los modelos pueden llamar de forma segura a servicios de terceros.
En la era de los complementos, se utilizan manifiestos, esquemas OpenAPI, API del lado del servidor y otros métodos para resolver estos problemas. Las llamadas a funciones posteriores, las llamadas a herramientas y MCP todavía están evolucionando en torno a estos problemas en esencia.
Adecuado para quién mirar
Este almacén es apto para:
- Personas que quieran comprender el diseño histórico de los complementos OpenAI;
- Personas que trabajan en el ecosistema de herramientas de IA o en la plataforma de agentes;
- Personas que necesitan comprender la descripción de la herramienta Manifest/OpenAPI;
- Personas que quieran comparar las diferencias entre complementos, llamadas a funciones y MCP;
- Personas que mantienen complementos antiguos o migran soluciones antiguas.
Si es un proyecto nuevo, no se recomienda copiar directamente el modelo de complementos anterior. Se debe dar prioridad a la API oficial actual, las herramientas, el SDK de aplicaciones o los documentos relacionados con MCP.
¿Qué se puede aprender de esto?
Lo más valioso que hay que aprender no es un determinado fragmento de código, sino la idea de diseño de la interfaz de la herramienta:
- La descripción de la herramienta debe ser comprensible para el modelo;
- El esquema de API debe ser lo suficientemente claro;
- Los resultados devueltos deben ser adecuados para que el modelo continúe razonando;
- La autorización del usuario no se puede ocultar en un cuadro negro;
- Tener mensajes de error comprensibles cuando fallan las herramientas externas.
Estos principios siguen siendo válidos hoy.
Resumen
openai/plugins es más como cortar en las primeras etapas de una llamada a una herramienta de IA. No es necesariamente adecuado para uso directo en nuevos proyectos, pero es muy adecuado para comprender cómo se desarrolla la línea de “complementos, herramientas y expansión de capacidades de agentes”.
Si actualmente está integrando herramientas de AI Agent, leerlo puede ayudarlo a ver el origen de muchos problemas de diseño.