Bot:Guide/approved services

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 one or more specified MediaWiki pages into PDF documents and emails them back to the sender as attachments.
• The user provides the title(s) of the wiki page(s) they want as 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 a single wiki page to convert (e.g. "Combined ratio", "Internal:Teams/Group tax department"). The bot normalizes the title to match the wiki page name.
• page_titles — use this when the user requests multiple pages in a single email. The bot generates one PDF per page and attaches them all in one reply.

Note: use page_title for a single page, or page_titles for multiple pages.

Optional parameters

• orientation — PDF page orientation: "portrait" (default) or "landscape". The user can say "in landscape", "landscape mode", or "landscape orientation" to switch.

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

4. Multiple pages in one email:

Subject: PDFs needed
Body: Hi, can you send me PDFs of Combined ratio, Loss ratio, and Internal:Teams/Group tax department?

→ page_titles: ["Combined ratio", "Loss ratio", "Internal:Teams/Group tax department"]

5. Landscape orientation:

Subject: PDF request
Body: Can you send me a PDF of the FY25 results summary in landscape?

→ page_title: FY25 results summary → orientation: landscape

~*~

retrieve

Description

• Searches the wiki and answers the user's question using the content found on relevant pages.
• The bot reads one or more wiki pages and composes a natural language answer, citing sources.
• This service is used when the user asks a question about wiki content rather than requesting a file or PDF.

Required parameters

• query — the user's question in natural language (e.g. "Who is the head of Group tax?", "What is the CSM rollforward of AXA in FY25?").

Optional parameters

• page_hints — explicit page titles mentioned by the user (e.g. if the user says "look at the Thomas Buberl page", the page_hint is "Thomas Buberl").

Trigger phrases

• "find me..."
• "tell me about..."
• "what is..."
• "who is..."
• "give me..."
• "show me..."
• "I need to know..."
• "can you look up..."
• "search for..."
• "I need information on..."
• "help me find..."

Examples

1. Contact lookup:

Subject: Contact at Group tax
Body: Hi BananaBot, I'm working at AXA XL and need to find a contact at Group tax. Help me find.

→ query: "find a contact at Group tax" → search_terms: ["Group tax department", "Group tax"] → suggested_paths: ["Internal:Teams/"]

2. Financial data retrieval:

Subject: CSM rollforward
Body: Hi BananaBot, give me the CSM rollforward of AXA in FY25.

→ query: "CSM rollforward of AXA in FY25" → search_terms: ["CSM rollforward", "AXA FY25 results"] → suggested_paths: ["Web:AXA/results/"]

3. Definition question:

Subject: Quick question
Body: What is combined ratio?

→ query: "What is combined ratio?" → search_terms: ["Combined ratio"] → suggested_paths: ["Definition:"]

4. Person lookup:

Subject: Info needed
Body: Tell me about Thomas Buberl

→ query: "Tell me about Thomas Buberl" → search_terms: ["Thomas Buberl"] → page_hints: ["Thomas Buberl"]

5. Market intelligence:

Subject: M&A trends
Body: What are the latest M&A trends in insurance?

→ query: "latest M&A trends in insurance" → search_terms: ["M&A insurance", "M&A trends"] → suggested_paths: ["Web:Watch"]

~*~

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
- Search the wiki and answer your questions about its content

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

Best regards,
[bot_name]