diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-pbesa.spec | 447 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 449 insertions, 0 deletions
@@ -0,0 +1 @@ +/pbesa-3.1.4.tar.gz diff --git a/python-pbesa.spec b/python-pbesa.spec new file mode 100644 index 0000000..4c94558 --- /dev/null +++ b/python-pbesa.spec @@ -0,0 +1,447 @@ +%global _empty_manifest_terminate_build 0 +Name: python-pbesa +Version: 3.1.4 +Release: 1 +Summary: An artificial intelligence platform for the implementation of multi-agent systems based on python 3 and the BESA model +License: MIT +URL: https://github.com/akenfactory/pbesa.git +Source0: https://mirrors.aliyun.com/pypi/web/packages/32/3e/33fce780f6edbb750ff04cd0c04d68cd0b4665f6b17092489ccb966acdaa/pbesa-3.1.4.tar.gz +BuildArch: noarch + + +%description +## An artificial intelligence platform for the implementation of multi-agent systems based on python 3 and the BESA model +Actually, Agents and MultiAgent Systems (MAS) are one of the most prominent and attractive technologies in Engineering and +Computer Science. Agent and MAS technologies, methods, and theories are currently contributing to many diverse domains +such as information retrieval, user interface design, robotics, computer games, education and training, smart environments, social simulation, management projects, e-business, knowledge management, virtual reality. + +An Agent is an entity that includes mechanisms to receive perceptions from its environment and modify it. The work of an agent is to decide or to infer which is the most adequate action to achieve a specific goal. An agent has several resources and skills, and frequently it can communicate with other agents. The correct action is selected using a function mapping that can be expressed in different ways, ranging from simple condition-action rules to complex +inference mechanisms. In some cases the mapping function can be given, in agents with mayor autonomy this function can be directly learned by the agent. + +The capabilities of an isolated agent are limited to its resources and abilities. When objectives get more complex, the mapping function to select the best action is less efficient, because the complexity of this function is increased. Thus, it is more efficient to build several agents, where each agent contributes to achieve the general goal. A MAS can be defined as a collection of agents that cooperate to achieve a goal. + +# BESA +The abstract model of BESA is based in three fundamental concepts: a modular behaviororiented agent architecture, an event-driven control approach implementing a select like mechanism, and a social-based support for cooperation between agents. + +### Behavior-Oriented +When building agents, one of the critical problems to solve is the complexity; as the agent is intended to be more rational and autonomous, the elements involved became more complex. In order to deal with this growing problem, +different modular architectures have been proposed. The fundamental idea is to break down a complex entity into a set of small simpler ones. + +### Event-Driven +In the BESA model, an agent is seen as it is immersed in an environment populated of events. An event can be interpreted as a signal allowing to perceive that something interesting for an agent has occurred, and can include +information about what has happened. What is really relevant is not the information, but the fact that the agent receives an stimulus and must react to produce a response. + +### Social-Based +In order to analyze and design a MAS, the use of a social based model allows to study the system +as an organization of interacting entities. Ferber has proposed a set of essential functions and dimensions to analyze an organization of agents; such approach has the advantage of identifying in a structured way the relations of the entities +composing the system, as well as the connections with other systems. + +See full paper: [BESA PAPER](https://pdfs.semanticscholar.org/5836/027c6c07b124ac86d3343aa56b43b52779e6.pdf) + +# Install PBESA +pip install pbesa + +# Get started +To create a MAS with PBESA, you need to follow 3 simple steps: + +### Step 1 - Create a PBESA container: +``` +from pbesa.kernel.system.Adm import Adm +mas = Adm() +mas.start() +``` +### Step 2 - Create an action: +``` +from pbesa.kernel.agent.Action import Action +class SumAction(Action): + """ An action is a response to the occurrence of an event """ + + def execute(self, data): + """ + Response. + @param data Event data + """ + print(self.agent.state['acum'] + data) + + def catchException(self, exception): + """ + Catch the exception. + @param exception Response exception + """ + pass +``` +### Step 3 - Create an agent: +- Define Agent +``` +from pbesa.kernel.agent.Agent import Agent +class SumAgent(Agent): + """ Through a class the concept of agent is defined """ + + def setUp(self): + """ + Method that allows defining the status, structure + and resources of the agent + """ + # Defines the agent state + self.state = { + 'acum': 7 + } + # Defines the behavior of the agent. An agent can + # have one or many behaviors + self.addBehavior('calculate') + # Assign an action to the behavior + self.bindAction('calculate', 'sum', SumAction()) + + def shutdown(self): + """ Method to free up the resources taken by the agent """ + pass +``` +### Step 4 - Run MAS: +``` +if __name__ == "__main__": + """ Main """ + try: + # Initialize the container + mas = Adm() + mas.start() + + # Create the agent + agentID = 'Jarvis' + ag = SumAgent(agentID) + ag.start() + + # Send the event + data = 8 + mas.sendEvent('Jarvis', 'sum', data) + + # Remove the agent from the system + time.sleep(1) + mas.killAgent(ag) + + # Destroy the Agent Container + mas.destroy() + except: + traceback.print_exc() +``` + +# Integration with Django +In the examples folder there is a Django project. Given the expression of "Hello world" through GET. The system responds in Spanish. + +### It can be started with: +``` +python manage.py runserver 0.0.0.0:8000 --noreload +``` + +### To invoke the functionality you can: +``` +curl localhost:8000/pbesa/translate?data=Hello_World +``` + +%package -n python3-pbesa +Summary: An artificial intelligence platform for the implementation of multi-agent systems based on python 3 and the BESA model +Provides: python-pbesa +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-pbesa +## An artificial intelligence platform for the implementation of multi-agent systems based on python 3 and the BESA model +Actually, Agents and MultiAgent Systems (MAS) are one of the most prominent and attractive technologies in Engineering and +Computer Science. Agent and MAS technologies, methods, and theories are currently contributing to many diverse domains +such as information retrieval, user interface design, robotics, computer games, education and training, smart environments, social simulation, management projects, e-business, knowledge management, virtual reality. + +An Agent is an entity that includes mechanisms to receive perceptions from its environment and modify it. The work of an agent is to decide or to infer which is the most adequate action to achieve a specific goal. An agent has several resources and skills, and frequently it can communicate with other agents. The correct action is selected using a function mapping that can be expressed in different ways, ranging from simple condition-action rules to complex +inference mechanisms. In some cases the mapping function can be given, in agents with mayor autonomy this function can be directly learned by the agent. + +The capabilities of an isolated agent are limited to its resources and abilities. When objectives get more complex, the mapping function to select the best action is less efficient, because the complexity of this function is increased. Thus, it is more efficient to build several agents, where each agent contributes to achieve the general goal. A MAS can be defined as a collection of agents that cooperate to achieve a goal. + +# BESA +The abstract model of BESA is based in three fundamental concepts: a modular behaviororiented agent architecture, an event-driven control approach implementing a select like mechanism, and a social-based support for cooperation between agents. + +### Behavior-Oriented +When building agents, one of the critical problems to solve is the complexity; as the agent is intended to be more rational and autonomous, the elements involved became more complex. In order to deal with this growing problem, +different modular architectures have been proposed. The fundamental idea is to break down a complex entity into a set of small simpler ones. + +### Event-Driven +In the BESA model, an agent is seen as it is immersed in an environment populated of events. An event can be interpreted as a signal allowing to perceive that something interesting for an agent has occurred, and can include +information about what has happened. What is really relevant is not the information, but the fact that the agent receives an stimulus and must react to produce a response. + +### Social-Based +In order to analyze and design a MAS, the use of a social based model allows to study the system +as an organization of interacting entities. Ferber has proposed a set of essential functions and dimensions to analyze an organization of agents; such approach has the advantage of identifying in a structured way the relations of the entities +composing the system, as well as the connections with other systems. + +See full paper: [BESA PAPER](https://pdfs.semanticscholar.org/5836/027c6c07b124ac86d3343aa56b43b52779e6.pdf) + +# Install PBESA +pip install pbesa + +# Get started +To create a MAS with PBESA, you need to follow 3 simple steps: + +### Step 1 - Create a PBESA container: +``` +from pbesa.kernel.system.Adm import Adm +mas = Adm() +mas.start() +``` +### Step 2 - Create an action: +``` +from pbesa.kernel.agent.Action import Action +class SumAction(Action): + """ An action is a response to the occurrence of an event """ + + def execute(self, data): + """ + Response. + @param data Event data + """ + print(self.agent.state['acum'] + data) + + def catchException(self, exception): + """ + Catch the exception. + @param exception Response exception + """ + pass +``` +### Step 3 - Create an agent: +- Define Agent +``` +from pbesa.kernel.agent.Agent import Agent +class SumAgent(Agent): + """ Through a class the concept of agent is defined """ + + def setUp(self): + """ + Method that allows defining the status, structure + and resources of the agent + """ + # Defines the agent state + self.state = { + 'acum': 7 + } + # Defines the behavior of the agent. An agent can + # have one or many behaviors + self.addBehavior('calculate') + # Assign an action to the behavior + self.bindAction('calculate', 'sum', SumAction()) + + def shutdown(self): + """ Method to free up the resources taken by the agent """ + pass +``` +### Step 4 - Run MAS: +``` +if __name__ == "__main__": + """ Main """ + try: + # Initialize the container + mas = Adm() + mas.start() + + # Create the agent + agentID = 'Jarvis' + ag = SumAgent(agentID) + ag.start() + + # Send the event + data = 8 + mas.sendEvent('Jarvis', 'sum', data) + + # Remove the agent from the system + time.sleep(1) + mas.killAgent(ag) + + # Destroy the Agent Container + mas.destroy() + except: + traceback.print_exc() +``` + +# Integration with Django +In the examples folder there is a Django project. Given the expression of "Hello world" through GET. The system responds in Spanish. + +### It can be started with: +``` +python manage.py runserver 0.0.0.0:8000 --noreload +``` + +### To invoke the functionality you can: +``` +curl localhost:8000/pbesa/translate?data=Hello_World +``` + +%package help +Summary: Development documents and examples for pbesa +Provides: python3-pbesa-doc +%description help +## An artificial intelligence platform for the implementation of multi-agent systems based on python 3 and the BESA model +Actually, Agents and MultiAgent Systems (MAS) are one of the most prominent and attractive technologies in Engineering and +Computer Science. Agent and MAS technologies, methods, and theories are currently contributing to many diverse domains +such as information retrieval, user interface design, robotics, computer games, education and training, smart environments, social simulation, management projects, e-business, knowledge management, virtual reality. + +An Agent is an entity that includes mechanisms to receive perceptions from its environment and modify it. The work of an agent is to decide or to infer which is the most adequate action to achieve a specific goal. An agent has several resources and skills, and frequently it can communicate with other agents. The correct action is selected using a function mapping that can be expressed in different ways, ranging from simple condition-action rules to complex +inference mechanisms. In some cases the mapping function can be given, in agents with mayor autonomy this function can be directly learned by the agent. + +The capabilities of an isolated agent are limited to its resources and abilities. When objectives get more complex, the mapping function to select the best action is less efficient, because the complexity of this function is increased. Thus, it is more efficient to build several agents, where each agent contributes to achieve the general goal. A MAS can be defined as a collection of agents that cooperate to achieve a goal. + +# BESA +The abstract model of BESA is based in three fundamental concepts: a modular behaviororiented agent architecture, an event-driven control approach implementing a select like mechanism, and a social-based support for cooperation between agents. + +### Behavior-Oriented +When building agents, one of the critical problems to solve is the complexity; as the agent is intended to be more rational and autonomous, the elements involved became more complex. In order to deal with this growing problem, +different modular architectures have been proposed. The fundamental idea is to break down a complex entity into a set of small simpler ones. + +### Event-Driven +In the BESA model, an agent is seen as it is immersed in an environment populated of events. An event can be interpreted as a signal allowing to perceive that something interesting for an agent has occurred, and can include +information about what has happened. What is really relevant is not the information, but the fact that the agent receives an stimulus and must react to produce a response. + +### Social-Based +In order to analyze and design a MAS, the use of a social based model allows to study the system +as an organization of interacting entities. Ferber has proposed a set of essential functions and dimensions to analyze an organization of agents; such approach has the advantage of identifying in a structured way the relations of the entities +composing the system, as well as the connections with other systems. + +See full paper: [BESA PAPER](https://pdfs.semanticscholar.org/5836/027c6c07b124ac86d3343aa56b43b52779e6.pdf) + +# Install PBESA +pip install pbesa + +# Get started +To create a MAS with PBESA, you need to follow 3 simple steps: + +### Step 1 - Create a PBESA container: +``` +from pbesa.kernel.system.Adm import Adm +mas = Adm() +mas.start() +``` +### Step 2 - Create an action: +``` +from pbesa.kernel.agent.Action import Action +class SumAction(Action): + """ An action is a response to the occurrence of an event """ + + def execute(self, data): + """ + Response. + @param data Event data + """ + print(self.agent.state['acum'] + data) + + def catchException(self, exception): + """ + Catch the exception. + @param exception Response exception + """ + pass +``` +### Step 3 - Create an agent: +- Define Agent +``` +from pbesa.kernel.agent.Agent import Agent +class SumAgent(Agent): + """ Through a class the concept of agent is defined """ + + def setUp(self): + """ + Method that allows defining the status, structure + and resources of the agent + """ + # Defines the agent state + self.state = { + 'acum': 7 + } + # Defines the behavior of the agent. An agent can + # have one or many behaviors + self.addBehavior('calculate') + # Assign an action to the behavior + self.bindAction('calculate', 'sum', SumAction()) + + def shutdown(self): + """ Method to free up the resources taken by the agent """ + pass +``` +### Step 4 - Run MAS: +``` +if __name__ == "__main__": + """ Main """ + try: + # Initialize the container + mas = Adm() + mas.start() + + # Create the agent + agentID = 'Jarvis' + ag = SumAgent(agentID) + ag.start() + + # Send the event + data = 8 + mas.sendEvent('Jarvis', 'sum', data) + + # Remove the agent from the system + time.sleep(1) + mas.killAgent(ag) + + # Destroy the Agent Container + mas.destroy() + except: + traceback.print_exc() +``` + +# Integration with Django +In the examples folder there is a Django project. Given the expression of "Hello world" through GET. The system responds in Spanish. + +### It can be started with: +``` +python manage.py runserver 0.0.0.0:8000 --noreload +``` + +### To invoke the functionality you can: +``` +curl localhost:8000/pbesa/translate?data=Hello_World +``` + +%prep +%autosetup -n pbesa-3.1.4 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-pbesa -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Jun 20 2023 Python_Bot <Python_Bot@openeuler.org> - 3.1.4-1 +- Package Spec generated @@ -0,0 +1 @@ +088a78ea7bcfc3fef31688d5887536dd pbesa-3.1.4.tar.gz |