Skip to content

docs(adk): rewrite Managing Integrations page#451

Open
jacksonyzj wants to merge 11 commits intomasterfrom
feat/adk-integrations-restructure
Open

docs(adk): rewrite Managing Integrations page#451
jacksonyzj wants to merge 11 commits intomasterfrom
feat/adk-integrations-restructure

Conversation

@jacksonyzj
Copy link
Copy Markdown

Summary

Rewrite the Managing Integrations page to reflect the current ADK integration workflow: string shorthand format in agent.config.ts and configuration via the Control Panel.

Tickets

# Ticket Page
1 ADK-300 Managing Integrations

Key changes

  • Rewrote for string shorthand format (object format deprecated)
  • Added discovery section: adk search, adk list --available, adk info
  • Integration configuration now via Control Panel, not agent.config.ts
  • Added real CLI output examples
  • Added status table for Control Panel cards
  • Added "Using integrations in code" section

Test plan

  • Preview via Mintlify staging deployment
  • Verify all CLI commands match actual output
  • Verify all internal links resolve

@jacksonyzj jacksonyzj marked this pull request as ready for review April 7, 2026 18:47
@jacksonyzj jacksonyzj requested a review from adkah as a code owner April 7, 2026 18:47
@mintlify
Copy link
Copy Markdown

mintlify bot commented Apr 7, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
botpress 🟢 Ready View Preview Apr 7, 2026, 6:57 PM

Copy link
Copy Markdown
Collaborator

@adkah adkah left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work, just a few comments

@jacksonyzj jacksonyzj requested review from a team, aj-botpress and maanav-rajesh April 8, 2026 15:31
Copy link
Copy Markdown

@maanav-rajesh maanav-rajesh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work! Just a few comments about the new integrations format

## Configuring integrations

You can also update the version it manually:
Integration settings (API keys, tokens, OAuth credentials) are managed in the Control Panel, not in `agent.config.ts`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion: I think it's worth it to explicitly mention that this is behaviour that changed from before and add a walkthrough of the migration steps in the CLI (the modal that pops up and asks users to switch to the new format)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants