Skip to content

Personality & Web Search

This page covers the parts of /agent-settings that shape how the built-in agent behaves by default.

Agent Personality

If souls are configured, the settings page shows an Agent Personality selector.

This selects the default soul for the built-in agent.

Souls define the agent's identity and communication style. They are stored separately and then chosen here as the default personality for new sessions.

In the current UI:

  • The selector only appears when at least one soul exists
  • You can choose Default (no soul) or a configured soul

See Souls for the file format, storage location, and API.

When the Selected Soul Is Used

The selected soul becomes the default for the built-in agent. Users can still override the soul in the chat UI for a message or session when that UI control is available.

The settings page includes a Web Search toggle.

This enables provider-native web search for agent sessions. It is not a separate callable tool in the chat tool list.

Whether it actually works depends on the selected provider and model.

Max Uses per Request

When web search is enabled, the current UI also shows Max Uses per Request.

Behavior:

  • Empty means no UI-level limit is saved here
  • Values below 1 are not kept by the UI

Scope of This Setting

This setting controls the built-in agent configuration.

Workflow type: agent steps can also define their own agent.web_search settings in DAG YAML. Those are documented separately in Agent Step.

Important Distinction

Provider-native web search is different from exposing a generic "search the web" tool.

In Dagu's built-in agent:

  • Web search is configured as part of the model request path
  • Tool permissions do not show it as a standalone tool

See Also

Released under the MIT License.