Update system agent configuration¶

Updates the configuration of the system agent in the current workspace.

PUT https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/system-agent-setups/{agent_id}

Before you call¶

The examples below use $AI_STUDIO_API_KEY, $WORKSPACE_ID, and $AGENT_ID.

Request example¶

curl -X PUT "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/system-agent-setups/$AGENT_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "enabled": true,
    "channels": {},
    "knowledge_bases": {}
  }'

Request body¶

Parameters	Type	Is it required	Description
`enabled`	boolean	Yes	Whether to enable the system agent.
`channels`	object	Yes	Channel selection configured by channel slot key. Each item can contain `instance_id` or `create`.
`knowledge_bases`	object	Yes	Knowledge base selection configured by knowledge base slot key. Each item can contain `id` or `create`.
`model`	object	No	Model configuration, can contain `model_config_ref`, `default_model`, and `params_override`.
`project_scope`	object	No	Project-wide configuration.
`suites`	object[]	No	Multi-package namespace scope.
`reconciliation_task`	object	No	Reconciliation task configuration, including `cron_expression`.

[] after a type denotes an array. [] in a field path denotes each item in an array.

Successful response¶

Returns 200 and the updated configuration on success.

{"code":0,"data":{"agent_id":"agent_01"}}

The response fields are as follows.

Field	Type	Description
`data.agent_id`	string	The system agent ID of the updated configuration.

Error response¶

{"code":2,"message":"invalid setup"}

Last updated on Sep 3, 2026