For most cases, your AgentOS is configured with a default set of settings. However, you can configure your AgentOS to your liking.

Configuring your AgentOS

What can be configured?
  • Display names: You can specify the display name for your AgentOS pages (Sessions, Memory, etc). This is very useful when using multiple databases, to clearly communicate to users which data is being displayed.
  • Quick prompts: You can provide one to three quick prompts for each one of your agents, teams and workflows. These are the prompts that display on the Chat Page when you create a new session.

Setting your configuration

You can provide your AgentOS configuration in two different ways: with a configuration YAML file, or using the AgentOSConfig class.
See the full reference for the AgentOSConfig class here.

Configuration YAML File

  1. Create a YAML file with your configuration. For example:
chat:
  quick_prompts:
    marketing-agent:
      - "What can you do?"
      - "How is our latest post working?"
      - "Tell me about our active marketing campaigns"
memory:
  dbs:
    - db_id: db-0001
      domain_config:
        display_name: Main app user memories
    - db_id: db-0002
      domain_config:
        display_name: Support flow user memories
  1. Pass the configuration to your AgentOS using the config parameter:
from agno.os import AgentOS

agent_os = AgentOS(
    ...
    config=<path_to_your_config_file>
)

AgentOSConfig Class

You can also provide your configuration using the AgentOSConfig class:
from agno.os import AgentOS
from agno.os.config import (
    AgentOSConfig,
    ChatConfig,
    DatabaseConfig,
    MemoryConfig,
    MemoryDomainConfig,
)

agent_os = AgentOS(
    ...
    config=AgentOSConfig(
        chat=ChatConfig(
            quick_prompts={
                "marketing-agent": [
                    "What can you do?",
                    "How is our latest post working?",
                    "Tell me about our active marketing campaigns",
                ]
            }
        ),
        memory=MemoryConfig(
            dbs=[
                DatabaseConfig(
                    db_id=marketing_db.id,
                    domain_config=MemoryDomainConfig(
                        display_name="Main app user memories",
                    ),
                ),
                DatabaseConfig(
                    db_id=support_db.id,
                    domain_config=MemoryDomainConfig(
                        display_name="Support flow user memories",
                    ),
                )
            ],
        ),
    ),
)

The /config endpoint

You can use the /config endpoint to inspect your AgentOS configuration that is served to the AgentOS Control Plane. This is the information you will find there:
  • OS ID: The ID of your AgentOS (automatically generated if not set)
  • Description: The description of your AgentOS
  • Databases: The list of IDs of the databases present in your AgentOS
  • Agents: The list of Agents available in your AgentOS
  • Teams: The list of Teams available in your AgentOS
  • Workflows: The list of Workflows available in your AgentOS
  • Interfaces: The list of Interfaces available in your AgentOS. E.g. WhatsApp, Slack, etc.
  • Chat: The configuration for the Chat page, which includes the list of quick prompts for each Agent, Team and Workflow in your AgentOS
  • Session: The configuration for the Session page of your AgentOS
  • Metrics: The configuration for the Metrics page of your AgentOS
  • Memory: The configuration for the Memory page of your AgentOS
  • Knowledge: The configuration for the Knowledge page of your AgentOS
  • Evals: The configuration for the Evals page of your AgentOS
You will receive a JSON response with your configuration. Using the previous examples, you will receive:
{
	"os_id": "0001",
	"description": "Your AgentOS",
	"databases": [
		"db-0001",
		"db-0002"
	],
	"chat": {
		"quick_prompts": {
			"marketing-agent": [
				"What can you do?",
				"How is our latest post working?",
				"Tell me about our active marketing campaigns"
			]
		}
	},
	"memory": {
		"dbs": [
			{
				"db_id": "db-0001",
				"domain_config": {
					"display_name": "Main app user memories"
				}
			},
			{
				"db_id": "db-0002",
				"domain_config": {
					"display_name": "Support flow user memories"
				}
			}
		]
	},
    ...
}
See the full schema for the /config endpoint here.