TestingMiddleware
In this page is shown an example of communication agent-agent over an Email Server To run this test, you need an email account for each agent.
You can use any email provider, since the provider uses imaps and smtpOverTLS protocols (other cases, consult [1]). Below there are some instructions to use public email providers, like GMX, GMAIL, Yahoo, or FastMail:
-
GMX, to use the GMX Email Service, you only need to create the accounts in https://www.gmx.com/mail/.
-
GMAIL, to use the Google Email Service, follow the steps below:
Instructions to use the GMail
To integrate your Mailer Agent with GMail, you need an app password, a 16-digit passcode. More information at https://support.google.com/accounts/answer/185833.
- First, you need to create the accounts in https://support.google.com/mail/answer/56256;
- After, you need to create an APP Password in https://myaccount.google.com/apppasswords;
- Finally, you need to enable IMAP connection https://mail.google.com/mail/u/0/#settings/fwdandpop.
-
Yahoo, to use the Yahoo Mail, follow the steps below:
Instructions to integrate with Yahoo
To integrate the Mailer Agent with Yahoo, you need an app password, a long, randomly generated code. More information at https://help.yahoo.com/kb/SLN15241.html
- First, you need to create the accounts in https://mail.yahoo.com
- After, you need to create an APP PASSWORD in https://login.yahoo.com/myaccount/security/app-password/
-
FastMail, to use the FastMail service, follow the steps below:
Instructions integrate with FastMail
To integrate the Mailer Agent with FastMail, you need an app password, more information at https://www.fastmail.com/blog/whats-up-with-app-passwords/
- To use FastMail service, you need to configure the APP PASSWORD. See more in https://app.fastmail.com/settings/security/integrations
We are considering that you are using the Jason-CLI, to run this test. How to install the Jason-CLI ?
- Download the project. In a terminal, execute the commands below:
wget https://github.com/chon-group/Mailer/wiki/.files/testMailMiddleware.tar.gz
tar -zxvf testMailMiddleware.tar.gz
cd testMailMiddleware/
- Edit the .ASL alice file and change the beliefs aliceEmailAndPass and bobEmailAndPass, including the e-mail credentials, like the figure below.
- aliceEmailAndPass("PUT-HERE-THE-ALICE-MAIL","PUT-HERE-THE-ALICE-PASS").
- bobEmailAndPass("PUT-HERE-THE-BOB-MAIL","PUT-HERE-THE-BOB-PASS").
- Execute the MultiAgent System, with the command below.
jason testMailMiddleware.mas2j
- If all is correct, the expected output is the follow.
Mailer is licensed under a Creative Commons Attribution 4.0 International License. The licensor cannot revoke these freedoms as long as you follow the license terms:
- Attribution — You must give appropriate credit like below:
Lazarin, N.M., de Souza, J.P.B., Pantoja, C.E., Alexandre, T., Viterbo, J. (2025). Human and BDI-Agent Interaction via KQML Messages over IMAP and SMTP. In: Mathieu, P., De la Prieta, F. (eds) Advances in Practical Applications of Agents, Multi-Agent Systems, and Digital Twins: The PAAMS Collection. PAAMS 2024. Lecture Notes in Computer Science(), vol 15157. Springer, Cham. DOI: 10.1007/978-3-031-70415-4_15
Bibtex Citation
@InProceedings{mailerAgent,
doi="10.1007/978-3-031-70415-4_15"
author="Lazarin, Nilson Mori
and de Souza, Jo{\~a}o Pedro Bernardo
and Pantoja, Carlos Eduardo
and Alexandre, Tielle
and Viterbo, Jose",
editor="Mathieu, Philippe
and De la Prieta, Fernando",
title="Human and BDI-Agent Interaction via KQML Messages over IMAP and SMTP",
booktitle="Advances in Practical Applications of Agents, Multi-Agent Systems, and Digital Twins: The PAAMS Collection",
year="2025",
publisher="Springer Nature Switzerland",
address="Cham",
pages="172--183",
isbn="978-3-031-70415-4"
}