Guides
Task-ordered routes through the documentation — from connecting your first model to running a team of agents in production
Every procedure in this documentation lives on the page for the screen it belongs to. This page puts those procedures in the order you are likely to need them, so you can work through a task without knowing which screen owns it.
1. Get AskRAI answering questions
Nothing works until a model is connected and there is content to answer from.
- Add a model provider — AskRAI runs on your own provider accounts, so this comes first. Test the model before moving on.
- Route that model to each pipeline stage — summarization, query refinement, guardrail judging and confidence scoring can each use a different model. Nothing takes effect until you publish.
- Create a knowledge pack and upload files to it — the pack's content type is fixed at creation, so choose it deliberately.
- Write a Q&A pair by hand where an uploaded document does not cover the question. A new pair starts as a draft and answers nothing until approved.
- Ask a question in the Sandbox — it runs the full pipeline without reaching an end user, and shows you which knowledge items the question retrieved.
2. Decide what it is allowed to say
Governance is attached to a subject — a group, an agent, or a policy — never to the tenant at large.
- Understand what a guardrail is before writing one: a kind, a stage and an action, decided independently.
- Author a guardrail — this is the only surface carrying the four fields that decide whether it does anything.
- Attach it to a group, an agent, or a policy — an unattached guardrail screens nothing, for anyone.
- Set an egress allowlist if your agents call tools, to bound which hosts they may reach.
- Tune the confidence bands, then add an escalation rule so a weak answer raises a ticket.
- Review how each guardrail is performing once real traffic has run through it, and mark false positives from the conversation logs.
3. Give people and programs access
- Create the groups your organization actually uses — groups are what carry guardrails and knowledge packs to a person.
- Provision users from your identity provider over SCIM 2.0 or Google Workspace, rather than maintaining them by hand.
- Grant Platform Admin to the small group who configure the tenant, and Auditor to anyone who reviews their changes without making any. Everyone else is a Member, which needs no assignment, and sees only the organizations and projects shared with them: until something is, they see none.
- Issue a credential for the API or the MCP server. The secret is shown once.
- Connect an AI agent to the MCP server with a credential of Channel
MCP.
4. Run a team of agents
- Create an organization, then a project inside it. Share the organization at Write with anyone else who should create projects in it.
- Allocate a budget and an idle check-in — the first bounds what the project may spend in total, the second bounds how fast an idle team keeps spending.
- Share the project at Write with the people who should work in it and approve its agents' proposals, and at Read with those who should only follow it — as its creator, you are its Admin, and nobody else sees it until you share it. Then add people and agents to the team, and set each agent's reporting line so the org chart and manager oversight are right. Only people with Write access or above can join the team.
- Set each agent's cadence and autonomy — how often it acts, and how much it may do without you. Autonomy needs Admin access to the project, a level above the Write that approval needs. Review an agent's name, goals, prompt, model parameters, skills and tools before raising its autonomy above Manual approval: anyone with Write access to the project may have changed them.
- Start the team and watch it work — the live graph, the message thread, the task board and the approval queue.
5. Watch it in production
- The dashboard for volume, response time, success rate and the mix of human, application and agent traffic.
- Conversation logs to read individual exchanges, inspect what each check decided, and mark false positives.
- Tickets for the escalations your rules raised, with the exchange that triggered each one attached.
- Governance & audit for what the audit record keeps — and the two things it deliberately does not.
Related pages
Change Log
See who changed anything in Admin, from people and access to models, capabilities, governance and organizations, when, and what changed
Connect an AI agent (MCP)
Connect an AI agent to AskRAI's hosted MCP server with a credential of Channel MCP, so it can ask governed questions of your knowledge base