Difference between revisions of "LLM-based Chat Assistant"
Jump to navigation
Jump to search
Ominiverdi (talk | contribs) (→Access) |
|||
| (11 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | = LLM-based Chat Assistant = | |
| + | |||
| + | Experimental LLM-based chat assistant bot available in the [[Matrix|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 == | == Access == | ||
| − | The bot is available in the [[Matrix]] room < | + | The bot is available in the [[Matrix]] room: |
| − | + | ||
| − | The bot responds when mentioned | + | <pre> |
| + | #lounge:osgeo.org | ||
| + | #library:osgeo.org | ||
| + | </pre> | ||
| + | |||
| + | Matrix identifier: | ||
| + | |||
| + | <pre> | ||
| + | @llm-assitant:matrix.org | ||
| + | </pre> | ||
| + | |||
| + | The bot responds when mentioned, or when a line starts with: | ||
| + | |||
| + | <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> | ||
| + | |||
| + | == 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: | ||
| + | |||
| + | <pre> | ||
| + | > query=spam, limit=10 [osgeo-knowledge_search_content] | ||
| + | > query=spam, limit=10 [osgeo-knowledge_search_wiki] | ||
| + | </pre> | ||
| + | |||
| + | The prefix identifies the MCP server, and the suffix identifies the tool. | ||
| + | |||
| + | == OSGeo Knowledge tools == | ||
| + | |||
| + | These tools query [[Osgeo-knowledge-base]]. | ||
| + | |||
| + | * <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 | ||
| + | |||
| + | == OSGeo Library tools == | ||
| + | |||
| + | These tools query [[osgeo-library]] through the <code>doclibrary</code> MCP server. | ||
| + | |||
| + | * <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 | + | == Technical details == |
* Host: [[SAC_Service_Status#osgeo7|osgeo7]] | * Host: [[SAC_Service_Status#osgeo7|osgeo7]] | ||
* Container: [[Gallery_Container|Gallery]] | * 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]] | * Maintainer: [[User:Ominiverdi]] | ||
| − | + | ||
| − | + | Language model: <code>opencode/big-pickle</code>, may change. Ask the bot for current model information. | |
| + | |||
| + | == Operations == | ||
| + | |||
| + | Check the bridge process on Gallery: | ||
| + | |||
| + | <pre> | ||
| + | pgrep -af "bun connectors/matrix.ts" | ||
| + | </pre> | ||
| + | |||
| + | Check active MCP processes: | ||
| + | |||
| + | <pre> | ||
| + | pgrep -af "mcp|osgeo-knowledge|osgeo-library" | ||
| + | </pre> | ||
| + | |||
| + | == Administration == | ||
| + | |||
| + | TBD | ||
| + | |||
| + | '''Contact:''' ominiverdi, Lorenzo Becchi, or SAC channel. | ||
[[Category:Services]] | [[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 keywordsosgeo-knowledge_search_content- Search raw page content chunksosgeo-knowledge_search_entities- Search people, projects, organizations, eventsosgeo-knowledge_get_entity_relationships- Query entity relationshipsosgeo-knowledge_get_page- Retrieve full page contentosgeo-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 elementsdoclibrary_search_visual_elements- Search figures, tables, equations, charts, and diagramsdoclibrary_list_elements- Browse document elements without semantic searchdoclibrary_get_element_details- Retrieve metadata for a visual elementdoclibrary_get_element_image- Retrieve a cropped element imagedoclibrary_get_page_image- Retrieve a full page imagedoclibrary_get_document_info- Show document metadatadoclibrary_find_document- Find a document by name or querydoclibrary_list_documents- List indexed documentsdoclibrary_get_library_status- Check document library service status
Technical details
- Host: osgeo7
- Container: Gallery
- Runtime path:
/home/ominiverdi/github/opencode-chat-bridge - Running process:
bun connectors/matrix.ts - Source: https://github.com/ominiverdi/opencode-chat-bridge
- Maintainer: User:Ominiverdi
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.