Difference between revisions of "LLM-based Chat Assistant"

From OSGeo
Jump to navigation Jump to search
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
= LLM-based Chat Assistant =
 
= LLM-based Chat Assistant =
  
−
Experimental Matrix chat assistant running on the [[Gallery Container]].
+
Experimental LLM-based chat assistant bot available in the [[Matrix|OSGeo Matrix space]].
  
−
Verified on <code>osgeo7-gallery</code>: the active bridge process is:
+
The bot connects Matrix chat to an LLM agent and local MCP tools for OSGeo-specific search, wiki lookup, document search, and web/time/weather utilities.
 +
 
 +
== Access ==
 +
 
 +
The bot is available in the [[Matrix]] room:
  
 
<pre>
 
<pre>
−
bun connectors/matrix.ts
+
#lounge:osgeo.org
 +
#library:osgeo.org
 
</pre>
 
</pre>
  
−
running from:
+
Matrix identifier:
  
 
<pre>
 
<pre>
−
/home/ominiverdi/github/opencode-chat-bridge
+
@llm-assitant:matrix.org
 
</pre>
 
</pre>
  
−
== Purpose ==
+
The bot responds when mentioned, or when a line starts with:
  
−
The assistant connects Matrix chat to an LLM agent with MCP tools for OSGeo-specific search and retrieval.
+
<pre>
 +
!oc
 +
bot
 +
</pre>
 +
 
 +
Example:
 +
 
 +
<pre>
 +
!oc search the OSGeo wiki for board elections
 +
bot what is GeoNode?
 +
@llm-assitant:matrix.org find OSGeo documents about map projections
 +
</pre>
  
−
Observed MCP backends include:
+
== Usage notes ==
  
−
* [[Osgeo-knowledge-base]]
+
The assistant is experimental. It may make mistakes, especially for operational or infrastructure-critical questions. Verify important answers before acting on them.
−
* [[Osgeo-library]]
 
−
* web search MCP
 
−
* time MCP
 
−
* Open-Meteo MCP
 
  
−
== Tool call display ==
+
Do not send secrets, passwords, API keys, private tokens, or sensitive credentials to the bot.
  
−
The chat bridge may show MCP tool calls in messages, for example:
+
Tool calls may be visible in chat logs. This is normal. Example:
  
 
<pre>
 
<pre>
Line 36: Line 48:
 
</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.
 +
 
 +
== OSGeo Knowledge tools ==
 +
 
 +
These tools query [[Osgeo-knowledge-base]].
  
−
== 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
 +
* <code>osgeo-knowledge_search_entities</code> - Search people, projects, organizations, events
 +
* <code>osgeo-knowledge_get_entity_relationships</code> - Query entity relationships
 +
* <code>osgeo-knowledge_get_page</code> - Retrieve full page content
 +
* <code>osgeo-knowledge_get_wiki_stats</code> - Show database and sync statistics
  
−
Verified repositories on Gallery:
+
== OSGeo Library tools ==
  
−
* <code>/home/ominiverdi/github/opencode-chat-bridge</code>
+
These tools query [[osgeo-library]] through the <code>doclibrary</code> MCP server.
−
* https://github.com/ominiverdi/matrix-llmagent
 
−
* 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>.
+
* <code>doclibrary_search_documents</code> - Semantic search over document text and visual elements
 +
* <code>doclibrary_search_visual_elements</code> - Search figures, tables, equations, charts, and diagrams
 +
* <code>doclibrary_list_elements</code> - Browse document elements without semantic search
 +
* <code>doclibrary_get_element_details</code> - Retrieve metadata for a visual element
 +
* <code>doclibrary_get_element_image</code> - Retrieve a cropped element image
 +
* <code>doclibrary_get_page_image</code> - Retrieve a full page image
 +
* <code>doclibrary_get_document_info</code> - Show document metadata
 +
* <code>doclibrary_find_document</code> - Find a document by name or query
 +
* <code>doclibrary_list_documents</code> - List indexed documents
 +
* <code>doclibrary_get_library_status</code> - Check document library service status
 +
 
 +
== Technical details ==
 +
 
 +
* Host: [[SAC_Service_Status#osgeo7|osgeo7]]
 +
* Container: [[Gallery_Container|Gallery]]
 +
* Runtime path: <code>/home/ominiverdi/github/opencode-chat-bridge</code>
 +
* Running process: <code>bun connectors/matrix.ts</code>
 +
* Source: https://github.com/ominiverdi/opencode-chat-bridge
 +
* Maintainer: [[User:Ominiverdi]]
 +
 
 +
Language model: <code>opencode/big-pickle</code>, may change. Ask the bot for current model information.
  
 
== Operations ==
 
== Operations ==
  
−
Check the running bridge:
+
Check the bridge process on Gallery:
  
 
<pre>
 
<pre>
Line 63: Line 101:
 
</pre>
 
</pre>
  
−
== Maintainer ==
+
== Administration ==
 +
 
 +
TBD
  
−
* ominiverdi, Lorenzo Becchi
+
'''Contact:''' ominiverdi, Lorenzo Becchi, or SAC channel.
−
* SAC channel
 
  
−
[[Category:Infrastructure]]
+
[[Category:Services]]
 +
[[Category:AI-Services]]

Latest revision as of 11:26, 5 June 2026

LLM-based Chat Assistant

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

The bot connects Matrix chat to an LLM agent and local MCP tools for OSGeo-specific search, wiki lookup, document search, and web/time/weather utilities.

Access

The bot is available in the Matrix room: 

#lounge:osgeo.org
#library:osgeo.org

Matrix identifier: 

@llm-assitant:matrix.org

The bot responds when mentioned, or when a line starts with: 

!oc
bot

Example: 

!oc search the OSGeo wiki for board elections
bot what is GeoNode?
@llm-assitant:matrix.org find OSGeo documents about map projections

Usage notes

The assistant is experimental. It may make mistakes, especially for operational or infrastructure-critical questions. Verify important answers before acting on them.

Do not send secrets, passwords, API keys, private tokens, or sensitive credentials to the bot.

Tool calls may be visible in chat logs. This is normal. Example: 

> 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 tools

These tools query Osgeo-knowledge-base.

  • 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 full page content
  • osgeo-knowledge_get_wiki_stats - Show database and sync statistics

OSGeo Library tools

These tools query osgeo-library through the doclibrary MCP server.

  • doclibrary_search_documents - Semantic search over document text and visual elements
  • doclibrary_search_visual_elements - Search figures, tables, equations, charts, and diagrams
  • doclibrary_list_elements - Browse document elements without semantic search
  • doclibrary_get_element_details - Retrieve metadata for a visual element
  • doclibrary_get_element_image - Retrieve a cropped element image
  • doclibrary_get_page_image - Retrieve a full page image
  • doclibrary_get_document_info - Show document metadata
  • doclibrary_find_document - Find a document by name or query
  • doclibrary_list_documents - List indexed documents
  • doclibrary_get_library_status - Check document library service status

Technical details

Language model: opencode/big-pickle, may change. Ask the bot for current model information.

Operations

Check the bridge process on Gallery: 

pgrep -af "bun connectors/matrix.ts"

Check active MCP processes: 

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

Administration

TBD

Contact: ominiverdi, Lorenzo Becchi, or SAC channel.

Retrieved from "http://wiki.osgeo.org/w/index.php?title=LLM-based_Chat_Assistant&oldid=136031"