You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nlpcraft.apache.org by ar...@apache.org on 2021/06/04 01:13:29 UTC

[incubator-nlpcraft-website] branch master updated: WIP.

This is an automated email from the ASF dual-hosted git repository.

aradzinski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-nlpcraft-website.git


The following commit(s) were added to refs/heads/master by this push:
     new 275581d  WIP.
275581d is described below

commit 275581dd7b4f1591643cdf89364ea950710598ba
Author: Aaron Radzinski <ar...@apache.org>
AuthorDate: Thu Jun 3 18:13:21 2021 -0700

    WIP.
---
 _data/blogs.yaml                                   |  4 +++-
 _data/news.yml                                     |  2 +-
 blogs/nlpcraft-idl-intent-definition-language.html | 12 ++++++++++++
 intent-matching.html                               |  6 ++++--
 4 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/_data/blogs.yaml b/_data/blogs.yaml
index 3995b05..716190e 100644
--- a/_data/blogs.yaml
+++ b/_data/blogs.yaml
@@ -17,7 +17,9 @@
 
 - title: NLPCraft IDL - Intent Definition Language
   url: /blogs/nlpcraft-idl-intent-definition-language.html
-  excerpt: Most of the NLP tasks start with the basic challenge - how to find or detect something in the text...
+  excerpt: The declarative Intent Definition Language, called NLPCraft IDL, significantly simplifies the process of
+    working with intents in NLP-based dialog and search systems developed using Apache NLPsCraft and at the same time
+    expands the capabilities of them.
   author: Aaron Radzinski
   publish_date: June 3, 2021
   avatar_url: images/lion.jpg
diff --git a/_data/news.yml b/_data/news.yml
index e49df15..ad8c430 100644
--- a/_data/news.yml
+++ b/_data/news.yml
@@ -17,7 +17,7 @@
 
 - title: NLPCraft IDL - Intent Definition Language
   url: /blogs/nlpcraft-idl-intent-definition-language.html
-  excerpt: Most of the NLP tasks start with the basic challenge - how to find or detect something in the text...
+  excerpt: The declarative NLPCraft IDL significantly simplifies the process of working with intents in NLP-based dialog and search systems...
   author: Aaron Radzinski
   publish_date: June 3, 2021
   avatar_url: images/lion.jpg
diff --git a/blogs/nlpcraft-idl-intent-definition-language.html b/blogs/nlpcraft-idl-intent-definition-language.html
index 4b1a34d..ce6c929 100644
--- a/blogs/nlpcraft-idl-intent-definition-language.html
+++ b/blogs/nlpcraft-idl-intent-definition-language.html
@@ -148,6 +148,18 @@ publish_date: June 3, 2021
             of the <a href="https://nlpcraft.apache.org/intent-matching.html">documentation</a>.
         </p>
     </div>
+    <h2 class="section-sub-title">The Places Where Intents Are Defined <a href="#"><i class="top-link fas fa-fw fa-angle-double-up"></i></a></h2>
+    <ul>
+        <li>
+            Intents defined with NLPCraft IDL can be declared directly in static model definition JSON or YAML files.
+            This approach is very convenient for simple cases. An example is available <a target=github href="https://github.com/apache/incubator-nlpcraft/blob/master/nlpcraft-examples/lightswitch/src/main/resources/lightswitch_model.yaml">here</a>.
+        </li>
+        <li>
+            Intents can also be defined directly in the model code using <a target="javadoc" href="https://nlpcraft.apache.org/apis/latest/org/apache/nlpcraft/model/NCIntent.html">@NCIntent</a>
+            annotations. An example can be found <a target="github" href="https://github.com/apache/incubator-nlpcraft/blob/master/nlpcraft-examples/time/src/main/java/org/apache/nlpcraft/examples/time/TimeModel.java">here</a>.
+        </li>
+        <li>In addition, intents can be defined in separate special files (usually with *.idl extension). In this case, the model will refer to these intents according to the specified path to these files or URL resources using the import statement. This approach is convenient when working with large models, when syntax highlighting and other features provided by the IDE may be useful (for example, Intellij Idea provides keyword highlighting, hints and syntax checking for files for the c [...]
+    </ul>
 </section>
 
 
diff --git a/intent-matching.html b/intent-matching.html
index a326712..6940ed3 100644
--- a/intent-matching.html
+++ b/intent-matching.html
@@ -59,10 +59,12 @@ id: intent_matching
         <p>
             NLPCraft intents are written in Intent Definition Language (IDL).
             IDL is a relatively straightforward and simple language. For example,
-            here's a simple intent with two terms:
+            here's a simple intent <code>x</code> with two terms <code>a</code> and <code>b</code>:
         </p>
         <pre class="brush: idl">
-            intent=x term(a)~{tok_id() == 'my_elm'} term(b)={has(tok_groups(), "my_group")}
+            intent=x
+                term(a)~{tok_id() == 'my_elm'}
+                term(b)={has(tok_groups(), "my_group")}
         </pre>
         <p>
             IDL intent defines a match between the parsed input utterance, i.e. the collection of