Documentacion: PC_Representation

Descripcion: The devices and applications which compose the MAS environment. The model shows how the agents perceive this environment through these devices and applications. The external resources identified are: HardDisk, EmailWrapper, UserDevice and Categorizer. There are three agents which sense the environment through these resources: HDDocumentOrganizer, EmailOrganizer and UserSpeaker.

The HardDisk is the entity representing a computer internal storage device. It is modelled with three operations and one event. These operations allow obtaining its folders, the files in a folder and moving a file between folders. The event is triggered when a new file is created. The agent which is engaged in the tasks about HD documents is the HDDocumentOrganizer. It perceives the events in the HardDisk and carries out the adequate actions.

In the same way that a HardDisk entity is defined to represent the hard disks is the system, an EmailWrapper is defined to encapsulate the e-mail sources and the different clients employed to accesss them. The EmailWrapper has three operations and one event. These operations allow obtaining its folders, the e-mails in a folder and moving an e-mail between folders. The event is triggered when there is new e-mail. The agent which is engaged in the tasks about e-mails is the EmailOrganizer. It perceives the events in the EmailWrapper and carries out the adequate actions.

The system has to interact with the user in a friendly manner that avoid his annoyance. In order to accomplish this goal, it is necessary to model the interaction with the user interface. These resources are simulated with the UserDevice. It has two general operations to send and receive messages like notifications. There are two more operations, which are more specific, to add and remove agents. The agent tied to this resource is the UserSpeaker.

Agents in the system have to be managed. It is done with the AgentsManagerApplication. This program is used by agents in the system to add more of them or to removed themselves from the system.

The last identified resource is the Categorizer. It represents the classification tool. The application provides operations to add categories to the taxonomy and documents to these categories, to obtain a category list and to get the category of a document. Its related agent, the Classifier, is not represented here because there are not any events related with the Categorizer that this agent has to perceive.

The agent perception and actions over the environment are represented by operations. With the analysis and design progress, new functionalities will be discovered . To model appropriatelly agents interaction with their environment, new operations will have to be added to these resources.

Finally, a restriction has been established to the system. The CPU usage of the overall system must not overpass a thirty per cent. This limitation tries to avoid the system becomes a resource hog.


Instancias de entidades de meta-modelo

EntidadEntidad del meta-modeloDocumentacion
EmailOrganizer 
 Agente  It represents the agent which manages the email in the system. It is related with an EmailWrapper. 
HDDocumentOrganizer 
 Agente  It represents the agent which manages the HD documents in the system. It is related with an HardDisk. 
UserSpeaker 
 Agente  It represents the agent which manages the communications with the user through an interface. It is related with an UserDevice. 
HardDisk 
 AplicacionEntorno  Hard Disk.
It has operations to get the HD folders and the files in them and to move files between folders. It also has an event which notifies there is a new file. 
AgentsManagerApplication 
 AplicacionInterna  It is an agent factory employed in the agent management.
It provides operations to create, remove and list agents in the community. 
Categorizer 
 AplicacionInterna  It is a wrapper to a text mining tool. It manages a category taxonomy.
It provides operations to create new categories, add documents to these categories, obtain a category list and to get the category of a document. 
EmailWrapper 
 AplicacionInterna  Wrapper for a mailing tool.
It has operations to get the mail folders and the mails in them and to move mails between folders. It also has an event which notifies there is new email. 
UserDevice 
 AplicacionInterna  It represents every device used to communicate with users.
It provides operations to send and receive general notifications from or to the interface and to receive requests about adding or removing agents. 
CPU 
 RecursoNoConsumible   

EmailOrganizer (Agente)

Propiedades:
IDEmailOrganizer 
DescripcionIt represents the agent which manages the email in the system. It is related with an EmailWrapper. 

