bot-framework

Documents Swiss AI Hub bot framework architecture, handlers, and multi-channel messaging logic.

9|2|Updated Nov 29, 2024
One-click install
npx skills add https://github.com/bbvch-ai/aihub-core --skill bot-framework
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bot-framework
Source: https://github.com/bbvch-ai/aihub-core/tree/main/.claude/skills/bot-framework
Command: npx skills add https://github.com/bbvch-ai/aihub-core --skill bot-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the need for developers to manually sift through scattered codebase documentation to understand the Swiss AI Hub bot integration framework's complex architecture, multi-channel handling logic, and production-grade patterns, reducing onboarding time and debugging effort for bot-related tasks.

Core Features & Use Cases

  • Full Architecture Reference: Covers the three-layer bot architecture (BaseChatBot, specialized bots, streaming variants), CompletionHandler strategy pattern, and end-to-end request flow from Azure Bot Service to agent response.
  • Multi-Channel Implementation Guidance: Includes detailed documentation for Teams, Slack, and WebChat handling, including Slack thread formatting, Teams conversation reuse logic, mention detection, and channel-specific edge cases.
  • BITL & State Management: Documents Bot-in-the-Loop (BITL) flows for human-in-the-loop agent workflows, conversation TTL configuration, MongoDB-backed conversation state tracking, and NATS event integration for agent communication.
  • Use Case: For example, a developer building a Slack integration for Swiss AI Hub agents can use this Skill to correctly implement thread handling and @mention logic, while an engineer debugging streaming response issues can reference the typing indicator lifecycle and CloudAdapter caching behavior to resolve problems quickly.

Quick Start

Use the bot-framework skill to explain how the CompletionHandler pattern routes messages between Slack channels and NATS-connected agents.

Frequently Asked Questions about bot-framework

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate a Slack bot with NATS-connected agents using a CompletionHandler pattern?▼

To integrate Slack bots with NATS-connected agents, the CompletionHandler pattern routes incoming messages from Slack channels to agents and delivers responses back through the messaging channel. It manages the end-to-end request flow from Azure Bot Service to the final agent response.

How does conversation state management work in a multi-channel bot framework?▼

Conversation state management in a multi-channel bot framework uses MongoDB-backed tracking and configurable TTL settings. It supports Bot-in-the-Loop (BITL) flows for human-in-the-loop agent workflows across MS Teams, Slack, and WebChat channels.

Can I use the bot framework to handle Slack thread formatting and @mention detection?▼

Yes, the bot framework supports Slack thread formatting and @mention detection. It provides detailed multi-channel implementation guidance for correctly handling Slack threads and mention logic, along with channel-specific edge case resolution.

What is the best way to debug streaming response issues in MS Teams or Slack bots?▼

The best way to debug streaming response issues is to reference the typing indicator lifecycle and CloudAdapter caching behavior. The framework's three-layer architecture provides specialized streaming variants to help engineers resolve these problems quickly.

Does the bot framework support Bot-in-the-Loop (BITL) workflows for human-in-the-loop agent processes?▼

Yes, the bot framework supports Bot-in-the-Loop (BITL) workflows for human-in-the-loop agent processes. It documents BITL flows, conversation TTL configuration, and NATS event integration to manage agent communication and state tracking.

Why are my Teams conversation reuse logic and channel-specific edge cases failing?▼

Teams conversation reuse logic and channel-specific edge cases may fail due to incorrect handler patterns or state management. The framework provides detailed implementation guidance for CompletionHandler patterns and channel-specific edge case resolution to fix these issues.