koan-ai-integration

Integrate chat endpoints, embeddings, and RAG workflows with vector search.

4|3|Updated Aug 18, 2025
One-click install
npx skills add https://github.com/sylin-org/koan-framework --skill koan-ai-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: koan-ai-integration
Source: https://github.com/sylin-org/koan-framework/tree/main/.claude/skills/ai-integration
Command: npx skills add https://github.com/sylin-org/koan-framework --skill koan-ai-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrating AI capabilities like chat, embeddings, and vector search into traditional applications can be complex, requiring separate libraries and data stores. This Skill provides a native, seamless way to embed AI directly into your Koan entities and workflows.

Core Features & Use Cases

  • Native Chat Endpoints: Easily expose AI chat functionality through standard controllers, leveraging configured AI providers.
  • Entity Embeddings: Store vector embeddings directly on your entities, enabling semantic search and similarity comparisons.
  • RAG Workflows: Build Retrieval-Augmented Generation (RAG) systems by combining vector search for relevant documents with AI chat for contextual answers.
  • Vector Search: Perform semantic searches on your data, finding related items based on meaning, not just keywords.
  • Use Case: Create a product catalog where users can search for "eco-friendly laptops" using natural language, powered by vector embeddings and AI, or build a customer support chatbot that answers questions based on your knowledge base.

Quick Start

To enable AI chat in your application, inject IAi into your controller and use it: public class ChatController : ControllerBase { private readonly IAi _ai; public ChatController(IAi ai) => _ai = ai; [HttpPost] public async Task<IActionResult> Chat([FromBody] ChatRequest request) { var response = await _ai.ChatAsync(new AiChatRequest { Messages = request.Messages }); return Ok(new { message = response.Content }); } }

Frequently Asked Questions about koan-ai-integration

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

FAQPage Schema
How do I add AI chat endpoints to my application?

AI chat endpoints expose conversational AI through standard controllers by injecting IAi and calling ChatAsync. Configure your AI provider (OpenAI or Ollama) and pass messages to receive contextual responses, enabling natural language interfaces without building custom chat infrastructure.

What is semantic search with embeddings and how does it differ from keyword search?

Semantic search uses vector embeddings to find documents by meaning rather than exact keyword matches. Store embeddings on entities and perform vector searches to discover related items—users searching "eco-friendly laptops" find products by intent, not just matching text.

Can I build a RAG system to answer questions from my knowledge base?

RAG (Retrieval-Augmented Generation) combines vector search to find relevant documents with AI chat for contextual answers. This Skill enables the full pipeline: store embeddings, retrieve semantically similar data, and generate answers grounded in your knowledge base.

Does this support both OpenAI and Ollama as AI providers?

Yes, the Skill supports configurable providers including both OpenAI and Ollama. Select your preferred provider during setup to power chat endpoints and embeddings with either cloud-hosted or self-hosted AI models.

How do I store and query vector embeddings on my data entities?

Entity embeddings store vector representations directly on your data objects, enabling semantic similarity comparisons and vector searches. Generate embeddings via your configured provider and query by meaning to power natural language discovery across your application.

What prerequisites do I need before integrating AI capabilities?

You need a Koan application, an AI provider account (OpenAI or Ollama instance), and access to data you want to embed or search. No additional libraries or data stores are required—AI integrates natively into your Koan entities and workflows.