> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

> Connect external services to your Guild organization.

Integrations connect Guild to the external services your team uses — GitHub, Slack, Jira, and more. Once connected, agents can use these services through their tool sets.

## How integrations work

1. An admin connects a service at the organization level via **Settings > Credentials**
2. The integration becomes available to all workspaces in the organization
3. Agents use service tools (e.g. `gitHubTools`) to interact with the connected service
4. Authentication is handled automatically by the runtime

## Browse integrations

See the [Integrations directory](/integrations/overview) for the full catalog of connected services — GitHub, Slack, Jira, and many more — organized by category, each with setup details and the tools it provides.

Don't see what you need? You can [create your own integration](/services/create-an-integration) for any HTTP-accessible service.

## Using integrations in agents

Import the service's tool set and spread it into your agent's `tools` object:

```typescript theme={null}
import { gitHubTools } from "@guildai-services/guildai~github"

export default agent({
  // ...
  tools: { ...gitHubTools },
})
```

See [Tool sets](/sdk/tools) in the SDK reference for details on selecting specific tools.

## Requesting credentials at runtime

If an agent needs a credential that hasn't been connected, it can request one using `guildTools`:

```typescript theme={null}
import { guildTools } from "@guildai/agents-sdk"

// The user is prompted to connect the service
await task.guild?.credentials_request({ service: "github" })
```

See [Credentials](/platform/credentials) for setup details.