为什么这很重要

问一问典型的用户,他们的 IT 或 HR 部门提供什么,你常常得到的是耸肩。服务是存在的,但没有人用用户能找到或看懂的方式描述过它们。用户去问同事,用错渠道,或者自己搭建解决方案。而提供者反过来也说不清自己提供什么、由谁负责、需要多少成本,并对自己不知道已经在支持的东西所产生的需求感到意外。

服务目录通过用用户的语言列出服务来解决这个问题,并附上用户作出决定和提出请求所需的信息:服务做什么、谁可以使用、如何请求、需要多久,以及花费多少。在这个视图的背后是一个技术视图,把每项服务与交付它的组件、团队和供应商,以及管辖它的协议联系起来。两者合在一起,把用户所见与提供者所运行的联系起来。

目录可能以两种相反的方式失败。一个空空如也、很少更新的目录会被忽视。一个臃肿、有数百项并且使用技术语言的目录则无法使用。本主题解释这两个视图、如何构建人们会用的目录,以及如何使它保持活力。它与服务请求管理(主题 3.6 — 服务请求管理)、服务级别管理(主题 3.7 — 服务级别管理)和配置管理(主题 4.4 — 配置管理)密切相关。

核心概念

Service catalogue 或 service catalog。 ITIL 使用英式拼写 “service catalogue”。本指南在首次提及之后使用“服务目录”。维基百科把服务目录(service catalog)描述为组织向其员工或客户提供的服务清单。

面向客户的视图。 以用户理解的方式描述服务,例如“电子邮件和日历”、“新员工笔记本电脑”或“薪资查询”。它说明服务是什么、谁可以使用、如何请求、预期时间、相关的成本,以及去哪里获得帮助。这是用户接触到的部分。

技术视图。 描述服务是如何构建和支持的:每项服务背后的组件、基础设施、应用、团队、供应商和协议。它帮助提供者理解依赖和影响,例如数据库出故障时哪些服务会受到影响。它与配置管理数据库有关;见主题 4.4 — 配置管理。

服务组合。 受管理的全部服务,包括正在开发的、目录中在运行的以及正在退役的。目录是组合中在运行的那一部分。维基百科关于应用组合管理(application portfolio management)的文章是针对软件的相关理念。见主题 2.8 — 产品与服务所有权。

服务产品。 对一项或多项服务的正式描述,可能带有不同的选项,如标准或高级支持。服务产品帮助用户挑选适合自己的,并帮助提供者了解需求和成本。

目录项与请求。 目录项是用户可以订购或使用的东西。如果该项可以请求,它会链接到请求模型(见主题 3.6 — 服务请求管理)。有些条目是信息性的,比如“如何连接无线网络”。

分类法与可发现性。 用户通过浏览类别或搜索来找东西。维基百科关于分类法(taxonomy)和信息架构(information architecture)的文章描述了如何组织信息。类别应当反映用户的思维方式,而不是组织的结构。一个好的检验是问用户他们会到哪里去找某个条目。

通俗语言。 描述应当简短清晰,避免行话和缩写。维基百科关于通俗语言(plain language)的文章描述了原则。让刚接触这项服务的人来测试描述。

所有权。 每项服务都有一位指定的负责人,负责维护其条目,并对其质量负责。没有负责人,条目就会衰败。见主题 2.8 — 产品与服务所有权。

目录即待办事项列表。 把目录当作一个活的产品。根据需求和反馈增加、改进、合并和淘汰条目。一份定期评审的目录改进待办事项列表(backlog)使其保持最新。这与产品待办事项列表的理念相呼应;见维基百科关于产品待办事项列表(product backlog)的文章。

成本与计费。 在对服务收费的地方,目录显示价格或成本分摊。即使不收费,显示成本也能提高认识。见主题 4.5 — 财务管理与 FinOps。

超越 IT。 许多组织把目录扩展到 HR、设施和其他职能。见主题 1.9 — 企业服务管理。

搜索与 AI。 用户越来越多地搜索或询问对话助手,而不是浏览。目录内容必须清晰且有结构,以便搜索和助手能找到它。AI 可以帮助把用户的描述匹配到目录项。

这些视角如何契合。 目录是一个持续改进的产品:根据真实的问题更新条目。AI 可以起草条目、建议类别并帮助用户找到服务,需要人工审查。自动化把目录与履行以及配置数据连接起来。分析显示什么被使用、被搜索以及被放弃。

