Tools

The tools on this page are no-code — turn them on with an env var or in the dashboard, no Python required. To write your own commands and agent tools in Python instead, see Custom Commands & Tools.

Web Search (DuckDuckGo)

Free web search that works with any model provider — no API key required.

ENABLE_DUCKDUCKGO=on

The bot gets a duckduckgo_search tool and uses it when the model decides a web search would help answer a question.

Web Search (Brave Search API)

Higher-quality web search via the official Brave Search API. Requires an API key — a free tier (2,000 queries/month) is available.

ENABLE_BRAVE_SEARCH=on
BRAVE_API_KEY=your-key-here

The bot gets a brave_search tool. Both search tools can be enabled at the same time; the model picks per query. In the web dashboard, the toggle and API key field are under Models → Features.

Website Tool

Lets the bot fetch and read URLs that appear in the conversation.

ENABLE_WEBSITE_TOOLS=on

Works with any provider. For Google Gemini, there's also a native alternative — GEMINI_URL_CONTEXT=true — which is more tightly integrated with the model but only works for google: providers and not gemma-* models.

Workspace File Access

Mount a local folder and the bot can read, list, and search files inside it. Good for custom game data, knowledge bases, or any content you want the bot to look up on demand.

ENABLE_WORKSPACE=on
WORKSPACE_ROOT=workspace    # relative or absolute path

The default workspace/ folder is inside the project directory. Its contents are gitignored.

dango/
└── workspace/
    ├── items.json
    ├── rules.md
    └── characters.csv

What files can it read? Any file under 100,000 lines or 10 MB. Plain-text formats (.txt, .json, .yaml, .md, .csv) are most useful — binary files come out as raw bytes. Files over 10 MB are silently skipped.

Workspace context injection

On startup, the bot uses the LLM to write a short description of WORKSPACE_ROOT contents and injects it into the system prompt. That way the bot knows when to reach for the workspace tool.

• First run: the context is generated and saved to WORKSPACE_SYS_PROMPT_PATH (default: config/workspace_sys_prompt.txt)
• Later runs: the saved file is used as-is; edit it freely and your changes stick
• Live reload: a background task checks the workspace every 30 seconds and reloads if files change

Edge cases

Situation	Behaviour
Workspace folder is empty	Context generation is skipped; workspace context is not injected. Bot starts normally.
LLM returns an empty response during generation	A warning is printed (⚠️ Workspace context generation returned empty) and the context file is not written. Bot continues without workspace context.
File exceeds 10 MB	The file is silently skipped by the workspace tool.

Custom API Tools

Plug any HTTP API into the bot through the web dashboard — no code changes needed.

ENABLE_CUSTOM_APIS=on
CUSTOM_APIS_JSON=[{"name": "weather", "base_url": "https://api.example.com", "api_key": "secret", "description": "Weather API"}]

Single-line requirement

CUSTOM_APIS_JSON must be a single line in .env. Multi-line JSON silently fails — the variable is empty and no tools are created, with no error message.

Compress your JSON to a single line before pasting:

echo '[{"name":"weather",...}]' | jq -c '.'

The Docker web dashboard handles this automatically — use it if you want to avoid the formatting entirely.

Each entry creates a tool named call_<name>_api. The model decides when to call it based on the description field — be descriptive about what the API does and what kind of questions should trigger it. When the bot calls the tool, it can send GET or POST to any path under base_url, pass query parameters and a JSON body, with Bearer auth automatically added if api_key is set.

Fields per entry:

Field	Required	Description
name	yes	Unique name; becomes part of the tool function name
base_url	yes	Base URL of the API
api_key	no	Sent as Authorization: Bearer <key>
description	no	Shown to the model to help it decide when to call this tool

The Docker dashboard provides a UI for managing these without editing JSON directly.

SQL Databases

Add a database connection string and the bot gets list_tables and run_query tools automatically. Queries are read-only.

ENABLE_SQL_DATABASES=on
SQL_DATABASES_JSON=[{"name": "analytics", "db_url": "postgresql://user:pass@host/dbname", "description": "Analytics DB"}]

Supported databases: PostgreSQL, MySQL, SQLite, and anything SQLAlchemy supports.

Fields per entry:

Field	Required	Description
name	yes	Unique name for this database
db_url	yes	SQLAlchemy connection string
description	no	Helps the model understand what data is available

Custom Code (Commands & Tools)

Need something the no-code tools above can't express? Write it in Python. Drop a file into the gitignored custom/ directory and a single function can become a Discord slash command, an agent tool, or both at once:

from dango.extensions import command_and_tool, Ctx

@command_and_tool(name="stock", description="Get a stock quote by ticker")
async def stock(ctx: Ctx, ticker: str) -> str:
    ...

See Custom Commands & Tools for the full guide.