> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-ak-docs-20-document-updating-variables-from-outsid.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing integrations

Integrations connect your agent to external services and platforms. This guide covers how to add, configure, and manage integrations in your ADK project.

## Adding integrations

### Using the CLI

Add an integration using the `adk add` command:

```bash theme={null}
adk add webchat
adk add slack@latest
adk add my-workspace/custom-integration@1.0.0
```

### Using an alias

Add an integration with a custom alias:

```bash theme={null}
adk add webchat --alias custom-webchat
```

This automatically:

* Adds the integration to `agent.config.ts`
* Generates TypeScript types for the integration

### Manual configuration

You can also manually edit `agent.config.ts`:

```typescript theme={null}
export default defineConfig({
  // ... other config ...
  dependencies: {
    integrations: {
      webchat: {
        version: "webchat@latest",
        enabled: true,
      },
      slack: {
        version: "slack@0.5.0",
        enabled: true,
      },
    },
  },
});
```

After editing manually, run `adk dev` or `adk build` to regenerate types.

## Integration versions

Integration versions use the format `name@version`:

* `webchat@latest` - Use the latest version
* `slack@0.5.0` - Use a specific version
* `my-workspace/custom@1.2.3` - Use an integration from a specific workspace

<Tip>
  Use `@latest` when you want to automatically receive updates. Use specific versions for production deployments to ensure stability.
</Tip>

## Enabling and disabling

Control which integrations are active:

```typescript theme={null}
dependencies: {
  integrations: {
    webchat: {
      version: "webchat@latest",
      enabled: true,
    },
    slack: {
      version: "slack@latest",
      enabled: false,
    },
  },
}
```

Disabled integrations are still included in your project but won't be active when your agent runs.

## Integration configuration

If you install an integration that requires configuration, you'll receive a message instructing you to configure it:

```bash theme={null}
adk add instagram
```

```text theme={null}
✓ Added instagram version x.x.x to agent.config.ts

Please configure it in the UI using the adk dev command to start using it.
```

## Updating integrations

To update an integration:

### Using the CLI

```
adk upgrade <integration-name>
```

### Manually

You can also update the version it manually:

1. Update the version in `agent.config.ts`:
   ```typescript theme={null}
   dependencies: {
     integrations: {
       webchat: {
         version: "webchat@0.3.0",
         enabled: true,
       },
     },
   }
   ```

2. Run `adk dev` or `adk build` to regenerate types

3. Test your agent to ensure compatibility

## Removing integrations

### Using the CLI

Remove an integration using the `adk remove` command:

```bash theme={null}
adk remove <integration-name>
```

### Manually

You can also remove an integration by deleting it from `agent.config.ts`:

```typescript theme={null}
dependencies: {
  integrations: {
    webchat: {
      version: "webchat@latest",
      enabled: true,
    },
    // Removed slack integration
  },
}
```

Run `adk dev` or `adk build` to update generated types.

<Tip>
  Always test your agent after adding, updating, or removing integrations to ensure everything works correctly.
</Tip>