plugin.yaml 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. name: teams-platform
  2. label: Microsoft Teams
  3. kind: platform
  4. version: 1.0.0
  5. description: >
  6. Microsoft Teams gateway adapter for Hermes Agent.
  7. Connects to Microsoft Teams via the Bot Framework and relays messages
  8. between Teams chats (personal DMs, group chats, channel posts) and
  9. the Hermes agent. Supports Adaptive Card approval prompts.
  10. author: Aamir Jawaid
  11. # ``requires_env`` entries are surfaced in ``hermes config`` UI via the
  12. # platform-plugin env var injector in ``hermes_cli/config.py``.
  13. requires_env:
  14. - name: TEAMS_CLIENT_ID
  15. description: "Azure AD application (Bot Framework) client ID"
  16. prompt: "Teams / Azure AD client ID"
  17. url: "https://portal.azure.com/"
  18. password: false
  19. - name: TEAMS_CLIENT_SECRET
  20. description: "Azure AD application client secret"
  21. prompt: "Teams / Azure AD client secret"
  22. url: "https://portal.azure.com/"
  23. password: true
  24. - name: TEAMS_TENANT_ID
  25. description: "Azure AD tenant ID hosting the bot application"
  26. prompt: "Teams / Azure AD tenant ID"
  27. password: false
  28. optional_env:
  29. - name: TEAMS_PORT
  30. description: "Webhook listen port (Bot Framework default: 3978)"
  31. prompt: "Webhook port"
  32. password: false
  33. - name: TEAMS_HOST
  34. description: "Webhook bind host (default: unset → dual-stack, all interfaces IPv4+IPv6)"
  35. prompt: "Webhook host"
  36. password: false
  37. - name: TEAMS_ALLOWED_USERS
  38. description: "Comma-separated Teams user IDs / UPNs allowed to talk to the bot"
  39. prompt: "Allowed users (comma-separated)"
  40. password: false
  41. - name: TEAMS_ALLOW_ALL_USERS
  42. description: "Allow any Teams user to trigger the bot (dev only)"
  43. prompt: "Allow all users? (true/false)"
  44. password: false
  45. - name: TEAMS_REQUIRE_MENTION
  46. description: "Only answer channel/group-chat messages that @mention the bot or reply to it (default false; needed once the app has RSC message-read consent)"
  47. prompt: "Require @mention in channels and group chats? (true/false)"
  48. password: false
  49. - name: TEAMS_HOME_CHANNEL
  50. description: "Default chat/channel ID for cron / notification delivery"
  51. prompt: "Home channel (or empty)"
  52. password: false
  53. - name: TEAMS_HOME_CHANNEL_NAME
  54. description: "Display name for the Teams home channel"
  55. prompt: "Home channel display name"
  56. password: false
  57. - name: TEAMS_INCOMING_WEBHOOK_URL
  58. description: "Incoming-webhook URL for meeting-summary delivery in webhook mode (the URL is the credential)"
  59. prompt: "Incoming webhook URL (or empty)"
  60. password: true
  61. - name: TEAMS_GRAPH_ACCESS_TOKEN
  62. description: "Microsoft Graph access token for meeting-summary delivery in graph mode"
  63. prompt: "Graph access token (or empty)"
  64. password: true