模式语法

模式语法是一个话语模板。 该模板应包含要匹配的字词和实体，还要包含希望忽略的字词和标点。 它不是一个正则表达式 。

模式语法支持以下语法：

函数	语法	嵌套级别	示例
实体	{} - 大括号	2	窗体 {entity-name} 在哪里？
可选	[] - 方括号 可选和分组的任何组合的嵌套级别都限制为 3	2	问号是可选的 [?]
分组	() - 括号	2	是 (a | b)
或	| - 竖线（管道） 一个组中的竖线限制为 2	-	Where is form ({form-name-short} | {form-name-long} | {form-number})
话语的开头和/或结尾	^ - 脱字号	-	^开始话语 话语完成^ ^将整句话语与 {number} 实体进行严格的文本匹配^

模式中的嵌套语法

带有方括号的可选语法可以嵌套两个级别。 例如：[[this]is] a new form。 此示例允许以下话语：

嵌套的可选话语示例	说明
这是一个新窗体	匹配模式中的所有字词
是一个新窗体	匹配模式中的外层可选字词和非可选字词
一个新窗体	仅匹配必需的字词

带括号的分组语法可以嵌套两层。 例如：(({Entity1:RoleName1} | {Entity1:RoleName2} ) | {Entity2} )。 此功能允许匹配任意三个实体。

如果 Entity1 是具有起点（西雅图）和终点（开罗）等角色的位置，并且 Entity 2 是列表实体中的一座已知大楼名称 (RedWest-C)，则以下话语将映射到此模式：

嵌套的分组话语示例	说明
RedWest-C	匹配外层分组实体
Seattle	匹配内层分组实体之一
开罗	匹配内层分组实体之一

带有可选语法的组的嵌套限制

分组与可选语法组合的嵌套级别限制为 3。

允许	示例
是	( [ ( test1 | test2 ) ] | test3 )
否	( [ ( [ test1 ] | test2 ) ] | test3 )

带有 or-ing 语法的组的嵌套限制

分组与 or-ing 语法组合的竖线限制为 2。

允许	示例
是	( test1 | test2 | ( test3 | test4 ) )
否	( test1 | test2 | test3 | ( test4 | test5 ) )

用于向模式模板添加实体的语法

要向模式模板添加实体，需用花括号将实体名称括起，比如 Who does {Employee} manage?。

模式与实体
Who does {Employee} manage?

用于向模式模板添加实体和角色的语法

实体角色表示为 {entity:role}其中实体名称后接一个冒号，再接角色名称。 要向模式模板添加带角色的实体，需用花括号将实体名称和角色名称括起，比如 Book a ticket from {Location:Origin} to {Location:Destination}。

模式与实体角色
Book a ticket from {Location:Origin} to {Location:Destination}

用于向模式模板添加 pattern.any 的语法

Pattern.any 实体可用于向模式添加不同长度的实体。 只要按照模式模板操作，pattern.any 即可为任意长度。

要向模式模板添加 Pattern.any 实体，需用花括号将 Pattern.any 实体括起，比如 How much does {Booktitle} cost and what format is it available in?。

模式与 Pattern.any 实体
How much does {Booktitle} cost and what format is it available in?

模式中的书名
《偷书》的价格是多少？它适合哪种格式 ？
《询问》的价格是多少？它适合哪种格式 ？
《深夜小狗神秘事件》的价格是多少？它适合哪种格式 ？

对于 LUIS 而言，书名的字词不容易混淆，因为 LUIS 可以根据 Pattern.any 实体知道书名在哪里结尾。

显式列表

在以下情况下请通过创作 API 创建一个显式列表来允许例外：

• 你的模式包含 Pattern.any
• 并且该模式语法可能会基于话语提取不正确的实体。

例如，假设你的模式中包含可选语法 [] 和实体语法 {}，两个语法的组合方式导致数据提取错误。

请考虑使用模式“[find] email about {subject} [from {person}]”。

在下面的话语中，主题和人员实体一个提取正确，一个提取错误 ：

话语	实体	提取是否正确
email about dogs from Chris	subject=dogs person=Chris	✔
email about the man from La Mancha	subject=the man person=La Mancha	X

在上表中，主题应当是 the man from La Mancha（书名），但因为主题包含可选字词 from，因此书名没有正确预测。

要避免模式出现此异常，需使用显式列表的创作 API 添加 the man from la mancha 作为 {subject} 实体的显式列表匹配。

用于在模板话语中标记可选文本的语法

使用正则表达式方括号语法 [] 标出话语中的可选文本。 最多能对两个括号使用方括号嵌套可选文本。

模式与可选的文本	含义
[find] email about {subject} [from {person}]	find 和 from {person} 是可选的
`你可以帮我吗[?]	问号是可选的

标点符号（?、!、.）应当忽略，并且你需要在模式中使用方括号语法来忽略它们。

后续步骤

详细了解模式：

• 如何添加模式
• 如何添加 pattern.any 实体
• 模式概念

了解如何在 .json 响应中返回情绪。