Guide

Tools

Give your agents the ability to interact with GitHub, Slack, and external APIs.

Find it in

How It Works

1

Connect a service

Link GitHub or Slack in workspace settings

2

Add tools to agents

Choose which capabilities each agent has

3

Give instructions

Tell the agent what to do with those tools

GitHub

Connect GitHub to let agents work with repositories, issues, and pull requests.

RepositoriesIssuesPull requestsCommentsUsers
🐙

Example: Product Assistant

You assist the MoiAgent product team with the acme/moiagent repository.

Create issues for bug reports. Update existing issues when given new info.
Check for duplicates before creating. Never close issues without asking.

Slack

Connect Slack to let agents send messages, read channels, and interact with your team.

MessagesChannelsThreadsReactionsUsersFilesSearch
💬

Example: Deploy Notifier

You handle deployment notifications for the platform team.

Post to #deployments when told about releases. Never DM users directly.
For incidents, also post to #incidents with severity level.

Connecting a Service

1

Open Workspace Settings

2

Connect the Service

Click Connect next to GitHub or Slack. Complete the authorization in the popup.

3

Add Tools to Your Agent

Open your agent → Tools tab → Add Tool → Select the capabilities you want.

Security

Encrypted credentials

Your credentials are stored encrypted and never exposed

Minimal permissions

Only the permissions needed for the tools you enable

Revoke anytime

Disconnect services from workspace settings

Agent-level control

Enable only the specific tools each agent needs

Rate Limits

Tools are subject to the underlying service's rate limits:

GitHub: 5,000 requests/hour
Slack: ~20 requests/minute

Best Practices

Write clear tool descriptions

Good descriptions help the agent know when to use each tool. Include what the tool does and when it should be called.

Prefill parameters for guardrails

Lock down sensitive parameters (like channel names or repo paths) so the agent can't change them to access other resources.

Enable only needed tools

More tools = less security and more ways for the agent to do unintended things. Keep it minimal.

Troubleshooting

Tools not working?

  • • Check the service is connected in workspace settings
  • • Verify tools are enabled for the agent
  • • Make sure the agent has clear instructions on what to do

Connection expired?

Disconnect and reconnect the service in workspace settings to refresh credentials.

Next Steps