Bot:Guide/approved services: Difference between revisions

Content deleted Content added

Inline

Revision as of 23:18, 1 April 2026

Bot:Guide/approved services lists all service functions that service bots can execute on behalf of 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 extract.

~*~

List of approved services

get_pdf

Description

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 [[term]] or written in ALL CAPS, as these often indicate the page title.

Required parameters

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.

Optional parameters

None.

Trigger phrases

"send me a PDF of..."
"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:

Subject: PDF of Combined ratio
Body: Hi, can you send me a PDF of the Combined ratio page?

→ page_title: Combined ratio

2. Bracketed page title:

Subject: Print page
Body: Hi, please send me a PDF of [[Internal:Teams/Group tax department]].

→ page_title: Internal:Teams/Group tax department

3. Informal request:

Subject: Download page
Body: Could I get a PDF for the LOSS RATIO page? Thanks!

→ page_title: Loss ratio

~*~

Fallback

Required parameters missing

When the bot identifies the function but required parameters are missing, it replies with the following template. The bot replaces [first_name], [function_name], [missing_parameters], and [bot_name] with actual values.

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]

Rejected

When the bot cannot match the user's request to any approved function, it replies with the following template. The bot replaces [first_name] and [bot_name] with actual values.

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

Could you rephrase your request, or contact your administrator for help?

Best regards,
[bot_name]

@@ Line 1: / Line 1: @@
+'''Bot:Guide/approved services''' lists all service functions that service bots can execute on behalf of 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 extract.
-== Approved bot services ==
+{{Section separator}}
-This table defines the authorized actions that the bot can perform. The AI agent uses this table to map user requests to specific workflows and extract the necessary parameters.
+== List of approved services ==
-{| class="wikitable"
-|-
+=== get_pdf ===
-! Service name
-! Intent description
+==== Description ====
-! Workflow guide page
-! Required parameters
+* 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.
-| Get 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.
-| Converts a specified MediaWiki page into a PDF document and emails it back to the sender as an attachment. Use this when the user asks to "print", "send a PDF", or "download" a wiki page.
-| [[Bot:Guide/approved services/get PDF]]
+==== Required parameters ====
-| <code>page_title</code>: The name of the wiki page requested. Pay special attention to terms wrapped in brackets like <nowiki>[[term]]</nowiki> or written in ALL CAPS.
-|}
+* '''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.
+==== Optional parameters ====
+None.
+==== Trigger phrases ====
+* "send me a PDF of..."
+* "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}}
+== 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
+Could you rephrase your request, or contact your administrator for help?
+Best regards,
+[bot_name]
+</pre>