How Botpress works

The core of every Botpress agent is LLMz, a custom inference engine. It’s responsible for coordinating the agent’s behavior: interpreting instructions, managing memory, choosing the right tools, executing code, and returning a usable response.

Unlike standard tool-calling frameworks that rely on rigid prompts and external orchestration, the Botpress custom inference engine runs everything internally. It can handle complex, multi-step logic, execute JavaScript in a safe sandbox, and generate structured responses without extra configuration.

Engine

Autonomous

Step1

Instructions

##Identity
You are a customer support agent. Your goal is to route the user to the correct path based on what they're looking to accomplish in today's conversation.

Refund

Question

Add Card

Refund

Generate Content

Generate Image

Transcribe Audio

List Language Models

Add Card

Action

Start Conversation

Create Issue

Add Card

Developers

By developers, for developers.

Custom code

Inject custom code into an agent’s lifecycle events.

Inspect

Maintain full observability over an agent's actions and executions.

API

Access the API endpoints you need to build and manage agents.

Read the docs


const options = {
  method: 'POST',
  headers: {
  'x-user-key':'<x-user-key>',
  'Content-Type': 'application/json'
  },
  body: '{
  "payload":{"audioUrl":"<string>", "type":"audio"},
  "conversationId":"<string>"
  }'
};

fetch('https://chat.botpress.cloud/{webhookUrl}/messages', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));


const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{
  "name":"<string>",
  "factor":1,"frozen":true,
  "schema":{},
  "tags":{},
  "isComputeEnabled":true}'
};

fetch('https://api.botpress.cloud/v1/tables', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));


const options = {
  method: 'POST', headers: {'Content-Type': 'application/json'},
  body: '{
  "states":{},"events":{},"recurringEvents":{},
  "subscriptions":{"events":{}},"actions":{},
  "configuration":{"data":{},"schema":{}},
  "user":{"tags":{}},"conversation":{"tags":{}},
  "message":{"tags":{}},"tags":{},"code":"<string>","name":"<string>",
  "medias":[{"url":"<string>","name":"<string>"}],
  "url":"<string>","dev":true}'
};

fetch('https://api.botpress.cloud/v1/admin/bots', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

The Complete
AI Agent Platform

Botpress provides the core infrastructure needed to build and run AI agents in production.

By developers, for developers.

Trusted by businesses
across the world.

Join the largest bot building community.

The CompleteAI Agent Platform

Botpress provides the core infrastructure needed to build and run AI agents in production.

By developers, for developers.

Trusted by businesses across the world.

Join the largest bot building community.

The Complete
AI Agent Platform

Trusted by businesses
across the world.