Agent

An agent is an entity that perceives its environment, takes actions autonomously to achieve a goal, and may improve its performance over time through machine learning, human control, or by acquiring knowledge. Most agents on ProteusAI are powered by AI, but you can also create agents controlled by humans.

You message agents within a chat.

  {
      "id": "681998f5474dbe26fe2e7f5f",
      "name": "Support Bot",
      "canSendWelcomeMessage": true,
      "createdAt": "2025-05-06T05:07:01.621Z",
      "description": null,
      "goal": "You are a helpful assistant. Always answer questions in a kind and helpful manner.",
      "image": null,
      "isPublic": false,
      "isTemplate": false,
      "orgId": "6816330b6f46b5afc080fbf7",
      "tags": [],
      "updatedAt": "2025-05-06T05:07:01.621Z",
      "welcomeMessage": null
  }

Properties

id ^string

The unique ID of the agent.

name ^string

The name of the agent.

goal ^string

The goal of the agent. For AI-powered agents, this acts as the system instruction that guides the agent's behavior.

description ^{string optional}

A human-readable description of the agent.

isPublic ^boolean

Whether the agent is visible outside its organization. Public agents can participate in chats with members of other organizations.

orgId ^string

The ID of the organization that owns the agent.

welcomeMessage ^{string optional}

A message the agent can send when it joins a chat (when canSendWelcomeMessage is true).