Lenguaje de intención IDL de NlpCraft

Este artículo es una continuación del artículo " Diseño de intenciones con Apache NlpCraft " y contiene una descripción detallada de las capacidades del lenguaje de definición de intenciones IDL de NlpCraft, creado para su uso en proyectos NLP basados ​​en el sistema Apache NlpCraft . La compatibilidad con NlpCraft IDL se ha agregado al sistema desde la versión 0.7.5 .   

La nueva versión del lenguaje de definición de intenciones declarativas, llamado NlpCraft IDL (NlpCraft Intents Definition Language), simplificó enormemente el proceso de trabajar con intenciones en motores de diálogo y búsqueda construidos sobre la base del proyecto Apache NlpCraft y al mismo tiempo expandió las capacidades del sistema.  

NlpCraft IDL es un lenguaje declarativo que le permite crear definiciones de intención para usar en modelos Apache NlpCraft.

Comencemos con ejemplos que demuestren las capacidades generales del lenguaje, proporcionemos las explicaciones necesarias y luego describamos las construcciones del lenguaje de manera un poco más formal. 

, , NLP , .

, NlpCraft IDL

intent=xa
    flow="^(?:login)(^:logout)*$"
    meta={'enabled': true}
    term(a)={!(tok_id()) != "z"}[1,3]
    term(b)={
        meta_intent('enabled') == true &&
        month() == 1
    } 
    term(c)~{
        @tokId = tok_id()
        @usrTypes = meta_model('user_types')

        (tokId == 'order' || tokId == 'order_cancel') &&   
         has_all(@usrTypes, list(1, 2, 3) &&
         abs(meta_tok('order:size')) > 10
        )
   } 
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

:

• - “xa”. 

  
  
  
  
  

• terms. Term - , , .

  
  
  
  
  

  • (a) - “z”,  ( term =) . 

    
    
    
    
    

  • (b) - -  ”enabled” . , - month().

    
    
    
    
    

  • (c) - ( term ~) “order” “order_cancel”. , . , . 

    
    
    
    
    

• Flow. , , “login”, “logout”. , . .     

  
  
  
  
  

• Meta. , , .

  
  
  
  
  

intent=xb
    flow=/#flowModelMethod/
    ordered=true
    term(a)=/org.mypackage.MyClass#termMethod/?
    fragment(frag)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

:  

• - “xb”. 

  
  
  
  
  

• term (”a”, , “?“, ), -  org.mypackage.MyClass#termMethod. 

  
  
  
  
  

• Fragment “frag” terms ,  , terms. “frag” import.

  
  
  
  
  

• Flow , flowModelMethod.

  
  
  
  
  

- .  

. 

, NlpCraft IDL . .

• , NlpCraft IDL   . . . 

  
  
  
  
  

• . .  

  
  
  
  
  

• , . URL import. , IDE (, , Intellij Idea , ). , . : 1, 2.  

  
  
  
  
  

NlpCraft IDL

flow, fragment, import, intent, meta, ordered, term, true, false, null.

• intent, flow, fragment, meta, ordered, term - . 

  
  
  
  
  

• fragment terms, . 

  
  
  
  
  

• import - fragment, intent import.

  
  
  
  
  

• true, false, null - , .

  
  
  
  
  

NlpCraft IDL

, :

• import

  
  
  
  
  

• fragment

  
  
  
  
  

• intent

  
  
  
  
  

. , IDE . import fragment .  

“import” URL .

