Smarter Manifests
A Human-to-Cloud Interface
In a word, cloud is COMPLICATED . Add data science, artificial intelligence and your customer's demands to that and, well, things get messy. Introduce Smarter Manifests: a better, simpler, cleaner way to manage your AI resources in the cloud. Smarter Manifests are very much inspired by Kubernetes manifests. In fact, we did everything in our power to make ours resemble theirs theirs in every way possible. Because, why mess with perfection?
Anatomy of a Manifest Document
A Smarter Manifest is a
YAML
document that describes a resource that makes up your AI solution. It has four main parts:
apiVersion
,
kind
,
spec
and
status
. Each of these section plays a specific role in the lifecycle of your AI resources. The
apiVersion
identifies the Manifest document to the Smarter API. The
kind
identifies the type of resource being described. The
spec
section contains the configuration of the resource. And lastly, the
status
section contains read-only data about the state of resource. Here is the layout of a generic Manifest:
apiVersion: smarter.sh/v1
kind: Chatbot
metadata:
# Metadata about your resource goes here. These required fields are used for identifying
# and managing your resource inside of Smarter.
description: A human readable description of this resource. Keep it brief.
name: MyChatbot
version: 1.0.0
spec:
# your specification goes here. Each kind of resource has its own spec layout
# which you can scaffold using the Smarter CLI command `smarter manifest -o yaml`.
# For example: `smarter manifest chatbot -o yaml`
status:
# read-only status about your AI resource goes here.
You use the Smarter CLI to apply your Manifests. The Smarter CLI reads your Manifests, and then creates and executes a work plan to create, update, or delete your AI resources, to synchronize the state of the resources in your account with those of your Manifest(s). It's a simple and powerful way to manage your AI cloud resources.
Usage
Here's an example of how you would apply a Manifest using the Smarter CLI:
smarter apply -f my-manifest.yaml
Design, Train, Test, Deploy
A Smarter Manifest describes, in a human-readle format, the resources that makeup your Chatbot solution. You use manifests to creates, manage, deploy, and destroy your AI resources. Manifests are simple text files in YAML format. Start with an example manifest, here or from the Smarter CLI. Tweak it to suit your needs. Then use the Smarter CLI to apply it. That's it! It doesn't get any simpler.
Easy
There are around a dozen kinds of Smarter resources. Explore these examples.
smarter.sh/v1 Specification
We published technical specifications for all of our manifests, so that other platforms can adopt these, making your AI resources cross-platform compatible. Additionally, this opens up the potential for a marketplace of AI resources, where you can share your manifests with others, and where third party developers can create exciting new value-added services for the Smarter platform.