Overview
Work with an AI teammate to keep your documentation accurate, complete, and up to date
GitBook Agent is an AI teammate that works alongside you. It helps you keep your documentation accurate, complete, and current. GitBook Agent is deeply integrated into GitBook. You don’t need new workflows to use it.
What can GitBook Agent do?
GitBook Agent can:
Write docs based on a prompt: Ask GitBook Agent to update a page, rename a product, or make any other change you need.
Import content into GitBook: Attach files like PDFs and Microsoft Word documents in a GitBook Agent conversation. GitBook Agent extracts and formats the content into pages in your section.
Plan and implement bigger changes: Describe what you need. GitBook Agent opens a change request, explains its edits, responds to feedback, and implements the plan you create together.
Follow your style guide: Define your team's writing rules in a style guide, and GitBook Agent treats it as the source of truth when writing or reviewing content.
Follow custom, site-level instructions: Give GitBook Agent site-specific instructions, such as how to add links or which block types to avoid.
Translate your documentation: Choose the content you want to translate, select a language, and GitBook Agent localizes your docs.
Summon from a comment: Add a comment to any block on your page, type
@gitbook, and tell GitBook Agent what you need.Review change requests: Add GitBook Agent as a reviewer on your change request. It can act as a docs linter, flag style guide issues, and suggest or fix errors.
Automatic documentation suggestions
GitBook Agent can also connect to the signals your team uses to understand your product and your customers’ needs: support conversations, tickets, and threads from your connected tools.
With this context, GitBook Agent can identify gaps, propose updates, and generate docs changes automatically.
As your docs evolve with your product, your customers get the right information when they need it.
Explore GitBook Agent’s features
Add a style guide and custom instructions
You can configure GitBook Agent with your team’s style guide and with site-specific instructions. GitBook Agent uses both whenever it creates or edits content for that site. If they conflict, the style guide wins.
Style guide: click Style guide in your site’s sidebar, then click Set up. Put the writing rules you want GitBook Agent to enforce here. For details, see Style guide.
Custom instructions: open your site’s Settings → Agents and add your instructions in the custom instructions field. Use them for site-specific directions, such as how to add links or which block types to avoid.
You can also open the Agents settings from a change request. Open GitBook Agent, then open Conversation options and click Configure GitBook Agent .
Custom instructions example
Here’s an example of the custom instructions you can add in GitBook Agent’s settings.
FAQs
Last updated
Was this helpful?