ADK Integration Management

When to Use This Skill

• Ask about integrations ("How do I add Slack?", "What integrations are available?")
• Want to connect an external service (Slack, WhatsApp, Linear, etc.)
• Mention

  adk add

  ,

  adk search

  ,

  adk info

  , or

  adk list

• Ask about

  agent.config.ts

  dependencies or the

  dependencies.integrations

  block
• Need help configuring an integration (OAuth, API keys, Control Panel)
• Ask about calling integration actions in code (

  actions.slack.*

  , etc.)
• Mention specific platforms or services they want their agent to interact with
• Get errors related to integration registration or configuration

Available Documentation

adk search

adk list

adk info

How to Answer

1. Start with CLI commands — Use

   adk search

   ,

   adk info

   ,

   adk list

   to get live data before suggesting anything. Run these via the Bash tool.
2. Confirm before running

   adk add

   — Always ask the user before adding an integration to their project.
3. Always specify version — Use

   adk add <name>@<version>

   rather than just

   adk add <name>

   .
4. Explain configuration requirements — After adding, tell the user what configuration is needed (OAuth link, API key, etc.) based on

   adk info --format json

   output.
5. Point to Control Panel — OAuth flows and credential entry happen in the Botpress Control Panel, not in code.

CLI Quick Reference

adk search <query>

--format json

--limit <number>

adk list --available

--format json

--limit <number>

adk list

--format json

--limit <number>

adk info <name>

--actions

--channels

--events

--full

--format json

adk add <name>@<version>

--alias <name>

--format json

Critical Patterns

Always Use the CLI

# CORRECT - Use adk add
adk add slack@3.0.0

# WRONG - Never manually edit agent.config.ts dependencies
# Don't hand-write entries in the dependencies.integrations block

Version Pinning

# CORRECT - Pin to specific version
adk add browser@0.8.6

# RISKY - Resolves to latest, may change unexpectedly
adk add browser

Accessing Integration Actions

// CORRECT - Import from @botpress/runtime, use alias from agent.config.ts
import { actions } from '@botpress/runtime'
await actions.slack.sendMessage({ channel: '#general', text: 'Hello' })

// The alias in agent.config.ts determines the accessor name
// { browser: { version: 'browser@0.8.6', enabled: true } }
await actions.browser.webSearch({ query: 'search term' })

Inspecting Config Requirements

# Use --format json to check what configuration an integration needs
adk info slack --format json

# Look at configuration.schema for required fields
# Look at configuration.identifier for OAuth
# Look at configurations for alternative config modes

Examples of Questions This Skill Answers

Beginner

• "What integrations are available?"
• "How do I add Slack to my agent?"
• "What is the browser integration?"

Intermediate

• "How do I configure WhatsApp in sandbox mode?"
• "What actions does the webchat integration provide?"
• "How do I call a Linear action from my workflow?"
• "What's the difference between chat and webchat?"

Advanced

• "How do I use a private workspace integration?"
• "What does

  registration_pending

  status mean?"
• "How do I alias an integration for cleaner code?"
• "How do I inspect an integration's config schema programmatically?"