最佳实践

  1. 从最常见的请求和问题开始。 列出用户问得最多的二十件事。先描述这些。一个小而有用的目录胜过一个大而空的目录。
  2. 用用户的语言描述每项服务。 写一个简短的概述、服务对象、如何请求、预期时间、成本,以及去哪里获得帮助。避免使用内部名称和缩写。
  3. 指定负责人和评审日期。 显示条目的负责人。至少每年评审一次每个条目,并在服务变化时评审。
  4. 按用户的思维方式组织。 与用户一起测试类别,例如卡片分类或搜索日志。当证据表明需要时,改变它们。
  5. 链接到履行。 在服务可以被请求的地方,把条目与请求表单和状态跟踪连接起来。不通向行动的目录只是宣传册。
  6. 为提供者保留技术视图。 对每项服务,记录其背后的组件、团队、供应商和协议。用它进行影响分析和规划。
  7. 显示成本和选项。 说明服务花费多少或消耗什么,并描述选项,使用户可以在掌握信息的情况下选择。
  8. 留意用户搜索什么。 评审没有结果或结果有误的搜索词,增加或重命名条目以匹配。
  9. 淘汰与合并。 移除不再提供的服务。合并近乎重复的条目。标出正在变化的服务。
  10. 把目录当作产品。 给它一位负责人、一份待办事项列表和来自用户的定期反馈。度量使用情况,并改进没人使用的部分。

与团队讨论的问题

如果新员工问我们提供什么,我们不查资料能回答吗? 这个问题检验服务是否为人所知并有描述。预期答案会不完整。请三个人各自列出清单并比较。追问:选出前十项并写下来。

我们的哪些目录项用户从不打开?哪些他们打开之后又打电话给我们? 使用数据。被打开又被放弃的条目说明描述不清楚。从未被打开的条目可能是多余的。追问:选三个条目重写或淘汰。

用户在搜索框里输入什么却得不到有用的结果? 搜索日志揭示词汇上的差异。预期会有与内部名称不匹配的日常用语。追问:为排名前五的失败搜索添加别名或新条目。

每个服务条目由谁负责?上一次检查是什么时候? 所有权缺口和过时条目很常见。询问日期。追问:指定负责人和评审周期。

我们的技术视图如何与用户所见相联系?我们能说出某个故障影响了哪些服务吗? 这个问题检验两个视图之间的联系。就最近的一次事件试一试。预期需要手工作业。追问:选择一项关键服务,梳理它的依赖。

AI 如何帮助用户找到服务、帮助我们保持条目最新?哪些必须由人检查? AI 可以把用户的描述匹配到条目,并根据工单起草更新。它也可能把用户指向错误的服务。问问谁负责它,以及如何发现不匹配。追问:用一批真实问题的样本测试匹配器。

实践:一个服务管理示例

一家国家税务机关的内部 IT 部门有一个包含 340 个条目的服务目录,大多由构建这些服务的工程师编写。员工使用服务台的电话,服务台把大量时间花在把来电者指向已经存在的服务上。

服务经理请来自不同部门的十五位员工在目录中找五样东西:预订视频会议室的方式、如何领取第二块显示器、如何加入项目邮件列表、如何获取案件系统的访问权限,以及如何报告手机丢失。只有两项成功。目录使用的是“视听会议端点配置”和“外围设备”之类的词。

团队评审了六个月的服务台联系记录,并对排名前 30 的请求主题进行了排序。他们用通俗语言重写了这些条目,附上简短描述、谁可以请求、需要多久,以及表单的链接。他们把 90 个条目合并为 40 个,淘汰了 60 个不再提供的条目,并为搜索增加别名,比如把“第二块屏幕”对应显示器。每个条目都显示负责人和评审日期。他们还试用了一个对话助手来把用户指向条目,无法回答时提供联系真人的链接。

变化在于:同一个测试小组现在能找到五项中的四项,服务台“我在哪里能找到”类联系减少了。仍然困难的是:技术视图不完整,所以影响分析仍然依赖口口相传的经验;其余 240 个条目尚未评审;一些服务的负责人说他们没有时间保持条目最新。经理制定了一条规则:一年内未经评审的条目会被标记为“未经核实”,并在搜索中降低排序。

四种视角

产品与交付团队

为用户描述你们所构建的服务,并在变更时保持条目最新。提供把你们的组件与它们所支持的服务联系起来的技术信息。

服务与运维团队

维护技术视图,并在事件和变更中使用它。留意用户搜索和询问什么,并把缺口反馈给负责人。帮助保持履行链接可用。

领导层与治理

要求一个用户觉得有用的目录,带有负责人和评审日期。为它的维护出资。用它来了解提供什么、花费多少以及哪些正在退役。

客户与用户

你应当能够找到有什么可用,理解它,并在不了解组织架构图的情况下请求它。告诉提供者你找不到或看不懂的地方。

敏捷、AI、自动化与分析

敏捷

把目录当作待办事项列表:先改进最常用的条目,小步进行,并听取用户的反馈。与干系人定期评审。注意:不要在上线之前就构建整个目录;一个小而有用的开端会教给你更多。

AI

