Difference between revisions of "LLM-based Chat Assistant"

From OSGeo
Jump to navigation Jump to search
Line 1: Line 1:
An LLM-based chat assistant bot available in the [[Matrix|OSGeo Matrix space]].
+
= LLM-based Chat Assistant =
  
== Access ==
+
Experimental Matrix chat assistant running on the [[Gallery Container]].
  
The bot is available in the [[Matrix]] room <code>#lounge:osgeo.org</code>.
+
Verified on <code>osgeo7-gallery</code>: the active bridge process is:
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>.
 
  
== Administration ==
+
<pre>
 +
bun connectors/matrix.ts
 +
</pre>
 +
 
 +
running from:
 +
 
 +
<pre>
 +
/home/ominiverdi/github/opencode-chat-bridge
 +
</pre>
  
TBD
+
== Purpose ==
  
== Technical Details ==
+
The assistant connects Matrix chat to an LLM agent with MCP tools for OSGeo-specific search and retrieval.
  
* Host: [[SAC_Service_Status#osgeo7|osgeo7]]
+
Observed MCP backends include:
* 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)
 
  
== Usage ==
+
* [[Osgeo-knowledge-base]]
 +
* [[Osgeo-library]]
 +
* web search MCP
 +
* time MCP
 +
* Open-Meteo MCP
  
Ask a question, prefixing your question with <code>!oc</code> or <code>bot</code> or mentioning <code>@llm-assitant:matrix.org</code>;
+
== Tool call display ==
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 29: Line 36:
 
</pre>
 
</pre>
  
The prefix identifies the MCP server, and the suffix identifies the tool.
+
The prefix identifies the MCP server. The suffix identifies the tool.
  
'''[[osgeo-knowledge-base]] MCP tools:'''
+
== Related repositories ==
* <code>osgeo-knowledge_search_wiki</code> - Search AI-generated summaries and keywords
+
 
* <code>osgeo-knowledge_search_content</code> - Search raw page content chunks
+
Verified repositories on Gallery:
* <code>osgeo-knowledge_search_entities</code> - Search people, projects, organizations, events
+
 
* <code>osgeo-knowledge_get_entity_relationships</code> - Query entity relationships
+
* <code>/home/ominiverdi/github/opencode-chat-bridge</code>
* <code>osgeo-knowledge_get_page</code> - Retrieve a full page by title
+
* https://github.com/ominiverdi/matrix-llmagent
* <code>osgeo-knowledge_get_wiki_stats</code> - Show database and sync statistics
+
* https://github.com/ominiverdi/osgeo-knowledge
 +
* 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>
  
'''[[osgeo-library]] / doclibrary MCP tools:'''
+
== Maintainer ==
* <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
 
  
'''Contact:''' ominiverdi (Lorenzo Becchi) or SAC channel
+
* ominiverdi, Lorenzo Becchi
 +
* SAC channel
  
[[Category:Services]]
+
[[Category:Infrastructure]]
[[Category:AI-Services]]
 

Revision as of 10:15, 5 June 2026

LLM-based Chat Assistant

Experimental Matrix chat assistant running on the Gallery Container.

Verified on osgeo7-gallery: the active bridge process is:

bun connectors/matrix.ts

running from:

/home/ominiverdi/github/opencode-chat-bridge

Purpose

The assistant connects Matrix chat to an LLM agent with MCP tools for OSGeo-specific search and retrieval.

Observed MCP backends include:

Tool call display

The chat bridge may show MCP tool calls in messages, for example:

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

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

Related repositories

Verified repositories on Gallery:

Note: matrix-llmagent exists on Gallery, but the currently running Matrix bridge process is from opencode-chat-bridge.

Operations

Check the running bridge:

pgrep -af "bun connectors/matrix.ts"

Check active MCP processes:

pgrep -af "mcp|osgeo-knowledge|osgeo-library"

Maintainer

  • ominiverdi, Lorenzo Becchi
  • SAC channel