MCP टूल
प्रोजेक्ट प्रोफ़ाइल अपडेट करें
sosoapi_update_project_profileप्रोजेक्ट की ब्रांड प्रोफ़ाइल के फ़ील्ड आंशिक रूप से अपडेट करें। छोड़े गए फ़ील्ड अपरिवर्तित रहते हैं। सबसे हाल में पढ़ा गया expected_profile_version और idempotency_key चाहिए (editor भूमिका)।
Markdown में पढ़ेंप्रोफ़ाइल और ट्रांसपोर्ट
प्रोफ़ाइल: full · ट्रांसपोर्ट: stdio, http
क्लाइंट में दिखने वाले टूल के लिए core या full चुनें; इससे अनुमतियाँ नहीं बदलतीं। लोकल फ़ाइल अपलोड के लिए stdio चाहिए और HTTP पर उपलब्ध नहीं। खोज में आउटपुट स्कीमा के लिए SOSOAPI_OUTPUT_SCHEMAS=1 सेट करें। इस सेटिंग के साथ या बिना टूल संरचित परिणाम लौटाते हैं।
अनुमतियाँ और अन्य प्रभाव
एनोटेशन क्लाइंट को टूल का वर्णन करने में मदद करते हैं। हर कॉल फिर भी यूज़र का प्रमाणीकरण, भूमिका, संसाधन एक्सेस और क्षमता अधिकार जाँचती है।
{
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}- /studio-api/projects/profile/update: agent:operate · synchronous_http_response
इनपुट फ़ील्ड
Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।
| फ़ील्ड / शाखा | प्रकार / अनिवार्य | शर्तें |
|---|---|---|
$ | objectपैरेंट में अनिवार्य |
|
project_id | stringपैरेंट में अनिवार्य |
|
expected_profile_version | integerपैरेंट में अनिवार्य |
|
idempotency_key | stringपैरेंट में अनिवार्य |
|
patch | objectपैरेंट में अनिवार्य |
|
patch.tagline | string | nullवैकल्पिक / आइटम | — |
patch.taglineanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.taglineanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.description | string | nullवैकल्पिक / आइटम | — |
patch.descriptionanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.descriptionanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.voice | string | nullवैकल्पिक / आइटम | — |
patch.voiceanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.voiceanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.target_audience | string | nullवैकल्पिक / आइटम | — |
patch.target_audienceanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.target_audienceanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.color_palette | arrayवैकल्पिक / आइटम |
|
patch.color_palette[] | stringवैकल्पिक / आइटम |
|
patch.goals | arrayवैकल्पिक / आइटम |
|
patch.goals[] | stringवैकल्पिक / आइटम |
|
patch.no_go_topics | arrayवैकल्पिक / आइटम |
|
patch.no_go_topics[] | stringवैकल्पिक / आइटम |
|
patch.language_primary | stringवैकल्पिक / आइटम |
|
patch.positioning | string | nullवैकल्पिक / आइटम | — |
patch.positioninganyOf 1 | stringवैकल्पिक / आइटम |
|
patch.positioninganyOf 2 | nullवैकल्पिक / आइटम | — |
patch.usp | string | nullवैकल्पिक / आइटम | — |
patch.uspanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.uspanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.visual_identity | object | nullवैकल्पिक / आइटम | — |
patch.visual_identityanyOf 1 | objectवैकल्पिक / आइटम |
|
patch.visual_identity.*anyOf 1 | any JSON valueवैकल्पिक / आइटम | — |
patch.visual_identityanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.forbidden_claims | arrayवैकल्पिक / आइटम |
|
patch.forbidden_claims[] | stringवैकल्पिक / आइटम |
|
patch.north_star_metric | string | nullवैकल्पिक / आइटम | — |
patch.north_star_metricanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.north_star_metricanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.posting_cadence | object | nullवैकल्पिक / आइटम | — |
patch.posting_cadenceanyOf 1 | objectवैकल्पिक / आइटम |
|
patch.posting_cadence.*anyOf 1 | any JSON valueवैकल्पिक / आइटम | — |
patch.posting_cadenceanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.app_store_url_ios | string | nullवैकल्पिक / आइटम | — |
patch.app_store_url_iosanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.app_store_url_iosanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.app_store_url_android | string | nullवैकल्पिक / आइटम | — |
patch.app_store_url_androidanyOf 1 | stringवैकल्पिक / आइटम |
|
patch.app_store_url_androidanyOf 2 | nullवैकल्पिक / आइटम | — |
patch.app_metadata | objectवैकल्पिक / आइटम |
|
patch.app_metadata.* | any JSON valueवैकल्पिक / आइटम | — |
संपूर्ण JSON Schema
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"format": "uuid"
},
"expected_profile_version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 160
},
"patch": {
"type": "object",
"properties": {
"tagline": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
]
},
"voice": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
]
},
"target_audience": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
]
},
"color_palette": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 64
}
},
"goals": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"maxLength": 160
}
},
"no_go_topics": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 160
}
},
"language_primary": {
"type": "string",
"minLength": 2,
"maxLength": 35
},
"positioning": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
]
},
"usp": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
]
},
"visual_identity": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"forbidden_claims": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 240
}
},
"north_star_metric": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"posting_cadence": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"app_store_url_ios": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"app_store_url_android": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"app_metadata": {
"type": "object",
"additionalProperties": {}
}
},
"additionalProperties": false
}
},
"required": [
"project_id",
"expected_profile_version",
"idempotency_key",
"patch"
],
"additionalProperties": false
}संरचित आउटपुट
यह स्कीमा सफल टूल परिणाम के structuredContent का वर्णन करता है। MCP रिस्पॉन्स में content भी होता है और कॉल विफल होने पर isError सेट हो सकता है। प्रकाशन के लिए स्वीकृत अनुरोध या टेक्स्ट रिस्पॉन्स को पुष्टि मानने के बजाय पोस्ट का अंतिम परिणाम पढ़ें। लिंक किया गया API ऑपरेशन अनुमतियाँ और पुनः प्रयास के नियम समझाता है।
Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।
| फ़ील्ड / शाखा | प्रकार / अनिवार्य | शर्तें |
|---|---|---|
$ | objectपैरेंट में अनिवार्य |
|
contract_version | stringपैरेंट में अनिवार्य |
|
profile | objectपैरेंट में अनिवार्य |
|
profile.project_id | stringपैरेंट में अनिवार्य |
|
profile.workspace_id | stringपैरेंट में अनिवार्य |
|
profile.tagline | string | nullपैरेंट में अनिवार्य | — |
profile.taglineanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.taglineanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.description | string | nullपैरेंट में अनिवार्य | — |
profile.descriptionanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.descriptionanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.voice | string | nullपैरेंट में अनिवार्य | — |
profile.voiceanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.voiceanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.target_audience | string | nullपैरेंट में अनिवार्य | — |
profile.target_audienceanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.target_audienceanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.color_palette | arrayपैरेंट में अनिवार्य | — |
profile.color_palette[] | stringवैकल्पिक / आइटम | — |
profile.goals | arrayपैरेंट में अनिवार्य | — |
profile.goals[] | stringवैकल्पिक / आइटम | — |
profile.no_go_topics | arrayपैरेंट में अनिवार्य | — |
profile.no_go_topics[] | stringवैकल्पिक / आइटम | — |
profile.language_primary | stringपैरेंट में अनिवार्य | — |
profile.positioning | string | nullपैरेंट में अनिवार्य | — |
profile.positioninganyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.positioninganyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.usp | string | nullपैरेंट में अनिवार्य | — |
profile.uspanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.uspanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.visual_identity | object | nullपैरेंट में अनिवार्य | — |
profile.visual_identityanyOf 1 | objectपैरेंट में अनिवार्य |
|
profile.visual_identity.*anyOf 1 | any JSON valueवैकल्पिक / आइटम | — |
profile.visual_identityanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.forbidden_claims | arrayपैरेंट में अनिवार्य | — |
profile.forbidden_claims[] | stringवैकल्पिक / आइटम | — |
profile.north_star_metric | string | nullपैरेंट में अनिवार्य | — |
profile.north_star_metricanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.north_star_metricanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.posting_cadence | object | nullपैरेंट में अनिवार्य | — |
profile.posting_cadenceanyOf 1 | objectपैरेंट में अनिवार्य |
|
profile.posting_cadence.*anyOf 1 | any JSON valueवैकल्पिक / आइटम | — |
profile.posting_cadenceanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.app_store_url_ios | string | nullपैरेंट में अनिवार्य | — |
profile.app_store_url_iosanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.app_store_url_iosanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.app_store_url_android | string | nullपैरेंट में अनिवार्य | — |
profile.app_store_url_androidanyOf 1 | stringपैरेंट में अनिवार्य | — |
profile.app_store_url_androidanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.app_metadata | objectपैरेंट में अनिवार्य |
|
profile.app_metadata.* | any JSON valueवैकल्पिक / आइटम | — |
profile.profile_version | integerपैरेंट में अनिवार्य |
|
profile.updated_by | string | nullपैरेंट में अनिवार्य | — |
profile.updated_byanyOf 1 | stringपैरेंट में अनिवार्य |
|
profile.updated_byanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.updated_by_kind | stringपैरेंट में अनिवार्य |
|
profile.updated_by_api_key_id | string | nullपैरेंट में अनिवार्य | — |
profile.updated_by_api_key_idanyOf 1 | stringपैरेंट में अनिवार्य |
|
profile.updated_by_api_key_idanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.updated_by_delegated_grant_id | string | nullपैरेंट में अनिवार्य | — |
profile.updated_by_delegated_grant_idanyOf 1 | stringपैरेंट में अनिवार्य |
|
profile.updated_by_delegated_grant_idanyOf 2 | nullपैरेंट में अनिवार्य | — |
profile.created_at | stringपैरेंट में अनिवार्य |
|
profile.updated_at | stringपैरेंट में अनिवार्य |
|
receipt_id | stringपैरेंट में अनिवार्य |
|
applied | booleanपैरेंट में अनिवार्य | — |
deduped | booleanपैरेंट में अनिवार्य | — |
संपूर्ण JSON Schema
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "project/v1"
},
"profile": {
"type": "object",
"properties": {
"project_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"tagline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"voice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"target_audience": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"color_palette": {
"type": "array",
"items": {
"type": "string"
}
},
"goals": {
"type": "array",
"items": {
"type": "string"
}
},
"no_go_topics": {
"type": "array",
"items": {
"type": "string"
}
},
"language_primary": {
"type": "string"
},
"positioning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"usp": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"visual_identity": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"forbidden_claims": {
"type": "array",
"items": {
"type": "string"
}
},
"north_star_metric": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"posting_cadence": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"app_store_url_ios": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"app_store_url_android": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"app_metadata": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"profile_version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"updated_by": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"updated_by_kind": {
"type": "string",
"enum": [
"jwt",
"api_key",
"delegated_ai",
"migration"
]
},
"updated_by_api_key_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"updated_by_delegated_grant_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"updated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"project_id",
"workspace_id",
"tagline",
"description",
"voice",
"target_audience",
"color_palette",
"goals",
"no_go_topics",
"language_primary",
"positioning",
"usp",
"visual_identity",
"forbidden_claims",
"north_star_metric",
"posting_cadence",
"app_store_url_ios",
"app_store_url_android",
"app_metadata",
"profile_version",
"updated_by",
"updated_by_kind",
"updated_by_api_key_id",
"updated_by_delegated_grant_id",
"created_at",
"updated_at"
],
"additionalProperties": false
},
"receipt_id": {
"type": "string",
"format": "uuid"
},
"applied": {
"type": "boolean"
},
"deduped": {
"type": "boolean"
}
},
"required": [
"contract_version",
"profile",
"receipt_id",
"applied",
"deduped"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}टूल कॉल का उदाहरण
उदाहरणों में स्कीमा से जाँचे काल्पनिक मान हैं। IDs को अधिकृत IDs, मीडिया को तैयार एसेट और तारीखों को पुष्ट प्रकाशन समय से बदलें। राइट सबमिट करने से पहले खाते की पात्रता जाँचें। यह पेज API अनुरोध नहीं भेजता।
{
"name": "sosoapi_update_project_profile",
"arguments": {
"project_id": "11111111-1111-4111-8111-111111111111",
"expected_profile_version": 1,
"idempotency_key": "example-intent-0001",
"patch": {
"tagline": "A fictional project for the documentation example."
}
}
}structuredContent
{
"contract_version": "project/v1",
"profile": {
"project_id": "11111111-1111-4111-8111-111111111111",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"tagline": null,
"description": null,
"voice": null,
"target_audience": null,
"color_palette": [],
"goals": [],
"no_go_topics": [],
"language_primary": "example",
"positioning": null,
"usp": null,
"visual_identity": null,
"forbidden_claims": [],
"north_star_metric": null,
"posting_cadence": null,
"app_store_url_ios": null,
"app_store_url_android": null,
"app_metadata": {},
"profile_version": 1,
"updated_by": null,
"updated_by_kind": "jwt",
"updated_by_api_key_id": null,
"updated_by_delegated_grant_id": null,
"created_at": "2099-01-15T09:00:00Z",
"updated_at": "2099-01-15T09:00:00Z"
},
"receipt_id": "11111111-1111-4111-8111-111111111111",
"applied": false,
"deduped": false
}