Difference between revisions of "LLM-based Chat Assistant"

From OSGeo
Jump to navigation Jump to search
m (Reverted edits by Ominiverdi (talk) to last revision by Strk)
Tag: Rollback
Line 1: Line 1:
= LLM-based Chat Assistant =
+
An LLM-based chat assistant bot available in the [[Matrix|OSGeo Matrix space]].
  
Experimental Matrix chat assistant running on the [[Gallery Container]].
+
== Access ==
  
Verified on <code>osgeo7-gallery</code>: the active bridge process is:
+
The bot is available in the [[Matrix]] room <code>#lounge:osgeo.org</code>.
 +
Its Matrix identifier is <code>@llm-assitant:matrix.org</code>.
 +
The bot responds when mentioned (@llm-assitant:matrix.org) or when a line starts with <code>!oc</code> or <code>bot</code>.
  
<pre>
+
== Administration ==
bun connectors/matrix.ts
 
</pre>
 
 
 
running from:
 
 
 
<pre>
 
/home/ominiverdi/github/opencode-chat-bridge
 
</pre>
 
  
== Purpose ==
+
TBD
  
The assistant connects Matrix chat to an LLM agent with MCP tools for OSGeo-specific search and retrieval.
+
== Technical Details ==
  
Observed MCP backends include:
+
* Host: [[SAC_Service_Status#osgeo7|osgeo7]]
 +
* Container: [[Gallery_Container|Gallery]]
 +
* Maintainer: [[User:Ominiverdi]]
 +
* Source: https://github.com/ominiverdi/opencode-chat-bridge
 +
* Language model: opencode/big-pickle (may change — ask the bot for current info)
  
* [[Osgeo-knowledge-base]]
+
== Usage ==
* [[Osgeo-library]]
 
* web search MCP
 
* time MCP
 
* Open-Meteo MCP
 
  
== Tool call display ==
+
Ask a question, prefixing your question with <code>!oc</code> or <code>bot</code> or mentioning <code>@llm-assitant:matrix.org</code>;
 
+
the bot will respond, possibly local OSGeo services. Tool calls may be visible in chat logs using the pattern:
The chat bridge may show MCP tool calls in messages, for example:
 
  
 
<pre>
 
<pre>
Line 36: Line 29:
 
</pre>
 
</pre>
  
The prefix identifies the MCP server. The suffix identifies the tool.
+
The prefix identifies the MCP server, and the suffix identifies the tool.
  
== Related repositories ==
+
'''[[osgeo-knowledge-base]] MCP tools:'''
 
+
* <code>osgeo-knowledge_search_wiki</code> - Search AI-generated summaries and keywords
Verified repositories on Gallery:
+
* <code>osgeo-knowledge_search_content</code> - Search raw page content chunks
 
+
* <code>osgeo-knowledge_search_entities</code> - Search people, projects, organizations, events
* <code>/home/ominiverdi/github/opencode-chat-bridge</code>
+
* <code>osgeo-knowledge_get_entity_relationships</code> - Query entity relationships
* https://github.com/ominiverdi/matrix-llmagent
+
* <code>osgeo-knowledge_get_page</code> - Retrieve a full page by title
* https://github.com/ominiverdi/osgeo-knowledge
+
* <code>osgeo-knowledge_get_wiki_stats</code> - Show database and sync statistics
* https://github.com/ominiverdi/osgeo-library
 
 
 
Note: <code>matrix-llmagent</code> exists on Gallery, but the currently running Matrix bridge process is from <code>opencode-chat-bridge</code>.
 
 
 
== Operations ==
 
 
 
Check the running bridge:
 
 
 
<pre>
 
pgrep -af "bun connectors/matrix.ts"
 
</pre>
 
 
 
Check active MCP processes:
 
 
 
<pre>
 
pgrep -af "mcp|osgeo-knowledge|osgeo-library"
 
</pre>
 
  
== Maintainer ==
+
'''[[osgeo-library]] / doclibrary MCP tools:'''
 +
* <code>search_documents</code> - Semantic search over document text and visual elements
 +
* <code>search_visual_elements</code> - Search figures, tables, equations, charts, and diagrams
 +
* <code>list_elements</code> - Browse document elements without semantic search
 +
* <code>get_element_details</code> - Retrieve metadata for a visual element
 +
* <code>get_element_image</code> - Retrieve a cropped element image
 +
* <code>get_page_image</code> - Retrieve a full page image
 +
* <code>get_document_info</code> - Show document metadata
 +
* <code>find_document</code> - Find a document by name or query
 +
* <code>list_documents</code> - List indexed documents
 +
* <code>get_library_status</code> - Check document library service status
  
* ominiverdi, Lorenzo Becchi
+
'''Contact:''' ominiverdi (Lorenzo Becchi) or SAC channel
* SAC channel
 
  
[[Category:Infrastructure]]
+
[[Category:Services]]
 +
[[Category:AI-Services]]

Revision as of 10:17, 5 June 2026

An LLM-based chat assistant bot available in the OSGeo Matrix space.

Access

The bot is available in the Matrix room #lounge:osgeo.org. Its Matrix identifier is @llm-assitant:matrix.org. The bot responds when mentioned (@llm-assitant:matrix.org) or when a line starts with !oc or bot.

Administration

TBD

Technical Details

Usage

Ask a question, prefixing your question with !oc or bot or mentioning @llm-assitant:matrix.org; the bot will respond, possibly local OSGeo services. Tool calls may be visible in chat logs using the pattern:

> query=spam, limit=10 [osgeo-knowledge_search_content]
> query=spam, limit=10 [osgeo-knowledge_search_wiki]

The prefix identifies the MCP server, and the suffix identifies the tool.

osgeo-knowledge-base MCP tools:

  • osgeo-knowledge_search_wiki - Search AI-generated summaries and keywords
  • osgeo-knowledge_search_content - Search raw page content chunks
  • osgeo-knowledge_search_entities - Search people, projects, organizations, events
  • osgeo-knowledge_get_entity_relationships - Query entity relationships
  • osgeo-knowledge_get_page - Retrieve a full page by title
  • osgeo-knowledge_get_wiki_stats - Show database and sync statistics

osgeo-library / doclibrary MCP tools:

  • search_documents - Semantic search over document text and visual elements
  • search_visual_elements - Search figures, tables, equations, charts, and diagrams
  • list_elements - Browse document elements without semantic search
  • get_element_details - Retrieve metadata for a visual element
  • get_element_image - Retrieve a cropped element image
  • get_page_image - Retrieve a full page image
  • get_document_info - Show document metadata
  • find_document - Find a document by name or query
  • list_documents - List indexed documents
  • get_library_status - Check document library service status

Contact: ominiverdi (Lorenzo Becchi) or SAC channel