用途：Cala 是面向 AI 智能体的知识层，提供公开数据知识图谱，包含命名实体、属性、关系以及带时间戳的观测值（融资、宏观指标、汇率、定位等），每个值都带来源与日期，用于查询而非抓取网页。
接入方式：优先使用 MCP，连接 https://api.cala.ai/mcp/ 并携带 API 密钥后直接调用工具；若上下文中没有 Cala 工具，说明服务器未配置，应停止并引导用户访问 https://docs.cala.ai/integrations/mcp。备用 REST：基址 https://api.cala.ai/v1，请求头 X-API-KEY: <key>，端点与工具名一一对应，规范见 https://api.cala.ai/openapi.json，密钥申请见 https://console.cala.ai/api-keys。
工具选择：过滤、列出或“找出所有满足 Y 的 X”用 knowledge_query；开放式“是什么、是谁、解释”用 knowledge_search；有名称要实体 UUID 用 entity_search；有 UUID 要粗略档案用 entity_retrieval（无 body）；有 UUID 不知可查什么用 entity_introspection；有 UUID 要特定字段、关系或指标则先 entity_introspection 再 entity_retrieval。结构化路径更省 token 且更可预测。
knowledge_query 查询语言：点号表示图中一跳，如 OpenAI.founded.year。操作符有 =、!=、>、<、<=、>=，逗号表示同一字段的 AND（investors=Sequoia Capital,Andreessen Horowitz 表示同时被两者投资）。修饰符按子句顺序为过滤、order_by、limit、return()，例：startups.location=Spain.funding>10M.order_by=funding DESC.limit=5.return(name, funding, sector)。数值字段可能返回近似字符串（如“over 100M”），应作综合理解而非精确值。
实体读取：entity_search 把名称模糊解析为 UUID（含名称、类型、描述）；entity_retrieval 有两种模式，无 body 返回默认属性的粗略档案，投影模式指定具体属性、关系和数值观测，是获取关系与时间序列的唯一方式。关系为 UPPER_SNAKE 类型且有方向，具体可用边以 entity_introspection 为准，先内省再投影。
knowledge_search：面向开放式问题，返回 markdown 内容与来源链，explainability 中的声明通过 references 映射到 context 的文档 URL 与发布者，可据此引用。
限制与失败处理：任何失败都应停止并如实告知，不得回退到网页搜索或模型记忆。不可达时指向密钥与 MCP 文档；超时（最长可 180 秒）可重试一次后停止并建议调高客户端超时；无数据需区分空结果与过于复杂；HTTP 429 应停止，不重试。