Application State Management

Maintain and update app state with function calls and tool results

To-Do List Manager

Incredible can manage stateful applications, where actions mutate state. With this you can build entirely new software and applications from the ground up using these models. Not just connecting it to an already existing system. A simple example of a stateful application would be a to-do list manager.

curl https://api.incredible.one/v1/chat-completion \
  --header "Content-Type: application/json" \
  --data '{
    "model": "small-1",
    "functions": [
		  {
		    "name": "create_new_todo_list",
		    "description": "Create a new todo list",
		    "parameters": {
		      "type": "object",
		      "properties": {
		        "name": { "type": "string", "description": "Name of the todo list" }
		      },
		      "required": ["name"]
		    }
		  },
		  {
		    "name": "add_todo_item",
		    "description": "Add a new item to an existing todo list",
		    "parameters": {
		      "type": "object",
		      "properties": {
		        "list_id": { "type": "string", "description": "The ID of the list" },
		        "title": { "type": "string", "description": "The todo item title" },
		        "due_date": { "type": "string", "format": "date", "description": "Optional due date in YYYY-MM-DD" }
		      },
		      "required": ["list_id", "title"]
		    }
		  }
		],
    "messages": [
      {
        "role": "user",
        "content": "Add a high priority task to review quarterly reports by Friday, and show me all my current tasks"
      }
    ]
  }'

Example Scenario

1. User: “Add a task to review quarterly reports by Friday.”

2. AI: “You don’t have a to-do list yet. Do you want me to create one? Here are 3 suggestions:

   • Work Tasks
   • Personal Errands
   • Long-term Projects”

3. User: “Yes, create work tasks.”

   → AI calls create_new_todo_list

4. AI: “Okay, I created a list called ‘Work Tasks’. Now I’ll add your item.”

   → AI calls add_todo_item with title=Review quarterly reports, due_date=Friday

5. AI: “Done! You now have 1 todo in your Work Tasks list.”

Delete a Todo List

Here’s how you can define the function to remove an entire list:

{
    "model": "small-1",
    "functions": [
      {
        "name": "delete_todo_list",
        "description": "Delete an existing todo list",
        "parameters": {
          "type": "object",
          "properties": {
            "list_id": { "type": "string", "description": "The ID of the list to delete" }
          },
          "required": ["list_id"]
        }
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Delete my list with ID 12345"
      }
    ]
}

Remove an Item from Todo List

Here’s how you can define the function to remove an item from todo list:

{
  "name": "remove_todo_item",
  "description": "Remove an item from a todo list",
  "parameters": {
    "type": "object",
    "properties": {
      "list_id": {
        "type": "string",
        "description": "The ID of the list"
      },
      "item_id": {
        "type": "string",
        "description": "The ID of the item to remove"
      }
    },
    "required": [
      "list_id",
      "item_id"
    ]
  }
}