Skip to main content

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 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, slackTools) to interact with the connected service
  4. Authentication is handled automatically by the runtime

​
Integration Hub

IntegrationCategoryTools package
GitHubCode & CI/CD@guildai-services/guildai~github
Azure DevOpsCode & CI/CD@guildai-services/guildai~azure-devops
BitbucketCode & CI/CD@guildai-services/guildai~bitbucket
SlackCommunication@guildai-services/guildai~slack
JiraProject management@guildai-services/guildai~jira
ConfluenceProductivity@guildai-services/guildai~confluence
FigmaProductivity@guildai-services/guildai~figma
New RelicMonitoring@guildai-services/guildai~newrelic
CypressTesting@guildai-services/guildai~cypress
TestRailTesting@guildai-services/guildai~testrail
PipedreamAutomation@guildai-services/guildai~pipedream
Don’t see what you need? You can create your own 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: 
import { gitHubTools } from "@guildai-services/guildai~github"
import { slackTools } from "@guildai-services/guildai~slack"

export default agent({
  // ...
  tools: { ...gitHubTools, ...slackTools },
})
See Tool sets 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: 
import { guildTools } from "@guildai/agents-sdk"

// The user is prompted to connect the service
await task.guild?.credentials_request({ service: "github" })
See Credentials for setup details.