TIA Documentation

Status: maintained; review after major changes.

TIA (The Intelligence Agency) is an experimental multi-agent system built on open standards: XMPP for messaging, RDF for knowledge representation, and semantic protocols for inter-agent coordination. The system implements Model-First Reasoning (MFR), where specialized agents collaboratively construct explicit problem models before generating solutions.

Key features:

🤖 Multiple specialized AI agents (Mistral, Prolog, Data, Semantic)
📊 RDF-based knowledge representation and SHACL validation
🔄 Lingue protocol for language mode negotiation
🌐 XMPP/Jabber for federated, real-time communication
🔧 Model Context Protocol (MCP) integration
✅ Constraint-based reasoning with verifiable solutions
🧭 Planning polls that route questions to logic, consensus, or adaptive roles
🧾 Verbose traces sent to a dedicated log room

Quick links:

💬 TIA Live Chat - Join general@conference.tensegrity.it
🐙 GitHub Repository
📖 Lingue Protocol Specification

🚀 Getting Started

Quick Start Guide - Get up and running with TIA agents
MFR Quick Start - Model-First Reasoning system setup
Agent Roster - All agent profiles at a glance
Agent Overview - Capabilities and commands for each agent
System Architecture - Agent runtime, profiles, and DI overview
Log Room Notes - How verbose traces are handled

🏗️ Model-First Reasoning (MFR)

The core innovation of TIA: explicit model construction before reasoning.

Core Documentation

MFR Architecture Overview - Four-phase problem solving workflow
MFR Usage Guide - Practical guide to using MFR
MFR API Reference - Complete API documentation
MFR Agent Contracts - Expected agent behaviors

Agent Contracts

Individual specifications for each MFR agent:

Coordinator Agent - Orchestrates the MFR protocol
Data Agent - Wikidata/DBpedia knowledge grounding
Mistral Agent - NLP entity extraction and explanation
Prolog Agent - Logical reasoning and plan generation
MFR Semantic Agent - Constraint identification
Semem Agent - Knowledge base integration

Testing & Room Setup

MFR Room Creation & Testing - Prosody MUC configuration

Experimental Features

MFR Debate Integration ✅ - Tool selection through structured dialogue (Phase 1 complete, enabled by default in config/agents/coordinator.ttl)
MFR Debate Requirements - Implementation requirements ensuring zero breaking changes

🔌 Integration Protocols

Lingue Protocol

Language mode negotiation for multi-agent communication:

Lingue Integration - How agents negotiate communication modes
IBIS Structured Dialogue - Issue-Based Information System vocabulary
Lingue Development Plan - Protocol development roadmap

Model Context Protocol (MCP)

Integration with external tools and services:

MCP Overview - Model Context Protocol introduction
MCP Server Guide - Exposing TIA as an MCP server
MCP Client Guide - Consuming external MCP services
MCP Development Plan - MCP integration roadmap

🛠️ Development & Customization

Agent Development Guide - Creating new agents
Provider Guide - Building custom agent providers
API Reference - Core API documentation
Auto-Registration - Automatic credential management
Testing Guide - Running tests and validation

📚 Specialized Topics

Data Agent Deep Dive - SPARQL queries, Wikidata integration
Debating Society - Chair, Recorder, and structured debates
Server Deployment - Production deployment considerations
TBox Note - Ontology design notes

📝 Blog Posts & Updates

Archived updates live in docs/archive/ (see Archive section).

🔧 Internal Documentation

Planning documents and development notes:

Internal planning notes were moved to the archive.

Documentation Organization

This documentation is organized hierarchically:

Getting Started - For new users and quick setup
MFR System - Core multi-agent reasoning documentation
Integration Protocols - Lingue and MCP integration guides
Development - For developers extending TIA
Specialized Topics - Deep dives into specific components
Blog/Updates - Progress reports and announcements

Contributing

TIA is open source and welcomes contributions. See the GitHub repository for issues, pull requests, and development discussion.

License

See repository for license information.