Search AVEVA's Customer Support knowledge base and return matching article numbers, titles, products and excerpts.

Use this for support-desk material: specific error messages, known issues, version incompatibilities, workarounds and how-to notes. Prefer product documentation tools for conceptual or reference questions (what a feature is, configuration reference, API syntax); reach here when the user reports something broken or quotes an error.

Read-only; no side effects. Scoped to English-language Knowledge Base articles, excluding product documentation, community posts and product news. Requires a signed-in AVEVA support session — with none, it returns an instruction to run pi-kb-mcp login rather than failing silently. Returns a match count followed by up to n_results entries, each carrying the article number that get_kb_article needs.

Fetch the full text of one AVEVA knowledge base article, including its symptoms, cause and resolution sections.

Use after search_pi_kb to read an article whose excerpt looks relevant, or directly whenever the user supplies an article number or a softwaresupportsp.aveva.com link. Search excerpts are truncated and routinely omit the actual fix, so read the article before answering from a search result alone.

Read-only; no side effects. Returns a header line with title, products, article type and last-updated date, then the article body converted from HTML to plain text and truncated at max_chars, with a marker when cut.

List AVEVA product names accepted by the products argument of search_pi_kb, optionally filtered by a substring.

Use when a search returns results spanning unrelated products and you need the exact spelling to narrow it, or when the user names a product informally ('PI AF', 'Data Archive') and you need AVEVA's canonical form. Not needed for a first, unscoped search.

Read-only; no side effects. AVEVA publishes over a thousand product names, so with no argument this returns only PI System products; pass contains to find products outside that set. Results are cached for the life of the process. Returns one name per line, alphabetically, or a note if nothing matched.