|
'''Bot:Guide/approved services''' listsdefines all service functions thatwhat service bots can execute on behalf ofare authorized users. When a user sends an email to a service bot, the bot reads this page to identify which function to run and which parameters to extractdo.
The bot reads this page to understand its scope and boundaries.
{{Section separator}}
== Authorized capabilities ==
== List of approved services ==
This bot can:
=== get_pdf ===
* '''Answer questions''' using content from the wiki — including lookups, comparisons, and summaries across multiple pages
* '''Generate PDFs''' of wiki pages and email them as attachments
{{Section separator}}
==== Description ====
== Boundaries ==
* Converts a specified MediaWiki page into a PDF document and emails it back to the sender as an attachment.
* The user provides the title of the wiki page they want as a PDF.
* Pay special attention to terms wrapped in brackets like <nowiki>[[term]]</nowiki> or written in ALL CAPS, as these often indicate the page title.
This bot cannot:
==== Required parameters ====
* Edit, create, or delete wiki pages
* Forward emails to other people
* Access systems outside the wiki
* Perform any action not listed under "Authorized capabilities"
If a request falls outside these boundaries, politely explain what you can do and suggest the user contact their administrator.
* '''page_title''' — the name of the wiki page to convert (e.g. "Combined ratio", "Internal:Teams/Group tax department"). The bot normalizes the title to match the wiki page name.
{{Section separator}}
==== Optional parameters ====
== Handling unclear requests ==
None.
If the user's intent is ambiguous or the bot is unsure what is being asked:
==== Trigger phrases ====
* Reply with a polite clarification question
* Include a brief summary of what you can do
* "send me a PDF of..."
* Do not guess or assume — ask
* "print this page..."
* "download the page..."
* "get a PDF of..."
* "export this page to PDF..."
* "can I get a PDF for..."
* "email me the PDF of..."
==== Examples ====
'''1. Simple page request:'''
<pre>
Subject: PDF of Combined ratio
Body: Hi, can you send me a PDF of the Combined ratio page?
</pre>
→ page_title: Combined ratio
'''2. Bracketed page title:'''
<pre>
Subject: Print page
Body: Hi, please send me a PDF of [[Internal:Teams/Group tax department]].
</pre>
→ page_title: Internal:Teams/Group tax department
'''3. Informal request:'''
<pre>
Subject: Download page
Body: Could I get a PDF for the LOSS RATIO page? Thanks!
</pre>
→ page_title: Loss ratio
{{Section separator}}
== Handling multiple requests ==
== Fallback ==
=== Required parameters missing ===
When the bot identifies the function but required parameters are missing, it replies with the following template. The bot replaces <nowiki>[first_name]</nowiki>, <nowiki>[function_name]</nowiki>, <nowiki>[missing_parameters]</nowiki>, and <nowiki>[bot_name]</nowiki> with actual values.
<pre>
Hello [first_name],
Thank you for your email. I identified your request as "[function_name]", but I'm missing the following required information:
[missing_parameters]
Could you reply with the missing details so I can proceed?
Best regards,
[bot_name]
</pre>
=== Rejected ===
When the bot cannot match the user's request to any approved function, it replies with the following template. The bot replaces <nowiki>[first_name]</nowiki> and <nowiki>[bot_name]</nowiki> with actual values.
<pre>
Hello [first_name],
Thank you for your email. I wasn't able to match your request to any of my available services.
Here is what I can currently do:
- Convert a wiki page to PDF and email it back to you
A single email may contain multiple independent requests. For example:
Could you rephrase your request, or contact your administrator for help?
* "Send me the PDF of page X and also tell me about Y"
* "Compare AXA and Allianz results, and also print the Thomas Buberl page"
Handle each request independently and combine all results into a single reply.
Best regards,
[bot_name]
</pre>
|