🚀 Caught up on AWS’s open-sourcing of API models in Smithy format (slipped my radar earlier this year, but timeless value!).

🚀 Caught up on AWS’s open-sourcing of API models in Smithy format (slipped my radar earlier this year, but timeless value!). There is a GitHub Repository [4] available with AWS API smithy models for 200+ services. Announcement Blog: [1]

A Smithy model is the core semantic representation in Smithy, an open-source interface definition language (IDL) developed by AWS for defining APIs, services, and data structures in a protocol-agnostic way.

It consists of shapes (like primitives, lists, maps, structures, and services), traits, annotations that carry metadata, constraints, and protocol or behavioral semantics, and shape IDs for referencing components, enabling code generation for SDKs and documentation across languages, plus validation, of the model itself through Smithy’s validators, and of API inputs through constraint traits picked up by generated code. Models are serialized in formats like Smithy IDL or JSON and include a prelude with built-in types.

AWS uses Smithy to model its service APIs and to generate the surrounding tooling. With the API models for 200+ services now publicly available on GitHub, the same machine-readable definitions can feed custom clients, and, by the same mechanism, tool schemas for AI agents that call these APIs.

This is another building block to build AI Agent which are car which allow to carefully balance agency and control.

You can dive deeper in Jin Tan Ruan - M.S Artificial Intelligence And Machine Learning’s article [2] and the smithy project page [3]. [1] https://aws.amazon.com/blogs/aws/introducing-aws-api-models-and-publicly-available-resources-for-aws-api-definitions/ [2] https://www.linkedin.com/pulse/aws-smithy-api-models-fueling-agentic-ai-safe-tool-jin-2pwre/ [3] https://smithy.io/ [4] https://github.com/aws/api-models-aws

• AWS
• AIAgents
• API
• OpenSource