: import('http://mysite.com/nlp/idls/external.idl)

“fragment” terms. Terms . 

fragment:

fragment=buzz term~{tok_id() == 'x:alarm'}

fragment c ‘a’ ‘b’:

fragment=p1
    term={
        meta_frag('a') &&
        has_any(get(meta_frag('b'), ''), list(1, 2))
    }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

fragment . ‘a’ ‘b’ . 

intent=i1
    fragment(p1, {'a': true, 'b': {'': [1, 2, 3]}})
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

. - , . "timeIntent". 

@NCIntentRef("timeIntent")
fun onTimeMatch(
    ctx: NCIntentMatch, 
    @NCIntentTerm("t1") tok: NCToken
): NCResult { ... }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

terms

. Term - . term , term. - . 

term:

• term. .

  
  
  
  
  

• . . , , “t1”.

  
  
  
  
  

• term. . term: 

  
  
  
  
  

  • “~“ - .

    
    
    
    
    

  • “=“ - .  

    
    
    
    
    

  : term(nums)~{tok_id() == 'nlpcraft:num'}
  
  
  
  

  
  
  
  
  

  term terms , . 

  
  
  
  
  

• term. . term: . 

  
  
  
  
  

  :

  
  
  
  
  

  • term(nums)={tok_id() == 'nlpcraft:num'}
    
    
    
    

    
    
    
    
    

  • term(nums)~{true}
    
    
    
    

    
    
    
    
    

  • term~/org.mypackage.MyClass#termMethod/?
    
    
    
    

    
    
    
    
    

  term. 

  
  
  
  
  

• . . : 

  
  
  
  
  

  • [M, N] - N M .

    
    
    
    
    

  • * - , [0, ∞]

    
    
    
    
    

  • + - , [1, ∞]

    
    
    
    
    

  • ? - 0 1 , [0, 1]

    
    
    
    
    

  :

  
  
  
  
  

  • term(nums)={tok_id() == 'nlpcraft:num'}[1,2]
    
    
    
    - “nlpcraft:num”.

    
    
    
    
    

  • term(nums)={tok_id() == 'nlpcraft:num'}*
    
    
    
    - “nlpcraft:num”.

    
    
    
    
    

NlpCraft IDL. 

:

• - , . : tok_id(), tok_groups(), tok_parent().

  
  
  
  
  

• NLP - , , , -. : tok_lemma(), tok_is_wordnet(), tok_swear().

  
  
  
  
  

• , - ..  : tok_value(), tok_is_permutated(), tok_is_direct().

  
  
  
  
  

• - , user agent. : req_tstamp(), req_addr(), req_agent().

  
  
  
  
  

• - , , ..  : meta_model('my:prop'), meta_tok('nlpcraft:num:unit'), meta_user('my:prop').

  
  
  
  
  

• , NER . , “geo:city“ ,  . 

  
  
  
  
  

• - , . : user_admin(), comp_name(), user_signup_tstamp().

  
  
  
  
  

• - , .. : meta_sys('java.home'), now(), day_of_week().

  
  
  
  
  

• , , .. : lowercase("TeXt"), abs(-1.5), distinct(list(1, 2, 2, 3, 1)).

  
  
  
  
  

- . 

term - , . 

, , :

term(t2)={
    @a = meta_model('a')
    @list = list(1, 2, 3, 4)

    (@a == 42 || @a == 44) && has_all(@list, list(3, 2))
}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

@. . 

, NlpCraft IDL term . java, scala, kotlin, groovy java based term. NlpCraft IDL , .    

: term(a)=/MyClass#myMethod/

, , .

Fragment

Fragment terms, . . 

Flow

, . 

regex, .  

: flow="^(?:login)(^:logout)*$"



 

, , “login”, “logout”. 

, , Java-based , term. 

: 

@NCIntent("intent=x 
    flow=/com.company.dialog.Flow#customFlow/ 
    term~{tok_id() == 'some_id'}"
)
def onX(): NCResult = { .. }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

, customFlow(), , , boolean. 

Meta

. JSON.

Ordered flag

. false. - terms .  

, , NlpCraft IDL, java based . ? , , - . 

NlpCraft IDL.

• . DSL . . 

  
  
  
  
  

• NlpCraft IDL , IDL , , .

  
  
  
  
  

• . . , DSL .  

  
  
  
  
  

• java based . Apache NlpCraft . NlpCraft IDL .

  
  
  
  
  

Espero que haya podido hacerse una primera idea de las capacidades del lenguaje de intenciones IDL de NlpCraft y los tipos de problemas que se pueden resolver con su ayuda. Aquí encontrará una descripción detallada del idioma y sus capacidades. En el proyecto github están disponibles ejemplos adicionales de modelos creados en java, kotlin, groovy y scala, usando NlpCraft IDL para definir intenciones .