====== Integration ======
Das **Agent Collective Framework (ACF)** ist modular aufgebaut und darauf ausgelegt,  
sich nahtlos in bestehende Systeme, Netzwerke und Organisationsstrukturen zu integrieren.  
Diese Seite bietet einen Überblick über die Integrationsmöglichkeiten  
und verweist auf die zugehörigen Unterseiten.

===== Ziel der Integration =====
  * Einbindung lokaler Agenten in bestehende IT-Systeme  
  * Verbindung zwischen autonomen Agenten und externen Tools  
  * Aufbau sicherer, interoperabler Kommunikationspfade  
  * Förderung praktischer Nutzung in Forschung, Bildung und Industrie  

===== Integrationsarten =====
^ Typ ^ Beschreibung ^
| **Lokal** | Betrieb einzelner Agenten auf Endgeräten, Servern oder Edge-Systemen. |
| **Zonenbasiert** | Zusammenschluss mehrerer Agenten zu einer Organisationseinheit mit gemeinsamer Registry. |
| **Hybrid** | Verbindung lokaler Agenten mit Cloud-Komponenten über gesicherte Gateways. |
| **Cross-Zone** | Zusammenarbeit zwischen unterschiedlichen Zonen über das AGLX-Protokoll. |

===== Architekturkontext =====
Integration ist eine **Brückenschicht** zwischen ACF-Kern und der Außenwelt.  
Sie verbindet interne Module (Cognitive ↔ Execution) mit externer Infrastruktur:

<code>
┌──────────────────────────────┐
│   Lokale Agenten (on-prem)   │
│   └── Cognitive + Execution  │
└──────────────┬───────────────┘
               │  (AGLX / API)
┌──────────────┴───────────────┐
│     Zonen / Registry Layer   │
│   └── Governance & Discovery │
└──────────────┬───────────────┘
               │
┌──────────────┴───────────────┐
│ Externe Systeme & Anwendungen│
│  └── Tools, Dashboards, Cloud│
└──────────────────────────────┘
</code>

===== Typische Integrationsszenarien =====
| Szenario | Beschreibung |
|-----------|--------------|
| **Lokale Forschungslabore** | Einsatz mehrerer ACF-Agenten zur Simulation verteilter KI-Kollaboration. |
| **Unternehmensnetzwerke** | Integration in Intranet-Umgebungen mit interner Registry. |
| **Edge / IoT-Systeme** | ACF-Agenten auf Geräten mit limitierter Rechenleistung. |
| **Schulungs- und Lernplattformen** | Agenten als Lernobjekte in Trainingssystemen oder Kursplattformen. |
| **Hybride KI-Workflows** | Verbindung zwischen ACF-Agenten und bestehenden KI-APIs (z. B. HuggingFace, OpenAI, Ollama). |

===== Unterstützte Schnittstellen =====
^ Typ ^ Zweck ^
| **REST / JSON-API** | Standardisierte Kommunikation mit Webdiensten oder Management-Tools. |
| **AGLX (TCP/UDP)** | Direkte Peer-to-Peer-Kommunikation zwischen Agenten. |
| **WebSocket / MQTT** | Für Echtzeitkommunikation und Statusmeldungen. |
| **Redis / Local Bus** | Austausch zwischen lokalen Modulen oder Subagenten. |

===== Sicherheits- und Ethik-Integration =====
  * Alle externen Schnittstellen folgen der [[agent_collective_framework:sicherheit|Sicherheitsarchitektur]]  
  * Aktionen werden vor Ausführung durch das [[agent_collective_framework:ethik|Ethik-Framework]] geprüft  
  * Kommunikation zwischen Zonen erfolgt nur über signierte Sessions  
  * Zugriffskontrolle über Rollen und Trust-Level aus der [[agent_collective_framework:registry|Registry]]  

===== Beispiel: Hybrid-Integration mit REST-Bridge =====
<code yaml>
integration:
  type: "hybrid"
  components:
    - name: local_agent
      endpoint: tcp://192.168.91.10:2594
    - name: bridge
      api: https://api.acf.zone/v3/
      auth: registry_token
      mode: sync
</code>

===== Unterseiten =====
  * [[agent_collective_framework:integration:lokale_agenten|Integration lokaler Agenten]]  
  * [[agent_collective_framework:api|API-Integration & Schnittstellen]]  
  * [[agent_collective_framework:sicherheit|Sicherheit im Framework]]  
  * [[agent_collective_framework:prototypen|Prototypen & Proof-of-Concepts]]  

===== Zielbild =====
Integration ist das **Bindeglied zwischen ACF und der realen IT-Welt**.  
Sie ermöglicht die praktische Umsetzung der ACF-Prinzipien in Forschung, Industrie und Bildung,  
ohne zentrale Cloudabhängigkeiten und unter Wahrung vollständiger Datenhoheit.

----

**Verwandte Seiten:**  
  * [[agent_collective_framework:implementierung|Implementierung & Referenzarchitektur]]  
  * [[agent_collective_framework:api:interfaces|API & Schnittstellen]]  
  * [[agent_collective_framework:sicherheit|Sicherheit im Framework]]  
  * [[agent_collective_framework:registry|Registry & Zonen]]