Kapa

Set what a connected Zendesk Tickets source ingests. Connect the source first: this persists the grant that connect_zendesk_tickets obtained.

configure_zendesk_tickets

Start connecting Google Drive, returning the URL the user approves at. Open the URL in the user's browser and wait for them to say they have approved it. The approval happens in the browser, so there is nothing to poll: ask the user, then call check_google_drive_connection once. The grant is held for the signed-in user and cleared once a source is configured with it. Connect again for each Google Drive source, and do not run two Google Drive setups at the same time.

connect_google_drive

Start connecting Salesforce, returning the URL the user approves at. Open auth_url in a browser where the user is signed in to Kapa, and wait for them to say they have approved it. Then call validate_salesforce_cases once to confirm the connection. The connection is held for the signed-in user for 30 minutes and cleared once a source is configured with it. Connect again for each Salesforce Cases source.

connect_salesforce_cases

Start connecting Salesforce for a private knowledge base, returning the URL the user approves at. A public knowledge base needs no connection. Open auth_url in a browser where the user is signed in to Kapa, and wait for them to say they have approved it. Then call validate_salesforce_knowledge once to confirm the connection. The source ingests what the approving Salesforce user can read. The connection is held for the signed-in user for 30 minutes and cleared once a source is configured with it.

connect_salesforce_knowledge

Start connecting a Zendesk Help Center source, returning the URL its owner approves at. Open auth_url in the user's browser and wait for them to say they have approved it. The approval happens in the browser, not here, so there is nothing to poll: ask the user, then call check_zendesk_helpcenter_connection once. The grant belongs to whoever approves it, so only that person can configure the source afterwards.

connect_zendesk_helpcenter

Start connecting a Zendesk Tickets source, returning the URL its owner approves at. Open auth_url in the user's browser and wait for them to say they have approved it. The approval happens in the browser, not here, so there is nothing to poll: ask the user, then call check_zendesk_tickets_connection once. The grant belongs to whoever approves it, so only that person can configure the source afterwards.

connect_zendesk_tickets

Create an API integration, for a user calling the retrieval or chat API from their own code. Pass its id as integration_id on those calls. A query sent without one has no integration attached and cannot be told apart from the project's other traffic in analytics, so create one per caller the user wants to measure separately. Separate from the API key, which is what authenticates the call.

create_api_integration

Create an API key for a project, so the user's own code can query it. The key is returned once, in `private_api_key`, and cannot be read back afterwards. Show it to the user and tell them to store it somewhere safe before moving on.

create_api_key

Create a GitHub discussions source in a project. Configure it with set_github_discussions_config before it can be ingested.

create_github_discussions_source

Create a GitHub files source in a project. Configure it with set_github_files_config before it can be ingested.

create_github_files_source

Create a GitHub issues source in a project. Configure it with set_github_issues_config before it can be ingested.

create_github_issues_source

Create a GitHub pull requests source in a project. Configure it with set_github_pull_requests_config before it can be ingested.

create_github_pull_requests_source

Create a hosted MCP server for this project, so the user's own agents can query their content. The server is served at <url_slug>.mcp.kapa.ai. Ask the user what slug they want rather than choosing one.

create_mcp_integration

Create an OpenAPI specification source in a project. Configure it with set_openapi_config before it can be ingested.

create_openapi_source

Create an S3 bucket source in a project. Configure it with set_s3_config before it can be ingested.

create_s3_source

Create a YouTube channel source in a project. Configure it with set_youtube_config before it can be ingested.

create_youtube_source

Create an Agent SDK integration, for a user building their own agent on Kapa's agent chat endpoint. Pass its id as integration_id on agent chat calls. A conversation sent without one has no integration attached and cannot be told apart from the project's other traffic in analytics, so create one per agent the user wants to measure separately. For a user calling the retrieval or chat API directly, use create_api_integration instead.

create_agent_integration

Create a Confluence source in a project. Configure it with set_confluence_config before it can be ingested.

create_confluence_source

Create a custom question and answer source in a project. Configure it with add_custom_qa_pair before it can be ingested.

create_custom_qa_source

A customization sets how Kapa answers: the assistant's name, its style and tone, its language, and the guardrails and boundaries it keeps. It takes effect on the integrations it is assigned to, such as a widget, Slack bot or API integration. Create a customization in a project. Call list_chat_models first: it lists the chat models a customization can be built on and the sections and fields each one offers, with their defaults. A new customization changes no answers until it is assigned to an integration with set_integration_customization.

create_customization

Create a Discord bot integration, so Kapa answers questions in a Discord channel. Two steps: create it here with the server and channel ids, then have a Discord server administrator add the Kapa Discord app and send !kapa_enable_channel followed by the integration id in that channel. It answers nothing until then, and there is no tool to enable it for them. Ask the user for the ids. Discord only shows them once Developer Mode is on, under User Settings then Advanced, after which Copy Channel ID and Copy Server ID appear on the right click menu.

create_discord_bot_integration

Create a Discord channel source in a project. Configure it with set_discord_config before it can be ingested.

create_discord_source

Create a Discourse forum source in a project. Configure it with set_discourse_config before it can be ingested.

create_discourse_source

Create a Google Drive source in a project. Connect it with connect_google_drive before configuring it.

create_google_drive_source

Create a Jira Service Management source in a project. Configure it with set_jira_service_management_config before it can be ingested.

create_jira_service_management_source

Create a Jira source in a project. Configure it with set_jira_config before it can be ingested.

create_jira_source

Create a Notion source in a project. Configure it with set_notion_config before it can be ingested.

create_notion_source

Create a Salesforce Cases source in a project. Connect it with connect_salesforce_cases before configuring it.

create_salesforce_cases_source

Create a Salesforce Knowledge source in a project. For a private knowledge base, connect it with connect_salesforce_knowledge before configuring it.

create_salesforce_knowledge_source

Create a Slack bot integration, so Kapa answers questions in a Slack channel. Two steps: create it here with the workspace and channel ids, then have a Slack workspace admin install the Kapa Slack app, invite it to the channel, and run /kapa-enable-channel followed by the integration id in that channel. It answers nothing until then, and there is no tool to enable it for them. Ask the user for the ids. In Slack the channel id is under View channel details and starts with C; the workspace id starts with T.

create_slack_bot_integration

Create a Slack channel source in a project. Configure it with set_slack_config before it can be ingested.

create_slack_source

Create a support form deflector, which answers a user before they file a support ticket.

create_support_form_deflector_integration

Create a web crawl source in a project.

create_web_crawl_source

Create a website widget integration, the chat bubble embedded in a documentation site. Answers with the integration and its id, which the embed snippet on the dashboard's integrations page uses.

create_widget_integration

Create a Zendesk Help Center source in a project. Connect it with connect_zendesk_helpcenter before configuring it.

create_zendesk_helpcenter_source

Create a Zendesk Tickets source in a project. Connect it with connect_zendesk_tickets before configuring it.

create_zendesk_tickets_source

Delete one question and answer pair. This cannot be undone, so confirm with the user before calling it.

delete_custom_qa_pair

Delete a customization. The integrations it is assigned to go back to Kapa's default answers. This cannot be undone, so confirm with the user before calling it.

delete_customization

Delete a source and everything ingested from it. This cannot be undone, so confirm with the user before calling it. Refused while the source is already being deleted.

delete_source

Suggest a content selector from the pages the preview crawl fetched. Answers with {"config": null} when there is nothing to detect from, which means the preview crawl has not run or found no pages. Nothing is saved: pass what it suggests to set_content_selector, ideally after checking it with inspect_content_selector.

detect_content_selector