HomeGuidesAPI ReferenceRelease notes
Log In
Guides

Build a new Gen AI app

Suggest Edits

Get started quickly with our builder application setup using this simple guide. The guide will walk you through the creation of a new generative application that can be embedded into your webpage using iframe or plain REST API (using SWE SDK).

Creating an app can be done using the SWE UI console or using REST APIs or SDK.

Using the UI:

Creating an app requires a few simple steps:

  • Create an app - In the Application page, press the “Create” button. Give it a name, select the application type and you will be directed to the Application creation studio.
  • The first step to configure your app is to configure the underlying LLM model. Once you configure your model, the application playground will be enabled, in which you can experiment with your application interaction.
  • If your in AI-Assistant-Retrieval application type, you must connect a context to your application.
  • Once your application is ready to go, you can “Publish” it, and then the application will be ready to be embedded. To read more on how to embed your application, please visit the Embed your app guide.

To read more on how to configure and further fine-tune your app, visit our Build an application set of guides..

Using the SDK - Advanced Agent app example

📘

Prerequisites

To install and properly configure the SWE SDK, please visit the SDK guide.

Step 1: Create model

Select a model that will form the cornerstone of your application.

from superwise_api.models.application.application import OpenAIModel, OpenAIModelVersion

model = OpenAIModel(version=OpenAIModelVersion.GPT_4, api_token="Add your API token")

If you want to see what models are available from the provider and their versions, please use the following code:

List current supported external providers

from superwise_api.models.application.application import ModelProvider

[provider.value for provider in ModelProvider]

List current supported model versions

from superwise_api.models.application.application import GoogleModelVersion, OpenAIModelVersion, AnthropicModelVersion

display([model_version.value for model_version in GoogleModelVersion])
display([model_version.value for model_version in OpenAIModelVersion])
display([model_version.value for model_version in AnthropicModelVersion])

Step 2: Create application

In this Example we will create an Advanced Agent application. To create AI Assistant app read more here.

Create a new application with an LLM model

from superwise_api.models.application.application import AdvancedAgentConfig

app = sw.application.create(
    name="My Application name",
    additional_config=AdvancedAgentConfig(tools=[tool_1, tool_2]),
    llm_model=model,
  	prompt=None
)

You can also skip Step 1 by creating an empty application, and then update it by adding the model, tool, prompt, or update any other properties you desire in the same manner.

Create empty application

from superwise_api.models.application.application import AdvancedAgentConfig

app = sw.application.create(
    name="My Application name",
    additional_config=AdvancedAgentConfig(tools=[]),
    llm_model=None
)

Add model to the application

from superwise_api.models.application.application import OpenAIModel, OpenAIModelVersion
from superwise_api.models.application.application import AdvancedAgentConfig

llm_model = OpenAIModel(version=OpenAIModelVersion.GPT_4, api_token="Add your API token")
app = sw.application.put(str(app.id), 
                         additional_config=AdvancedAgentConfig(tools=[]),
                         llm_model=llm_model, 
                         prompt=None, 
                         name="Application name"
                        )

Test model connection

try:
    sw.application.test_model_connection(model)
except Exception as e:
    print("Model test connection failed!")

print("Model test connection success!")

Step 3: Experiment with your app using the Playground api

You can use the playground API to test your application's response. The playground section and APIs do not directly use the published application but rather internally test your existing app configuration. 

from superwise_api.models.application.application import AdvancedAgentConfig

answer = sw.application.ask_playground(
  input="Your question",
  llm_model=model,
  prompt="Just another promp",
  chat_history=[],
  additional_config= AdvancedAgentConfig(tools=[]) # Pass an AdvancedAgentConfig object
)
print(answer)

Step 4: Embed and use your app

If you are satisfied with the configured app, you can go ahead and embed it either as an iframe or using our APIs (coming soon). Simply submit the following request:

import requests

endpoint_url = f"https://api.superwise.ai/v1/app-worker/{app_id}/v1/ask"

payload = {
  "chat_history": [],
  "input": user_input
}

headers = {
  "accept": "application/json",
  "content-type": "application/json",
  "x-api-token": "YOUR APPLICATION TOKEN HERE"
}

resp = requests.post(endpoint_url, json=payload, headers=headers)
app_response = resp.json()
print(app_response)

Updated about 1 month ago