AI 可以根据现有文档起草条目,建议类别和别名,并在对话中帮助用户找到服务。每种用法都需要负责人,已发布的文本应由人批准。注意:猜测一个不存在的条目的助手会误导用户;要求它引用目录条目。见主题 5.3 — AI 服务台与虚拟代理。

自动化

把目录与请求表单、审批和履行连接起来,并根据配置数据生成技术视图的部分内容。注意:自动导入技术数据可能使目录充斥着机器名称;对面向用户的文本保留人工编辑环节。见主题 6.5 — 自助服务与自动化履行。

分析

跟踪浏览次数、搜索、无结果的搜索、提出的请求和被放弃的请求。注意:受欢迎不等于有价值;一个很少使用的条目可能对少数人至关重要。把计数与反馈结合起来。见主题 7.7 — 体验与情感分析和《服务管理度量》一书。

常见失败模式

  • 工程师写的目录。 用户看不懂。用通俗语言重写并测试。
  • 条目太多。 没人能找到任何东西。从小处开始,然后合并和淘汰。
  • 没有负责人。 条目衰败。指定负责人和评审日期。
  • 只是宣传册。 目录不通向行动。把条目链接到表单和状态。
  • 按组织架构分类。 用户猜不到该去哪里找。按用户意图组织。
  • 没有技术视图。 影响分析靠猜测。为关键服务梳理依赖。
  • 从不淘汰。 死条目误导人。评审并移除。

成熟度模型

维度 起步 发展 标准化 管理 协同
面向用户的视图 没有或只有技术性的 描述了主要服务 服务以通俗语言描述并有负责人 与用户一起测试和评审条目 条目在各职能和渠道之间保持一致
技术视图 未记录 梳理了主要服务 记录了重要服务的依赖 用于事件和变更 根据配置数据生成并保持最新
可发现性 仅浏览 有一些搜索 与用户一起测试搜索和类别 搜索日志驱动改变 搜索和助手在各渠道集成
维护 无 偶尔 有负责人和评审日期 度量使用情况和质量 根据反馈持续改进

检查清单

  • 最常见的二十个请求和问题都在目录中。
  • 每个条目都用通俗语言写成,说明谁、如何、多久和成本。
  • 每个条目都有负责人和评审日期。
  • 类别已与用户一起测试。
  • 可请求的条目链接到表单和状态。
  • 技术视图涵盖我们的关键服务。
  • 我们评审失败的搜索和被放弃的条目。
  • 我们定期淘汰或合并条目。

AI 提示词

根据笔记起草目录条目。

这是关于服务 [名称] 的笔记:[粘贴,包括它做什么、谁可以使用、如何请求、需要多久、成本]。
请起草一个不超过 120 字的通俗语言目录条目,包含一行概述、服务对象、如何请求和预期时间。笔记中的每个缺口都标注为 [缺失],不要补充。
请列出你不确定的事项。

找出词汇上的缺口。

这是用户输入但没有得到有用结果的搜索词:[粘贴列表]。这是我们当前的目录条目标题:[粘贴列表]。
请针对每个搜索词,列出可能匹配的条目标题,或写“无匹配”,并建议一个可能的别名或新条目。不要编造我没有列为可能的条目。
请列出你不确定的事项。

测试类别。

这是目录项清单:[粘贴]。这是我们拟议的类别结构:[粘贴]。
请针对每个条目,说明典型用户最可能到哪个类别中去找以及原因,并列出可以合理地放在两处的条目。只使用所提供的内容。
请列出你不确定的事项。

AI 技能

主要来源

  • PeopleCert, ITIL certification pages:所有者对服务目录管理的描述。
  • Wikipedia, "Service catalog":对这一概念的简短概述。
  • Wikipedia, "Information architecture":为用户组织信息的学科。
  • Wikipedia, "Plain language":清晰写作的原则。

参考文献

  1. Service catalog — Wikipedia — https://en.wikipedia.org/wiki/Service_catalog
  2. Application portfolio management — Wikipedia — https://en.wikipedia.org/wiki/Application_portfolio_management
  3. Taxonomy — Wikipedia — https://en.wikipedia.org/wiki/Taxonomy
  4. Information architecture — Wikipedia — https://en.wikipedia.org/wiki/Information_architecture
  5. Plain language — Wikipedia — https://en.wikipedia.org/wiki/Plain_language
  6. Configuration management database — Wikipedia — https://en.wikipedia.org/wiki/Configuration_management_database
  7. Product backlog — Wikipedia — https://en.wikipedia.org/wiki/Product_backlog
  8. Self-service — Wikipedia — https://en.wikipedia.org/wiki/Self-service
  9. Search engine — Wikipedia — https://en.wikipedia.org/wiki/Search_engine
  10. Product management — Wikipedia — https://en.wikipedia.org/wiki/Product_management