Relaciones:
En el rolEn la relacion Otros extremos
EPercibeO EPercibeNotificacion
  • Operacion:newEmailReceived 
  • evento:NewMailArrived 
    •  
    Con los objetosEn el rol
    EmailWrapper  EPercibeD

    HDDocumentOrganizer (Agente)

    Propiedades:
    IDHDDocumentOrganizer 
    DescripcionIt represents the agent which manages the HD documents in the system. It is related with an HardDisk. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    EPercibeO EPercibeNotificacion
  • Operacion:newFileCreated 
  • evento:NewFileModified 
    •  
    Con los objetosEn el rol
    HardDisk  EPercibeD

    UserSpeaker (Agente)

    Propiedades:
    IDUserSpeaker 
    DescripcionIt represents the agent which manages the communications with the user through an interface. It is related with an UserDevice. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    EPercibeO EPercibeNotificacion
  • Operacion:addNewAgent 
  • evento:AddNewAgent 
    •  
    Con los objetosEn el rol
    UserDevice  EPercibeD
    EPercibeO EPercibeNotificacion
  • Operacion:removeAgent 
  • evento:RemoveAgent 
    •  
    Con los objetosEn el rol
    UserDevice  EPercibeD

    HardDisk (AplicacionEntorno)

    Propiedades:
    IDHardDisk 
    DescripcionHard Disk.
    It has operations to get the HD folders and the files in them and to move files between folders. It also has an event which notifies there is a new file. 
    OperacionesgetFolders getFilesInFolder moveFile newFileCreated  

    Relaciones:
    En el rolEn la relacion Otros extremos
    EPercibeD EPercibeNotificacion
  • Operacion:newFileCreated 
  • evento:NewFileModified 
    •  
    Con los objetosEn el rol
    HDDocumentOrganizer  EPercibeO

    AgentsManagerApplication (AplicacionInterna)

    Propiedades:
    IDAgentsManagerApplication 
    DescripcionIt is an agent factory employed in the agent management.
    It provides operations to create, remove and list agents in the community. 
    OperacionesaddAgent removeAgent listAgents  

    Relaciones:

    Categorizer (AplicacionInterna)

    Propiedades:
    IDCategorizer 
    DescripcionIt is a wrapper to a text mining tool. It manages a category taxonomy.
    It provides operations to create new categories, add documents to these categories, obtain a category list and to get the category of a document. 
    OperacionescreateCategory addDocumentsToCategory enableCategorizer disableCategorizer getDocumentCategory getCategoryList  

    Relaciones:

    EmailWrapper (AplicacionInterna)

    Propiedades:
    IDEmailWrapper 
    DescripcionWrapper for a mailing tool.
    It has operations to get the mail folders and the mails in them and to move mails between folders. It also has an event which notifies there is new email. 
    OperacionesgetMailFolders getEmailsInFolder moveEmailToFolder newEmailReceived  

    Relaciones:
    En el rolEn la relacion Otros extremos
    EPercibeD EPercibeNotificacion
  • Operacion:newEmailReceived 
  • evento:NewMailArrived 
    •  
    Con los objetosEn el rol
    EmailOrganizer  EPercibeO

    UserDevice (AplicacionInterna)

    Propiedades:
    IDUserDevice 
    DescripcionIt represents every device used to communicate with users.
    It provides operations to send and receive general notifications from or to the interface and to receive requests about adding or removing agents. 
    OperacionessentMesage receiveMessage addNewAgent removeAgent  

    Relaciones:
    En el rolEn la relacion Otros extremos
    EPercibeD EPercibeNotificacion
  • Operacion:addNewAgent 
  • evento:AddNewAgent 
    •  
    Con los objetosEn el rol
    UserSpeaker  EPercibeO
    EPercibeD EPercibeNotificacion
  • Operacion:removeAgent 
  • evento:RemoveAgent 
    •  
    Con los objetosEn el rol
    UserSpeaker  EPercibeO

    CPU (RecursoNoConsumible)

    Propiedades:
    IDCPU 
    Descripcion 
    valor_real0 
    valor_real30 
    valor_real0 

    Relaciones: