FrankoX
Verified opt-in trade profiles and consented manufacturer drafts; no private customer data.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"trade-intelligence": {
"url": "https://frankox.com/mcp"
}
}
}Puntos de conexión remotos
https://frankox.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (14)
🟢search_manufacturers(product, specification, hs_cn_code, country, certification, ...)
Search only verified opt-in public manufacturer projections; no availability or demand inference.
Esquema de entrada
{
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Product"
},
"specification": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Specification"
},
"hs_cn_code": {
"anyOf": [
{
"pattern": "^[0-9]{4,10}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hs Cn Code"
},
"country": {
"anyOf": [
{
"pattern": "^[A-Z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"certification": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Certification"
},
"moq": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Moq"
},
"capacity": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacity"
},
"delivery_geography": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Delivery Geography"
},
"keywords": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Keywords"
},
"limit": {
"default": 10,
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"canonical_concept_id": {
"anyOf": [
{
"pattern": "^[a-z0-9][a-z0-9._:-]{0,99}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical Concept Id"
},
"preferred_language": {
"default": "en",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Preferred Language",
"type": "string"
},
"source_language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Source Language",
"type": "string"
}
},
"additionalProperties": false,
"title": "SearchQuery"
}🟢search_products(product, specification, hs_cn_code, country, certification, ...)
Search only verified opt-in public product profiles.
Esquema de entrada
{
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Product"
},
"specification": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Specification"
},
"hs_cn_code": {
"anyOf": [
{
"pattern": "^[0-9]{4,10}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hs Cn Code"
},
"country": {
"anyOf": [
{
"pattern": "^[A-Z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"certification": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Certification"
},
"moq": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Moq"
},
"capacity": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacity"
},
"delivery_geography": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Delivery Geography"
},
"keywords": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Keywords"
},
"limit": {
"default": 10,
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"canonical_concept_id": {
"anyOf": [
{
"pattern": "^[a-z0-9][a-z0-9._:-]{0,99}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical Concept Id"
},
"preferred_language": {
"default": "en",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Preferred Language",
"type": "string"
},
"source_language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Source Language",
"type": "string"
}
},
"additionalProperties": false,
"title": "SearchQuery"
}🟢search_suppliers(product, specification, hs_cn_code, country, certification, ...)
Find public manufacturer/supplier profile candidates; existence does not establish available stock.
Esquema de entrada
{
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Product"
},
"specification": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Specification"
},
"hs_cn_code": {
"anyOf": [
{
"pattern": "^[0-9]{4,10}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hs Cn Code"
},
"country": {
"anyOf": [
{
"pattern": "^[A-Z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"certification": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Certification"
},
"moq": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Moq"
},
"capacity": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacity"
},
"delivery_geography": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Delivery Geography"
},
"keywords": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Keywords"
},
"limit": {
"default": 10,
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"canonical_concept_id": {
"anyOf": [
{
"pattern": "^[a-z0-9][a-z0-9._:-]{0,99}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical Concept Id"
},
"preferred_language": {
"default": "en",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Preferred Language",
"type": "string"
},
"source_language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Source Language",
"type": "string"
}
},
"additionalProperties": false,
"title": "SearchQuery"
}🟢search_opportunities(product, specification, hs_cn_code, country, certification, ...)
Search permitted abstract public opportunity profiles; private counterparties and contacts excluded.
Esquema de entrada
{
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Product"
},
"specification": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Specification"
},
"hs_cn_code": {
"anyOf": [
{
"pattern": "^[0-9]{4,10}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hs Cn Code"
},
"country": {
"anyOf": [
{
"pattern": "^[A-Z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"certification": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Certification"
},
"moq": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Moq"
},
"capacity": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacity"
},
"delivery_geography": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Delivery Geography"
},
"keywords": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Keywords"
},
"limit": {
"default": 10,
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"canonical_concept_id": {
"anyOf": [
{
"pattern": "^[a-z0-9][a-z0-9._:-]{0,99}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical Concept Id"
},
"preferred_language": {
"default": "en",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Preferred Language",
"type": "string"
},
"source_language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Source Language",
"type": "string"
}
},
"additionalProperties": false,
"title": "SearchQuery"
}🟢get_public_company_profile(record_id)
Retrieve a verified opt-in public profile by opaque ID; returns no private contacts or documents.
Esquema de entrada
{
"type": "object",
"properties": {
"record_id": {
"type": "string",
"minLength": 1,
"maxLength": 36
}
},
"required": [
"record_id"
],
"additionalProperties": false
}🟢get_public_product_profile(record_id)
Retrieve a verified opt-in public profile by opaque ID; returns no private contacts or documents.
Esquema de entrada
{
"type": "object",
"properties": {
"record_id": {
"type": "string",
"minLength": 1,
"maxLength": 36
}
},
"required": [
"record_id"
],
"additionalProperties": false
}⚪register_manufacturer_interest(idempotency_key, consent, company_name)
Record interest only after explicit user approval. Does not enroll or verify a company.
Esquema de entrada
{
"type": "object",
"properties": {
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 100
},
"consent": {
"additionalProperties": false,
"properties": {
"explicitly_authorized": {
"const": true,
"title": "Explicitly Authorized",
"type": "boolean"
},
"purpose": {
"enum": [
"MANUFACTURER_DRAFT",
"MANUFACTURER_INTEREST"
],
"title": "Purpose",
"type": "string"
},
"statement": {
"maxLength": 1000,
"minLength": 10,
"title": "Statement",
"type": "string"
}
},
"required": [
"explicitly_authorized",
"purpose",
"statement"
],
"title": "Consent",
"type": "object"
},
"company_name": {
"additionalProperties": false,
"properties": {
"original": {
"maxLength": 3000,
"minLength": 1,
"title": "Original",
"type": "string"
},
"language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$|^und$",
"title": "Language",
"type": "string"
},
"canonical": {
"anyOf": [
{
"maxLength": 3000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical"
},
"canonical_authority": {
"default": "UNKNOWN",
"enum": [
"CUSTOMER_DECLARED",
"SEMANTIC_PROPOSAL",
"UNKNOWN"
],
"title": "Canonical Authority",
"type": "string"
},
"translated_views": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 30,
"title": "Translated Views",
"type": "object"
}
},
"required": [
"original"
],
"title": "MultilingualText",
"type": "object"
}
},
"required": [
"idempotency_key",
"consent",
"company_name"
],
"additionalProperties": false
}🟡create_manufacturer_draft(idempotency_key, consent, profile, referral_source)
Submit an explicitly consented private unverified manufacturer draft. Requires real company confirmation before authority and independent review/publication permission before search visibility.
Esquema de entrada
{
"type": "object",
"properties": {
"idempotency_key": {
"maxLength": 100,
"minLength": 8,
"pattern": "^[A-Za-z0-9_-]+$",
"title": "Idempotency Key",
"type": "string"
},
"consent": {
"$ref": "#/$defs/Consent"
},
"profile": {
"$ref": "#/$defs/DraftPayload"
},
"referral_source": {
"default": "UNKNOWN",
"enum": [
"DIRECT",
"GOOGLE",
"BING",
"EMAIL_CAMPAIGN",
"LINKEDIN",
"PARTNER",
"REFERRAL",
"CHATGPT",
"CODEX",
"MCP",
"A2A",
"OTHER_AGENT",
"UNKNOWN"
],
"title": "Referral Source",
"type": "string"
}
},
"required": [
"idempotency_key",
"consent",
"profile"
],
"$defs": {
"Consent": {
"additionalProperties": false,
"properties": {
"explicitly_authorized": {
"const": true,
"title": "Explicitly Authorized",
"type": "boolean"
},
"purpose": {
"enum": [
"MANUFACTURER_DRAFT",
"MANUFACTURER_INTEREST"
],
"title": "Purpose",
"type": "string"
},
"statement": {
"maxLength": 1000,
"minLength": 10,
"title": "Statement",
"type": "string"
}
},
"required": [
"explicitly_authorized",
"purpose",
"statement"
],
"title": "Consent",
"type": "object"
},
"DraftPayload": {
"additionalProperties": false,
"properties": {
"company_name": {
"$ref": "#/$defs/MultilingualText"
},
"country": {
"pattern": "^[A-Z]{2}$|^UNKNOWN$",
"title": "Country",
"type": "string"
},
"website": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Website"
},
"products": {
"items": {
"$ref": "#/$defs/PublicProduct"
},
"maxItems": 30,
"title": "Products",
"type": "array"
},
"public_contacts": {
"items": {
"type": "string"
},
"maxItems": 10,
"title": "Public Contacts",
"type": "array"
},
"catalogue": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Catalogue"
},
"price_list": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Price List"
},
"certifications": {
"items": {
"type": "string"
},
"maxItems": 20,
"title": "Certifications",
"type": "array"
},
"export_markets": {
"items": {
"type": "string"
},
"maxItems": 30,
"title": "Export Markets",
"type": "array"
},
"commercial_information": {
"anyOf": [
{
"maxLength": 3000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Commercial Information"
}
},
"required": [
"company_name",
"country"
],
"title": "DraftPayload",
"type": "object"
},
"MultilingualText": {
"additionalProperties": false,
"properties": {
"original": {
"maxLength": 3000,
"minLength": 1,
"title": "Original",
"type": "string"
},
"language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$|^und$",
"title": "Language",
"type": "string"
},
"canonical": {
"anyOf": [
{
"maxLength": 3000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical"
},
"canonical_authority": {
"default": "UNKNOWN",
"enum": [
"CUSTOMER_DECLARED",
"SEMANTIC_PROPOSAL",
"UNKNOWN"
],
"title": "Canonical Authority",
"type": "string"
},
"translated_views": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 30,
"title": "Translated Views",
"type": "object"
}
},
"required": [
"original"
],
"title": "MultilingualText",
"type": "object"
},
"PublicProduct": {
"additionalProperties": false,
"properties": {
"name": {
"$ref": "#/$defs/MultilingualText"
},
"specifications": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 30,
"title": "Specifications",
"type": "object"
},
"hs_cn_code": {
"anyOf": [
{
"pattern": "^[0-9]{4,10}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hs Cn Code"
},
"certifications": {
"items": {
"type": "string"
},
"maxItems": 15,
"title": "Certifications",
"type": "array"
},
"export_markets": {
"items": {
"type": "string"
},
"maxItems": 30,
"title": "Export Markets",
"type": "array"
},
"capacity": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacity"
},
"moq": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Moq"
},
"canonical_concept_id": {
"anyOf": [
{
"pattern": "^[a-z0-9][a-z0-9._:-]{0,99}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical Concept Id"
}
},
"required": [
"name"
],
"title": "PublicProduct",
"type": "object"
}
},
"additionalProperties": false,
"title": "DraftCreate"
}🔴update_manufacturer_draft(draft_id, revision, profile)
Update the authenticated submitting agent's unconfirmed draft with optimistic revision checks.
Esquema de entrada
{
"type": "object",
"properties": {
"draft_id": {
"maxLength": 36,
"minLength": 1,
"title": "Draft Id",
"type": "string"
},
"revision": {
"minimum": 1,
"title": "Revision",
"type": "integer"
},
"profile": {
"$ref": "#/$defs/DraftPayload"
}
},
"required": [
"draft_id",
"revision",
"profile"
],
"$defs": {
"DraftPayload": {
"additionalProperties": false,
"properties": {
"company_name": {
"$ref": "#/$defs/MultilingualText"
},
"country": {
"pattern": "^[A-Z]{2}$|^UNKNOWN$",
"title": "Country",
"type": "string"
},
"website": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Website"
},
"products": {
"items": {
"$ref": "#/$defs/PublicProduct"
},
"maxItems": 30,
"title": "Products",
"type": "array"
},
"public_contacts": {
"items": {
"type": "string"
},
"maxItems": 10,
"title": "Public Contacts",
"type": "array"
},
"catalogue": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Catalogue"
},
"price_list": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Price List"
},
"certifications": {
"items": {
"type": "string"
},
"maxItems": 20,
"title": "Certifications",
"type": "array"
},
"export_markets": {
"items": {
"type": "string"
},
"maxItems": 30,
"title": "Export Markets",
"type": "array"
},
"commercial_information": {
"anyOf": [
{
"maxLength": 3000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Commercial Information"
}
},
"required": [
"company_name",
"country"
],
"title": "DraftPayload",
"type": "object"
},
"MultilingualText": {
"additionalProperties": false,
"properties": {
"original": {
"maxLength": 3000,
"minLength": 1,
"title": "Original",
"type": "string"
},
"language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$|^und$",
"title": "Language",
"type": "string"
},
"canonical": {
"anyOf": [
{
"maxLength": 3000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical"
},
"canonical_authority": {
"default": "UNKNOWN",
"enum": [
"CUSTOMER_DECLARED",
"SEMANTIC_PROPOSAL",
"UNKNOWN"
],
"title": "Canonical Authority",
"type": "string"
},
"translated_views": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 30,
"title": "Translated Views",
"type": "object"
}
},
"required": [
"original"
],
"title": "MultilingualText",
"type": "object"
},
"PublicProduct": {
"additionalProperties": false,
"properties": {
"name": {
"$ref": "#/$defs/MultilingualText"
},
"specifications": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 30,
"title": "Specifications",
"type": "object"
},
"hs_cn_code": {
"anyOf": [
{
"pattern": "^[0-9]{4,10}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hs Cn Code"
},
"certifications": {
"items": {
"type": "string"
},
"maxItems": 15,
"title": "Certifications",
"type": "array"
},
"export_markets": {
"items": {
"type": "string"
},
"maxItems": 30,
"title": "Export Markets",
"type": "array"
},
"capacity": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacity"
},
"moq": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Moq"
},
"canonical_concept_id": {
"anyOf": [
{
"pattern": "^[a-z0-9][a-z0-9._:-]{0,99}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical Concept Id"
}
},
"required": [
"name"
],
"title": "PublicProduct",
"type": "object"
}
},
"additionalProperties": false,
"title": "DraftUpdate"
}🟢request_opportunity_match(product, specification, hs_cn_code, country, certification, ...)
Filter only permitted public opportunity projections. No private/customer matching, scoring changes or autonomous research execution.
Esquema de entrada
{
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Product"
},
"specification": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Specification"
},
"hs_cn_code": {
"anyOf": [
{
"pattern": "^[0-9]{4,10}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hs Cn Code"
},
"country": {
"anyOf": [
{
"pattern": "^[A-Z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"certification": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Certification"
},
"moq": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Moq"
},
"capacity": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacity"
},
"delivery_geography": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Delivery Geography"
},
"keywords": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Keywords"
},
"limit": {
"default": 10,
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"canonical_concept_id": {
"anyOf": [
{
"pattern": "^[a-z0-9][a-z0-9._:-]{0,99}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Canonical Concept Id"
},
"preferred_language": {
"default": "en",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Preferred Language",
"type": "string"
},
"source_language": {
"default": "und",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
"title": "Source Language",
"type": "string"
}
},
"additionalProperties": false,
"title": "SearchQuery"
}🔴create_agent_conversation(text, language, client_message_id, request_key, consent, ...)
Open a private account-bound agent conversation with explicit user consent. Content is untrusted and does not verify or enroll a company.
Esquema de entrada
{
"type": "object",
"properties": {
"text": {
"maxLength": 10000,
"minLength": 1,
"title": "Text",
"type": "string"
},
"language": {
"maxLength": 35,
"title": "Language",
"type": "string"
},
"client_message_id": {
"maxLength": 100,
"minLength": 8,
"title": "Client Message Id",
"type": "string"
},
"request_key": {
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
},
"consent": {
"$ref": "#/$defs/AgentConversationConsent"
},
"represented_company": {
"anyOf": [
{
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Represented Company"
}
},
"required": [
"text",
"language",
"client_message_id",
"request_key",
"consent"
],
"$defs": {
"AgentConversationConsent": {
"additionalProperties": false,
"properties": {
"explicitly_authorized": {
"const": true,
"title": "Explicitly Authorized",
"type": "boolean"
},
"purpose": {
"const": "AGENT_CONVERSATION",
"title": "Purpose",
"type": "string"
},
"statement": {
"maxLength": 1000,
"minLength": 10,
"title": "Statement",
"type": "string"
}
},
"required": [
"explicitly_authorized",
"purpose",
"statement"
],
"title": "AgentConversationConsent",
"type": "object"
}
},
"additionalProperties": false,
"title": "AgentThreadCreate"
}🟢get_agent_conversation(thread_id)
Read only the authenticated client and customer account's own conversation.
Esquema de entrada
{
"type": "object",
"properties": {
"thread_id": {
"type": "string",
"maxLength": 36
}
},
"required": [
"thread_id"
],
"additionalProperties": false
}🟢list_agent_conversations(limit)
List bounded private conversations for this authenticated client and customer account.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"additionalProperties": false
}🔴reply_to_agent_conversation(text, language, client_message_id, revision, thread_id)
Reply in an existing account-bound conversation; no authority changes or external outreach.
Esquema de entrada
{
"type": "object",
"properties": {
"text": {
"maxLength": 10000,
"minLength": 1,
"title": "Text",
"type": "string"
},
"language": {
"maxLength": 35,
"title": "Language",
"type": "string"
},
"client_message_id": {
"maxLength": 100,
"minLength": 8,
"title": "Client Message Id",
"type": "string"
},
"revision": {
"minimum": 1,
"title": "Revision",
"type": "integer"
},
"thread_id": {
"type": "string",
"maxLength": 36
}
},
"required": [
"text",
"language",
"client_message_id",
"revision",
"thread_id"
],
"additionalProperties": false,
"title": "AgentThreadReply"
}Comunidad
Evidencia