kortix-teams

Connect Microsoft Teams and reply to conversations with live Adaptive Card progress updates.

20.2k|3.4k|Updated Oct 5, 2024
One-click install
npx skills add https://github.com/kortix-ai/suna --skill kortix-teams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kortix-teams
Source: https://github.com/kortix-ai/suna/tree/main/packages/starter/templates/managed/.kortix/opencode/skills/kortix-teams
Command: npx skills add https://github.com/kortix-ai/suna --skill kortix-teams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When an agent session is triggered from Microsoft Teams, it needs to connect the tenant, stream progress into the live Adaptive Card, deliver a final answer, and exchange files without manual token or app configuration.

Core Features & Use Cases

  • Tenant Connection: Run kortix channels connect --platform teams to print a Microsoft admin-consent URL that publishes the bot to the Teams catalog.
  • Live Progress Streaming: Use teams step with --detail, --output, and --source flags to update the Adaptive Card in place as work progresses, then finalize with teams send.
  • File Exchange: Offer artifacts via the consent-card flow with teams send --file and pull attachments into the sandbox with teams download.
  • Use Case: A teammate @-mentions the bot asking why errors spiked; the agent posts checkpoints while reading logs, then sends the root-cause answer and offers a PDF incident report.

Quick Start

Ask the agent to connect Microsoft Teams to this project and reply to the current Teams conversation with progress updates and a final answer.

Frequently Asked Questions about kortix-teams

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

FAQPage Schema
How do I connect Microsoft Teams to a Kortix project?

Run `kortix channels connect --platform teams`, which prints a Microsoft admin-consent URL. A tenant admin opens the link and grants consent, after which the app is published to the Teams catalog automatically with no manual app creation or tokens.

How do I show progress updates in a Teams conversation?

Use `teams step "<title>"` before each major phase to repaint the live Adaptive Card in place. Add `--detail` for context, `--output` for the closing step's result, and `--source` for citations, then finalize with `teams send`.

How do I send a file to a Microsoft Teams conversation?

Use `teams send --file <path>` with an optional `--text` description. This posts a consent card the user must accept before the upload completes, and it does not finalize the turn, so follow it with a regular `teams send`. The limit is about 4 MB.

Can I disconnect Teams using the kortix CLI?

No, `kortix channels disconnect` is Slack-only in this release. To remove a Teams installation, use the dashboard under Customize, then Channels.

Why should I not use the question tool on a Teams turn?

The built-in question tool is a synchronous web-UI and Slack construct with no Teams renderer, so calling it hangs or fails. Instead, ask the question with `teams send`, end the turn, and handle the reply when it arrives as a new turn.

Does Teams messaging use Slack markdown formatting?

No, Teams Adaptive Cards render standard Markdown, so use `**bold**` and `[label](url)` links. Slack-style `*single-asterisk*` bold and `<url|label>` links render as literal text in Teams.