Для AI-агентов: markdown этой страницы — /docs/mcp-agents.mdиндекс документации — /llms.txt
MCP: agents
Обновлено
MCP: agents
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
get_agent_config
Read the tenant AI agent persona / prompt config: the manager block (persona, brand voice, company info, product facts, target audience, forbidden topics, legal disclaimer, the 5 Qualifier questions + post-qualification instruction, temperature/length presets, voice flags) and the coach block (same persona fields + presets). 0-cost read.
{
"description": "Read the tenant AI agent persona / prompt config: the `manager` block (persona, brand voice, company info, product facts, target audience, forbidden topics, legal disclaimer, the 5 Qualifier questions + post-qualification instruction, temperature/length presets, voice flags) and the `coach` block (same persona fields + presets). 0-cost read.",
"domain": "agents",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_agent_config",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"agents:read"
],
"risk": "read",
"scope": "agents:read",
"title": "Get Agent Config"
}update_agent_config
Update the tenant AI agent persona / prompt config (partial patch — send only manager and/or coach, and within each only the fields you change; pass null to clear a string field). Idempotent. Returns the full merged config. Presets: temperature strict|balanced|creative, length short|medium|long.
{
"description": "Update the tenant AI agent persona / prompt config (partial patch — send only `manager` and/or `coach`, and within each only the fields you change; pass null to clear a string field). Idempotent. Returns the full merged config. Presets: temperature strict|balanced|creative, length short|medium|long.",
"domain": "agents",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"coach": {
"additionalProperties": false,
"description": "Value for coach.",
"properties": {
"is_voice_enabled": {
"description": "Value for is voice enabled.",
"type": "boolean"
},
"prompt_brand_voice": {
"anyOf": [
{
"description": "Value for prompt brand voice option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt brand voice option.",
"type": "null"
}
],
"description": "Value for prompt brand voice."
},
"prompt_company_info": {
"anyOf": [
{
"description": "Value for prompt company info option.",
"maxLength": 8000,
"type": "string"
},
{
"description": "Value for prompt company info option.",
"type": "null"
}
],
"description": "Value for prompt company info."
},
"prompt_forbidden_topics": {
"anyOf": [
{
"description": "Value for prompt forbidden topics option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt forbidden topics option.",
"type": "null"
}
],
"description": "Value for prompt forbidden topics."
},
"prompt_gender": {
"anyOf": [
{
"description": "Value for prompt gender option.",
"maxLength": 64,
"type": "string"
},
{
"description": "Value for prompt gender option.",
"type": "null"
}
],
"description": "Value for prompt gender."
},
"prompt_legal_disclaimer": {
"anyOf": [
{
"description": "Value for prompt legal disclaimer option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt legal disclaimer option.",
"type": "null"
}
],
"description": "Value for prompt legal disclaimer."
},
"prompt_persona": {
"anyOf": [
{
"description": "Value for prompt persona option.",
"maxLength": 8000,
"type": "string"
},
{
"description": "Value for prompt persona option.",
"type": "null"
}
],
"description": "Value for prompt persona."
},
"prompt_product_facts": {
"anyOf": [
{
"description": "Value for prompt product facts option.",
"maxLength": 8000,
"type": "string"
},
{
"description": "Value for prompt product facts option.",
"type": "null"
}
],
"description": "Value for prompt product facts."
},
"prompt_target_audience": {
"anyOf": [
{
"description": "Value for prompt target audience option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt target audience option.",
"type": "null"
}
],
"description": "Value for prompt target audience."
},
"response_length_preset": {
"description": "Value for response length preset.",
"enum": [
"short",
"medium",
"long"
],
"type": "string"
},
"temperature_preset": {
"description": "Value for temperature preset.",
"enum": [
"strict",
"balanced",
"creative"
],
"type": "string"
}
},
"type": "object"
},
"manager": {
"additionalProperties": false,
"description": "Value for manager.",
"properties": {
"is_voice_enabled_manager": {
"description": "Value for is voice enabled manager.",
"type": "boolean"
},
"is_voice_enabled_qualifier": {
"description": "Value for is voice enabled qualifier.",
"type": "boolean"
},
"prompt_brand_voice": {
"anyOf": [
{
"description": "Value for prompt brand voice option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt brand voice option.",
"type": "null"
}
],
"description": "Value for prompt brand voice."
},
"prompt_company_info": {
"anyOf": [
{
"description": "Value for prompt company info option.",
"maxLength": 8000,
"type": "string"
},
{
"description": "Value for prompt company info option.",
"type": "null"
}
],
"description": "Value for prompt company info."
},
"prompt_forbidden_topics": {
"anyOf": [
{
"description": "Value for prompt forbidden topics option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt forbidden topics option.",
"type": "null"
}
],
"description": "Value for prompt forbidden topics."
},
"prompt_gender": {
"anyOf": [
{
"description": "Value for prompt gender option.",
"maxLength": 64,
"type": "string"
},
{
"description": "Value for prompt gender option.",
"type": "null"
}
],
"description": "Value for prompt gender."
},
"prompt_legal_disclaimer": {
"anyOf": [
{
"description": "Value for prompt legal disclaimer option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt legal disclaimer option.",
"type": "null"
}
],
"description": "Value for prompt legal disclaimer."
},
"prompt_persona": {
"anyOf": [
{
"description": "Value for prompt persona option.",
"maxLength": 8000,
"type": "string"
},
{
"description": "Value for prompt persona option.",
"type": "null"
}
],
"description": "Value for prompt persona."
},
"prompt_product_facts": {
"anyOf": [
{
"description": "Value for prompt product facts option.",
"maxLength": 8000,
"type": "string"
},
{
"description": "Value for prompt product facts option.",
"type": "null"
}
],
"description": "Value for prompt product facts."
},
"prompt_target_audience": {
"anyOf": [
{
"description": "Value for prompt target audience option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for prompt target audience option.",
"type": "null"
}
],
"description": "Value for prompt target audience."
},
"qual_post_instruction": {
"anyOf": [
{
"description": "Value for qual post instruction option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for qual post instruction option.",
"type": "null"
}
],
"description": "Value for qual post instruction."
},
"qual_prompt": {
"anyOf": [
{
"description": "Value for qual prompt option.",
"maxLength": 8000,
"type": "string"
},
{
"description": "Value for qual prompt option.",
"type": "null"
}
],
"description": "Value for qual prompt."
},
"qual_question_1": {
"anyOf": [
{
"description": "Value for qual question 1 option.",
"maxLength": 1000,
"type": "string"
},
{
"description": "Value for qual question 1 option.",
"type": "null"
}
],
"description": "Value for qual question 1."
},
"qual_question_2": {
"anyOf": [
{
"description": "Value for qual question 2 option.",
"maxLength": 1000,
"type": "string"
},
{
"description": "Value for qual question 2 option.",
"type": "null"
}
],
"description": "Value for qual question 2."
},
"qual_question_3": {
"anyOf": [
{
"description": "Value for qual question 3 option.",
"maxLength": 1000,
"type": "string"
},
{
"description": "Value for qual question 3 option.",
"type": "null"
}
],
"description": "Value for qual question 3."
},
"qual_question_4": {
"anyOf": [
{
"description": "Value for qual question 4 option.",
"maxLength": 1000,
"type": "string"
},
{
"description": "Value for qual question 4 option.",
"type": "null"
}
],
"description": "Value for qual question 4."
},
"qual_question_5": {
"anyOf": [
{
"description": "Value for qual question 5 option.",
"maxLength": 1000,
"type": "string"
},
{
"description": "Value for qual question 5 option.",
"type": "null"
}
],
"description": "Value for qual question 5."
},
"response_length_preset": {
"description": "Value for response length preset.",
"enum": [
"short",
"medium",
"long"
],
"type": "string"
},
"temperature_preset": {
"description": "Value for temperature preset.",
"enum": [
"strict",
"balanced",
"creative"
],
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"name": "update_agent_config",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"agents:write"
],
"risk": "write",
"scope": "agents:write",
"title": "Update Agent Config"
}