Bot:Guide/approved productions: Difference between revisions

Content deleted Content added
No edit summary
Tag: Reverted
m Updated from approved_productions.txt via upload_guides
Tag: Manual revert
 
Line 1:
'''Bot:Guide/approved servicesproductions''' lists all serviceproduction functions that serviceproduction bots (e.g. PlumBot) can execute on behalf of authorized users. When a user sends an email to a serviceproduction bot, the bot reads this page to identify which function to run and which parameters to extract.
 
{{Section separator}}
 
== List of approved servicesfunctions ==
 
=== get_pdfcreate_definitions ===
 
==== Description ====
 
* Creates insurance glossary definition pages on the wiki.
* Converts one or more specified MediaWiki pages into PDF documents and emails them back to the sender as attachments.
* Can generate terms from broad subjects, create specific definition pages, or automatically fill in all missing definitions.
* The user provides the title(s) of the wiki page(s) they want as PDF.
* When both topics and terms are provided, seeds are generated from the topics and merged with the provided terms.
* Pay special attention to terms wrapped in brackets like <nowiki>[[term]]</nowiki> or written in ALL CAPS, as these often indicate the page title.
* When no parameters are provided, the bot scans for broken <nowiki>[[Definition:...]]</nowiki> links and creates those pages.
 
==== Required parameters ====
 
None.
* '''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 ====
 
* '''topics''' — list of broad subjects (e.g. "M&A", "Cyber insurance"). Generates 50 seed terms per topic.
* '''orientation''' — PDF page orientation: "portrait" (default) or "landscape". The user can say "in landscape", "landscape mode", or "landscape orientation" to switch.
* '''terms''' — list of specific terms (e.g. "Combined ratio", "Loss ratio"). Creates individual definition pages.
* '''override''' — yes or no. If yes, replaces existing pages. Default: no.
 
==== Trigger phrases ====
 
* "sendcreate medefinitions a PDF offor..."
* "printdefine thisthese pageterms..."
* "downloadgenerate theglossary pageentries about..."
* "getadd adefinitions PDF offor..."
* "exportcreate thispages page to PDFfor..."
* "cangenerate Idefinitions get a PDF forabout..."
* "emailmake medefinition thepages PDF offor..."
 
==== Examples ====
 
'''1. SimpleTopics pageand requestterms:'''
<pre>
Subject: Create definitions for Cyber and specific terms
Subject: PDF of Combined ratio
Body: Hi PlumBot, canplease youcreate senddefinitions me a PDF offor the Combined ratio page?topic
Cyber insurance. Also define these specific terms:
Ransomware warranty, Silent cyber exposure.
</pre>
→ topics: Cyber insurance / terms: Ransomware warranty, Silent cyber exposure / override: no
→ page_title: Combined ratio
 
'''2. Terms only:'''
<pre>
Subject: PDF ofDefine Combined ratio and Loss ratio
Body: Hi PlumBot, can you create definition pages for:
Combined ratio, Loss ratio, Expense ratio.
</pre>
→ topics: ''(none)'' / terms: Combined ratio, Loss ratio, Expense ratio / override: no
 
'''3. No parameters:'''
<pre>
Subject: Fix broken definition links
Body: Hi PlumBot, please check for any broken definition
links on the wiki and create the missing pages.
</pre>
→ topics: ''(none)'' / terms: ''(none)'' / override: no
 
=== create_team_pages ===
 
==== Description ====
 
* Creates standardized team pages on the wiki from organization description documents.
* The user attaches one or more documents (PDF, TXT, etc.) describing teams (roles, missions, org structure, contacts).
* Each document is transformed into a wiki page with an infobox, introduction, org chart, and team table.
* Pages are created at <nowiki>Internal:Teams/{team name}</nowiki> by default, or at a custom path if specified.
* If team names are provided, the bot matches each document to the corresponding name. If not provided, the bot determines the team name from the document content (sentence case, preserving proper nouns).
* By default, existing pages are overwritten (override: yes), since team pages typically represent updated information.
 
==== Required parameters ====
 
* '''documents''' — one or more attached files describing teams. The user must attach the documents to the email.
 
==== Optional parameters ====
 
* '''team_names''' — list of official team names (e.g. "Group tax department", "Group corporate finance"). If not provided, the bot determines the names from the documents.
* '''path''' — wiki path prefix where pages are created. Default: <nowiki>Internal:Teams/</nowiki>. Example: <nowiki>Internal:Teams/AXA Hong Kong/</nowiki> for a subfolder.
* '''override''' — yes or no. If yes, replaces existing pages. Default: yes.
 
==== Trigger phrases ====
 
* "create team pages using the attached..."
* "create team pages for..."
* "generate team pages from..."
* "build team pages from the attached..."
* "update team pages with..."
* "make team pages from..."
 
==== Examples ====
 
'''21. BracketedWith pageteam titlenames:'''
<pre>
Subject: PrintCreate pageteam pages
Body: Hi PlumBot, please send me acreate PDFteam ofpages [[Internal:Teams/Groupusing taxthe department]].attached
documents. The team names are: Group tax department;
Group corporate finance.
</pre>
page_titledocuments: Internal:Teams''(attachments)'' / team_names: Group tax department, Group corporate finance / path: Internal:Teams/ / override: yes
 
'''32. InformalWithout requestteam names (auto-detect):'''
<pre>
Subject: DownloadCreate pageteam pages from attached docs
Body: Hi PlumBot, please create team pages using the attached
Body: Could I get a PDF for the LOSS RATIO page? Thanks!
documents.
</pre>
→ documents: ''(attachments)'' / team_names: ''(auto-detected)'' / path: Internal:Teams/ / override: yes
→ page_title: Loss ratio
 
'''43. MultipleWith pagescustom in one emailpath:'''
<pre>
Subject: PDFsCreate neededteam pages for AXA Hong Kong
Body: Hi PlumBot, please create team pages using the attached
Body: Hi, can you send me PDFs of Combined ratio, Loss ratio, and Internal:Teams/Group tax department?
documents under Internal:Teams/AXA Hong Kong/.
The team names are: Corporate finance; Group tax.
</pre>
→ documents: ''(attachments)'' / team_names: Corporate finance, Group tax / path: Internal:Teams/AXA Hong Kong/ / override: yes
→ page_titles: ["Combined ratio", "Loss ratio", "Internal:Teams/Group tax department"]
 
'''54. LandscapeWithout orientationoverride:'''
<pre>
Subject: PDFCreate requestteam pages (don't overwrite)
Body: Hi PlumBot, please create team pages from the attached
Body: Can you send me a PDF of the FY25 results summary in landscape?
documents. Do not overwrite existing pages.
</pre>
→ documents: ''(attachments)'' / team_names: ''(auto-detected)'' / path: Internal:Teams/ / override: no
→ page_title: FY25 results summary
→ orientation: landscape
 
{{Section separator}}
Line 100 ⟶ 155:
Hello [first_name],
 
Thank you for your email. I wasn't able to match your request to any of my available servicesfunctions.
 
Here is what I can currently do:
- Create insurance glossary definitions (from topics, specific terms, or broken links)
- Convert a wiki page to PDF and email it back to you
- Create team pages from attached organization documents (with optional team names and custom wiki path)
 
Could you rephrase your request, or contact your administrator for help?