User Assistant Agent User Manual
Contents
1. a context in which knowledge will be displayed in a future O By System 2006 08 10 0 0 On the screenshot K Wf Grid portal GUI with User Assistant Agent UAA portlet marked in red square is visible Scenarios and screenshots in chapter 3 show only UAA part of K Wf Grid portal GUI 2 1 RUNNING THE SOFTWARE 2 1 1 Operating Requirements UAA is connected with several K Wf Grid components To exploit all UAA features K Wf Grid portal Grid organization Memory GOM and Grid Workflow Execution Service GWES need to be in operation It can be run on same machine as other components or on single computer UAA can be set up also as independent EMBET component in other applications 2 1 1 1 Local hardware requirements No special hardware requirements are defined UAA is created as regular Java application 2 1 1 2 Local software requirements EMBET UAA software needs several Java libraries such as log4j or Jena Semantic Web Toolkit libraries UAA Core is build as standalone Java application UAA GUI is build as Servlet application called from UAA portlet which is part of K Wf Grid portal UAA Core requires Java 1 4 or higher and Ant UAA GUI requires Tomcat or other Servlet container If UAA Core and UAA GUI are on different machines port for its communication needs to be open By default UAA Core use port 8000 for XML RPC procedure calling 2 1 1 3 Grid infrastructure requirements UAA Core imports K2. Result and Workflow Notes 1 2 REFERENCES AND SOURCE CODE The full source of EMBET and EMBET GUI presented in this document are available on K Wf Grid s central CVS repository The JavaDoc documentation can be build out of source code using ant build file KWEF WP5 DS5 IISAS PUBLIC 5 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 2 SOFTWARE USAGE Software usage is described in this chapter as well as in chapter 3 where GUI screenshots with examples are provided For more information on technical details please see developer manual WA Logout Cay K W Gr 7 d Welcome Ondrej Habala Welcome if Grid Wf G Collaboration lf DG AP if Monitoring and Analysis Workflows Workflow Applet User Assistant gt User Ondrej Habala HS8 atus User Help Resource gt davetPrmoperties DaveF Properties 2Da veF 2D VisualizationPrmpertiesRetu Info amp Knowledge Add Cn a By clicking on Define Problem you can a specify your problem using plain text properties properties i which will be translated to formalized elements of aplication description i eea 2 z a ee Ti 7 By clicking on Add Knowledge you can i N a f x N i fi f type new knowledge gathered which can be useful for you or other users in a future You will be prompted with application specific formalized elements which can be assigned to knowledge as
3. 1385 https portal ui sav sk Approve note context Check and submit relevant context for note Current User Context Nitra Stream Nitra Settlement s lt s DaveF 2D Visualization ServicetVizualizationService Context Detected from text of note Bratislavai Note Bratislavat Settlement MMS Visualization ServicetVizualizationService BratislavalCapital MIMS Meteralo servicelMeterclogyService LI d d d LI m Aladin Meterolo Service Meterology Service Done portal ui sav sk 0 Figure 2 Note Context Detection Consider that the user has used the MM5 meteorology model and he she wants to describe its properties gathered knowledge which may be relevant for other users The proposed model of interaction is as follows A user enters a note through UAA stating that the MM5 model is not appropriate for weather forecast in September for Bratislava area Figure 1 From the workflow in which the user states this note we know directly the current user context checked items on Figure 2 Some of current context can be relevant to note and some does not have to be The note is processed and its text related to the context as well as the relevant context items are found in the ontology memory GOM Figure 2 In this case by finding the text MM5 we can assume that MM5 Meteorology Service is the relevant part of the context There is other context relevant information which can be de
4. Wf Grid Ontologies from GOM 2 1 2 Step by Step User Setup KWF WP5 D5 IISAS PUBLIC 6 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 UAA EMBET core can be executed using ant build script ant start and UAA EMBET GUI can be installed to tomcat using ant install in webapps directory of the distribution 2 2 BASIC OPERATION In this chapter we provide list of basic features To understand this features in practice see chapter 3 for more details on use case scenarios To display the basic help of the UAA EMBET click on icon This help can be extended by users using Add note in help context To define your problem for workflow composition or to return relevant knowledge in form of notes workflows or results you need to describe your problem by free text Click on Define problem to type your text description To add new knowledge in form of notes click on Add Knowledge to type your note By clicking on close GJ icon under displayed note you can close the note to be not displayed for you in the future By clicking on face icon you can vote good or bad on note relevance This will have influence on note order By clicking on icon you can post message for the note author to start discussion and collaboration By clicking on you can do an action on an associated resource context or note like to start workflow composition submit and reuse past workflows or view p
5. ast results of workflow execution See scenarios for more details 2 3 ADVANCED FEATURES In this chapter we provide list of advanced features To understand this features in practice see chapter 3 for more details on use case scenarios By clicking on save you can save current memory knowledge to Ontology Memory GOM In case of crash of the system or restart the knowledge would be lost if not saved Saving is not done automatically due to use of Jena memory model because Jena MySQL backend it is too slow for real and fast interaction By clicking on icon you can execute KAA WXA tool to start analyzing past workflows The result of analysis is new automatically generated knowledge notes related to past workflows and results of workflow execution 2 4 KNOWN PROBLEMS Reimplementation of Annotation algorithm is needed because now it is case sensitive which match only some results Reimplementation of Context matching algorithm is needed since similarity of context is not supported This will have influence on voting and note knowledge ordering mechanism KWEF WP5 DS5 IISAS PUBLIC 7 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 3 INTERFACE REFERENCE GUIDE To better illustrate the use of UAA in the process of user assistance we present the following example from the K Wf Grid project s flood forecasting application which extends the flood prediction application of the CROSSGRID project The ap
6. din K WE Grid USER ASSISTANT AGENT USER MANUAL WP5 Document Filename KWF WP5 UAA IISAS v1 0 SoftwareUserManual Work package WP5 Partner s II SAS Lead Partner II SAS Document classification PUBLIC Abstract This document This document provides a user manual for User Assistant Agent UAA K WfGrid component Information Society Technologies KWF WP5 D5 IISAS PUBLIC 1 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 Delivery Slip From Michal Laclavik IISAS 28 09 2006 Verified by Piotr Nowakowski CYFRONET 11 10 2006 Approved by Steffen Unger FIRST 11 10 2006 Document Log 29 Nov 05 Draft version Michal Laclavik 22 Dec 05 Updated Da a nets ms Michal Laclavik recommendation from internal review 0 3 30 Aug 06 Final software user manual Michal Laclavik 0 4 03 Oct 06 Final software user manual update Michal Laclavik 1 0 11 Oct 06 QA check Piotr Nowakowski KWEF WP5 DS5 IISAS UAAUserManual PUBLIC 2 15 K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 CONTENTS OP RG NE o E E 4 DN TO PIN aa cssccesteeece cece cncceatccecasnccseseeaeesasesaccsescesccsscanesscdcaaceoeteaassescecccesssusessencueseessasssseiesseaeeaeieawsseences 5 1 1 ABBREVIATIONS AND ACRONYMS ccccscosccsceccecceccsccsceccecceccscsececceccecsscescsccecscescesceccecesceseeccecceceesesescescess 5 1 2 REFERENCES AND SOURCE CODE cscccscccscc
7. e in new browser window Result notes are automatically generated by KAA WXA tool See more details on KAA WXA tool in KAA manuals KWEF WP5 DS5 IISAS PUBLIC 12 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 4 TROUBLESHOOTING Q amp A Q How do I show general Help A By clicking on icon you can display general help Q How I install UAA EMBET GUI A It is part of K Wf Grid portal one of portlets You need also to install Servlet application under embet path in tomcat Q When I log to portal UAA seems to be not working A It can be that you are not in ontology as a user Please send email to laclavik ui savba sk KWEF WP5 DS5 IISAS PUBLIC 13 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 5 CONTACT INFORMATION AND CREDITS Michal Laclavik e Author of EMBET architecture e Core implementation e Memory implementation amp integration with GOM e 2 version of GUI implementation e Ontea Semantic based annotation Email laclavik ui savba sk Web http laclavik net Emil Gatial e Author of First GUI implementation e Reloading of GUI using AJAX technologies e First implementation of annotation algorithm e consultations Email emil gatial savba sk Zoltan Balogh e GUI related and other consultations Martin Seleng e Semantic Annotation Ontea success rate measuring and evaluation Martin Maliska Branislan Simo e Java programming and re
8. ee text explanation of a user problem Figure 3 Such free text is then annotated by Anotate class and detected elements are presented to the user to confirm detected user context https portal ui sav sk Add problem form Mo Sle Enter text description of your current problem ProblemID problem 156944000496 flood and weather prediction for Bratislava in September Done portal uisav sk 4 Figure 3 Problem Definition UAA Window Free text problem definition is important when a user starts to work with the system and wants to define problem to be understandable for computer System UAA then can return relevant experience for such problem Free text problem definition is important also because such problem definition discovers appropriate web services and data for construction of Workflow of Services KWEF WP5 DS5 IISAS PUBLIC 10 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 https portal ui sav sk Approve problem conte Sek Check and submit context describing your problem Current User Context Nitra Stream Mitral Settlement k E E DaverF 2D Visualization ServicetVizualizationService Context Detected from text problem description Bratislava Settlement Bratislava Capital Aladin Meterolo SeryicelMeterclogyService DaveF Hydraulics HydraulicsService Bratislavathote DaweF 2D Visualization ServicetVizualizationService MMS Visualization Serviced izua
9. esesseaaeees Il 3 1 4 Initializing Red Workflow SCCNAT ION cccssccccccccce eee eeeeeeeeeeee eee eeeeeeeeeeeeeaaaeeeeeeeeeeaaaaeeseeeeeeesaaaaseeeeeeaaaaaees 12 3 1 5 Initializing of Past Workflows cccccccccccsseeeeceecceee ee eeeeeeeeeeee aa eeeeeeeeeeeaaaeeeeeeeeeeeaaaaeseeeeeessaaaaaseseeeesaaaaaees 12 3 1 6 Displaying the Results of Workflow EX CULION cccccccccccs se eeescecceeece ae eeeeeeceeeeaaaeseeeeeeesaaaaseeeeeeeeeeaaaees 12 A TROUBLESHOOTING CGA sssaicabaatissansassstetaseicsectuascaticetnivutstaveabasbansasencevsiscoboestesesssassistasoiseestisiastiasviousseans 13 5 CONTACT INFORMATION AND CREDITS 2 0 ccsccccsccccccccccccccccccccccccccccccccccccccccccccccccccccccccecs 14 OG THELICENSEAGREEMEN T cosasnin a E a a Naai 15 KWF WP5 D5 ISAS O SC PUBLIG SSS 3 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 COPYRIGHT NOTICE Copyright c 2005 2006 by Institute of Informatics Slovak Academy of Sciences amp K Wf Grid consortium All rights reserved Use of this product is subject to the terms and licenses stated in the GPL license agreement Please refer to Section 5 for details This research is partly funded by the European Commission ST 2002 511385 Project K WfGrid KWEF WP5 DS5 IISAS PUBLIC 4 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 1 INTRODUCTION The main role of User Assistant Agent UAA is to a
10. lated consultations Ondrej Habala Ladislav Hluchy e General consultations e Thanks for pushing to work on UAA Bartek Kryza Marian Babik Jacek Kitowski e Ontology Knowledge description semantic web consultations e GOM integration K Wf Grid amp Pellucid Project Consortium e Ideas e Evaluations e Consultations KWEFEF WP5 DS5 IISAS PUBLIC 14 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 6 THE LICENSE AGREEMENT GPL License See http www gnu org licenses gpl txt for more details KWEF WP5 DS5 IISAS PUBLIC 15 15 UAAUserManual
11. lizationService DaweF 3D Visualization Service VizualizationService MMS Meteralo servicelMeterclogyService Done portal uisav sk H OOOO JOO o Figure 4 Problem Context Detection A workflow is constructed and executed by other K Wf Grid components but those components use detected ontology elements web services MM5 service Aladin DaveF and output data definitions Bratislava Location September to compose an appropriate workflow When s user selects relevant problem context and submits it event a user context change is generated and UAA executes context updating algorithm Similar as in Note adding scenario user can click on ontology elements in context list to get help notes in UAA GUI 3 1 3 Context Matching and Notes Display Scenario When context of an actor user is changed as showed in previous scenario note updating algorithm is executed and relevant notes are assigned to the user model The Notes are then displayed to the user as can be seen on Figure 5 Some of the notes have clickable gt sign This means Some resource 1s attached to the note This can be document URI a result file of a workflow execution or past workflow which can be initiated again by clicking on the icon KWEF WP5 DS5 IISAS PUBLIC 11 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 User Assistant User Michal Laclayvik a ie g User Context Define Problem Nitra Stream Nitra Settlement Da
12. plication s main core consists of simulation models series for meteorological hydrological and hydraulic predictions The models are organized in a cascade with each step of the cascade being able to employ more than one model For example the first step the meteorological weather prediction can be computed using the ALADIN model or the MMS model 3 1 1 Note Adding Scenario This scenario describes how Note experience representation is born in UAA system On Figure Note adding window can be seen When such note is confirmed UAA annotate Note and detect ontology elements showed in Figure 2 https portal ui sav sk Add note form Mozill Sele Enter observed experience or note NoteID jnotel 156944502256 the MM5 model is not appropriate for weather forecast in September for Bratislava area Done portal ui sav sk 4 Figurel Entering new Note UAA Window On Figure 2 results of context detection can be seen Checked items are current user context unchecked items are elements detected from text of the note A user selects only relevant items and submits the note context Please note that ontology items detected from text are clickable By clicking on any item UAA EMBET window will show relevant help Notes on the item This will help user to understand what kind of objects were detected and what they represents KWEF WP5 DS5 IISAS PUBLIC 8 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 51
13. ssccscccsccscccsscecccsscescceccesccessceccesscesccccesscesscscesscessesscesscescenecs 5 OC WN A USAGE rps vi cece casce ec cane EEE A EA 6 2 1 RUNNING THE SOFTWARE wu occ c cee cceceeccceccscccsccccccscccsccuccesccescesscesccescescesccesccscesscuscescesccescesscesceuseenseuecs 6 sedadle CHAI I COUN CTI CTI ssion RE O E A E 6 2 Akal Local hardware Te GU IFS menis seesinane e Ei ra r eE EAO aE 6 2 1 1 2 Local s ftwar requirements vxacesizsnictoszaesmusaatavadeaivercadeauoradeainey sncastavidenvercadaserveabaxsaabvetiactenoddocebnndaaaeebionnebteees 6 2 11 3 Grid intrastr cture requiremieNiS scccatetcacccrentaivancisatharncstateuitesdutunsiadiarediadiacestbotemdsaeniarsienceultuiettateobisadeioucieaeneies 6 PA E A E E E T ETE A E E A EO TA TT E 6 POA BA A TAT a E E A E ENE E E A E E f ZADANO 2 1 ll 57 0 Ol occ a a E A E E ee AEE AAE EE 7 Do Pr FRON NAPOL EM eer E E E E E A AEE EE 7 3 INTERFACE REFERENCE GUIDE esesscsesecsesesecseseccccesccscsecccsesesecsesccsesesecsessecesecseseoscseseosesessosesescscosesesees 8 3 1 1 Note Adding SCCNATIOL ccccccccccsseeeeccccccec eee aneeeeeeeeee ena eeeeeeeeeeeea ae eeeeeeeeeGaaaeeeeeeeeesaaaaeeeeeeeessaaaasseeeeeeeaaaaaeeeees S 3 1 2 Problem context Definition Scenario ccccccccccccssseeecccceeee eee eeeeeeeeeeeee ena eeeeeeeeeeeaaeeeeeeeeeeesaaaaeseeeeeeeaaaaaees 10 3 1 3 Context Matching and Notes Display SC NATI0 cccccccccccssseeeeeccceeee ea eesseeeeeeeeaaaenseeeeeeeeaaaaeeee
14. ssist user with relevant knowledge suggestions which are applicable on current user situation In UAA we understand experience though notes entered by user Such notes are displayed to the users in same or similar context Thus UAA helps users in collaboration and knowledge sharing Notes can be generated also automatically e g past workflow and result notes generated by KAA WXA Notes can also contain reference to other resources such as workflows results or images The other UAA role is problem definition where user can describe his her problem typing free text and relevant semantic description of problem is detected and processed by other K Wf Grid components to build and execute workflows for given user problem UAA 1s built on EMBET architecture developed in Institute of Informatics SAS This architecture is being extended during K Wf Grid project and sometimes when we refer to EMBET or UAA this can be identical 1 1 ABBREVIATIONS AND ACRONYMS EMBET Platform for Collaborating and Knowledge Sharing via User Assistance Abbreviations comes from Experience Management based on Text Notes UAA User Assistant Agent sometimes referenced as EMBET GOM Grid Organizational Memory sometimes referenced as Memory GWES Grid Workflow Execution Service KAA Knowledge Assimilation Agent See KAA manuals for more details KAA WXA Workflow XML Analyzer is part of KAA which process past workflows to find knowledge resulting to
15. tected like September the time in which this note is valid After the context detection the user is presented with a checklist Figure 2 where the user may select only the relevant parts of the context which will trigger this note A user selects parts of the context which were detected by the system as really relevant He she can subsequently modify the contents of the list and finally submit the note Each time anyone works with the MMS service for Bratislava area in September the note is displayed or it can be also displayed in similar contexts Each note can be voted by a user as being good or bad and the current results are always displayed along with the vote This feature is not implemented yet KWEF WP35 DS5 IISAS PUBLIC 9 15 UAAUserManual K WfGrid USER ASSISTANT AGENT USER MANUAL IST 2002 511385 This model gives a good basis for experience management and knowledge sharing in a virtual organization as well as for application related collaboration among users 3 1 2 Problem context Definition Scenario The main idea of this scenario is that user context environment problem definition is changed and thus relevant experience can be showed after such change In K Wf grid application this can be archived by e reporting a change of user context from an external system For example when a user selects a different workflow or web service in K Wf Grid GUI event for updating user context is generated e Fr
16. veF 2D Visualization Service WizualizationService Info Knowledge Add Knowledge gt DaveF 20 Vizualization OWL 5 e O knowledge Assimilation 06 06 2006 Ll This model can be run succesfully only on vah river because calibration data for other area are missing 5 O michal Laclavik 3 11 20053 Figure 5 VAA EMBET GUI 3 1 4 Initializing Red Workflow Scenario UAA K Wf Grid specific functionality is initializing so called Red Workflow Red Workflow is simple workflow which consist of element specifying desired user output or desired service effect Such elements are detected using problem definition scenario By clicking on gt selected user context is used to build red workflow which is sent to GWES 3 1 5 Initializing of Past Workflows UAA K Wf Grid specific functionality is to reuse past composed or executed workflows If for a user context some workflow notes are displayed user can click on gt note icon to resubmit such workflow to GWES As example please see first note Dave 2D Visualization OWL on Figure 5 Workflows notes are automatically generated by KAA WXA tool See more details on KAA WXA tool in KAA manuals 3 1 6 Displaying the Results of Workflow Execution UAA K Wf Grid specific functionality is also to view result files of past executed workflows If for a user context some result notes are displayed user can click on gt note icon to open result fil
Download Pdf Manuals
Related Search