Agents

Creating an Agent

To create an agent, you need to click on Create FloTorch Agent button in the top right corner of the FloTorch Console. Provide a name and description for the agent. Agent name should be unique. Once an agent is created, you will be navigated to version configuration page, meanwhile your agent will appear in Agents list.

When an agent is created, a default version 1 is created automatically and is set in Draft state. You need to configure the agent version and publish it to make it available for use through Gateway.

Agent Versions

Agent versions are the individual configurations of an agent. Each agent can have multiple versions. Each version can have different model configurations, agent details, tools, and schema settings. Once an agent version is published, it is immutable and cannot be changed.

A new version can be created by clicking on New Version button in the top right corner of the FloTorch Console or on Agent version configure page by clicking on three dots button beside publish button which will open a dropdown which contains Create new version.

A new copy of any published or draft version (make a revision) can be created.

To create a copy of published version, click on Make a revision button which is located top right of the page.

To create a copy of draft version, click on three dots button, which will open dropdown, select make a revision option.

Configuring an Agent Version

Agent versions can be configured using below instructions.

1. Identify the agent you want to configure from the Agents table.
2. Click on Actions dropdown button and select View Versions.
3. You will see list of Agent versions in slideover table.
4. Again here, click on any table versions table row which has version number to open agent version configuration page or click on a particular row which will navigate to latest agent version configure page of that particular agent.

You will be presented with an agent configuration canvas. You can configure the following:

• Input Schema - A set of rules or policies to control the input of the agent.
• Model - Directs the processed input to the appropriate model based on defined logic.
• Agent Details - Manages core agent configuration including name, goal, sync settings, and system prompt.
• Tools - Pre-created MCP tools that can be integrated with your agent.
• Output Schema - A set of rules or policies to control the output of the agent.

Once the agent version is configured, you can publish it to make it available for use through Gateway.

Publishing an Agent Version

Agent versions can be published using the Publish button which is located top right corner of the agent version canvas. Once you click Publish button a new form will be opened in slideover which contains summary of version and mark as latest checkbox. If you mark the checkbox mark as latest as true, the current published version can be marked as latest version to the agent.

To publish already created versions which are in draft mode, click on history button which is located before Publish/Make a revision button, it will be opened a slideover with agent version list table. there click on publish button for un published versions, and click on mark as latest button to mark that version as latest version to the agent.

Once an agent version is published, it is immutable and cannot be changed.

The published agent can be used in OpenAI API as flotorch/<agent-name>:<version>

Publishing Latest Version of an Agent

You can publish the latest version of an agent by selecting a particular version.

1. Identify the agent you want to publish the latest version of.
2. Click on Actions dropdown and select Publish Latest to publish the latest version of the agent.
3. You will be presented with a slideover with versions in dropdown list. Select the version you want to publish as latest and click on Publish to publish the latest version of the agent.

Similarly like above, you can publish latest by clicking on View Versions options on actions menu, the slideover will be opened with agent versions list, there you can publish or mark the version as latest.

Once the latest version is published, it is tagged as published and can be used in OpenAI API as flotorch/<agent-name> without specifying the version.

Interacting with the Agent

To interact with the agent and test it, the agent should be published.

1. Click on code icon in the agents table row which is already published.
2. The code snippet will be opened in slideover, you can copy python, typescript or curl code and test it in your own environment.