FIELD GUIDE / 001
KNOWLEDGE SYSTEMS. REAL BUSINESS VALUE.

Build the assistant.
Earn the client’s trust.

Your practical guide to building internal knowledge assistants—and turning your engineering skills into work that clients value.

Start focused.
Prove it works.

Choose one customer group, one platform, and one valuable workflow. Build a bounded pilot with reliable sources, correct permissions, and measurable results. Expand when the evidence supports it.

CHAPTER 01

Qualifications

Skills and proof of your work

CHAPTER 02

Platforms and opportunities

Choose your stack and find your market

CHAPTER 03

Winning clients

Positioning, proposals, and pricing

CHAPTER 04

Delivery and roadmap

Turn a pilot into a reliable service

CHAPTER 05

Client templates

Practical drafts to make your own

CHAPTER 06

Sources

Official references and research notes

YOUR WORKING TOOLKITWord guide ↓Prospect tracker ↓Evaluation sheet ↓

Prepared for an AI engineer exploring freelance consulting, employment, and a future agency. Pricing and performance targets are illustrative—not market benchmarks or promised results.

CHAPTER 01

Qualifications

Skills and proof of your work

Clients need confidence that you can deliver a useful service and protect their information. Your qualifications should therefore combine application engineering, retrieval, access control, evaluation, and customer communication. A certificate can support that evidence; a working system and a clearly explained evaluation are stronger demonstrations of delivery ability.

What the product actually does

An internal knowledge assistant helps an employee answer questions using company sources such as policies, product documentation, support procedures, or engineering runbooks. Retrieval augmented generation, usually called RAG, retrieves relevant evidence and gives it to a language model to compose an answer. The answer should identify its sources and acknowledge when the evidence is missing or conflicting.

This is a good starting pattern when facts change and sources must remain inspectable. Fine-tuning is a separate technique for adapting model behavior and is usually not the first solution to frequently changing company knowledge. First determine whether the customer's existing search or built-in assistant already solves the problem.

A useful first scope is question answering with source links and human escalation. Adding actions such as changing records or sending messages requires separate authorization, validation, and operational controls.

Skills you should be able to demonstrate

Area Practical capability Evidence to show
Backend development Build authenticated APIs, validate inputs, handle timeouts, retries, and concurrent requests A deployed service and readable code
Programming and data Use Python or TypeScript confidently, query SQL, work with JSON and HTTP APIs A connector and ingestion pipeline
Document processing Extract text and tables, recognize OCR failures, preserve document identity and versions An ingestion report with rejected files
Retrieval Compare keyword and vector retrieval, add metadata filters, test reranking where useful Results against a fixed question set
Language model integration Manage context, structured outputs, citations, streaming, and fallback behavior Examples of grounded answers and abstentions
Identity and authorization Understand SSO, OAuth/OIDC, groups, tenant boundaries, and least privilege Tests with users who have different permissions
Cloud operations Deploy, manage secrets, collect safe logs, set budgets, restore service, and roll back changes Deployment instructions and an operations runbook
Evaluation Separate retrieval failure from answer failure and measure both A versioned evaluation report
Product discovery Identify repeated work, baseline its cost, and define a narrow outcome A discovery brief and pilot acceptance criteria
Commercial delivery Estimate scope, manage dependencies, explain tradeoffs, and train users A sample proposal and handover checklist

You do not need every framework. Learn one backend stack, one retrieval implementation, one cloud or managed platform, and one communication channel deeply enough to debug them. Add tools when a real requirement justifies them.

A reference architecture you should understand

Think of two connected flows.

Ingestion: approved source → connector → extraction and validation → chunks plus document metadata and access rules → searchable index.

Answering: signed-in user → server-side identity and group resolution → authorized retrieval → optional reranking → answer from retrieved evidence → citation validation → response and limited operational telemetry.

The index is not the original authority on who may see a document. You must define how source permissions are synchronized or checked at query time. Access rules belong in retrieval and service enforcement; a prompt saying “do not reveal confidential data” does not provide authorization.

Store enough provenance to explain an answer: source ID, source URL, version, timestamps, chunk location, and applicable access metadata. Handle document deletion and permission revocation as first-class events. Account for cached answers, conversation history, logs, and backups when deciding how long sensitive material can remain accessible.

Use tenant-specific isolation and enforce tenant filters on the server. Never accept a client-provided tenant ID as sufficient proof of access. Rerankers, model providers, and tracing systems also receive data and belong in the data-flow review.

Common failures and what a qualified engineer does

Failure Likely cause Engineering response
Fluent but wrong answer Missing evidence or unsupported synthesis Inspect retrieval, require evidence, improve abstention
Wrong policy version Stale ingestion or ambiguous source ownership Track versions, owners, effective dates, and conflicts
Employee sees restricted content Incorrect identity mapping or access filtering Block exposure, fix the authorization path, rerun negative tests
Good results only on demo questions Evaluation leakage or an easy dataset Hold out questions and include difficult real queries
Poor answers on PDFs Extraction, layout, or OCR errors Inspect extracted text before tuning prompts
Costs rise unexpectedly Long context, retries, excessive calls, or heavy ingestion Measure cost per successful task and set budgets
Users stop using it Poor workflow fit, slow answers, or low trust Observe real tasks and improve usability and knowledge quality

Documents can contain malicious instructions. Treat retrieved material as untrusted content and constrain what the system can do with it. OWASP identifies prompt injection, sensitive information disclosure, excessive agency, and vector-related weaknesses among relevant application risks. Use its taxonomy to structure realistic tests. OWASP GenAI risks

Three portfolio projects with distinct purposes

Project one shows business usefulness

Build a support knowledge assistant with synthetic product manuals, escalation rules, and known issues. Demonstrate five tasks: answer a common question, cite an exact procedure, distinguish product versions, identify conflicting instructions, and escalate a question absent from the corpus.

Deliver a short video, a simple architecture diagram, a repository with setup instructions, and an evaluation report. Explain the dataset size and limitations. A synthetic demonstration is useful evidence of engineering, but must not be presented as a customer deployment.

Project two shows enterprise readiness

Extend a system with at least three roles, restricted sources, document updates, and permission revocation. Demonstrate that a user without access cannot retrieve restricted chunks or infer restricted titles through citations. Test cross-session caches and mixed-permission conversations.

Document exactly which access patterns you tested. A finite suite finding no leakage is a release gate, not proof that all possible leakage is impossible.

Project three shows commercial judgment

Choose a platform already used by a plausible customer and compare its native assistant with a limited custom implementation. Use the same questions, source documents, and permission cases. Compare setup effort, quality, ongoing cost, operational ownership, and gaps.

Your conclusion may favor the native product. Showing that you can recommend the lower-maintenance option establishes credibility with buyers.

Readiness levels

You are ready for a discovery engagement when you can interview users, map sources and permissions, evaluate feasibility, and write an honest scope. You can do this before you are ready to promise a production deployment.

You are ready for a bounded pilot when you can deploy securely, measure results, demonstrate authorized retrieval, document limitations, and provide support during the pilot. Use senior support or a delivery partner for areas beyond your competence.

You are ready to own production when you can handle monitoring, incidents, rollback, data lifecycle changes, customer handover, and ongoing quality evaluation. Company-wide or sensitive deployments may require security and infrastructure specialists.

Credentials and formal education

For consulting, prioritize credentials that match the systems your buyers already use. For employment, check the actual role requirements: some employers require a degree, others emphasize applied experience. There is no single certificate that proves you can safely deliver every internal assistant.

Microsoft offers an Applied Skills credential for building an agent in Copilot Studio, with an assessment covering configuration, knowledge, topics, tools, and publication. It is a relevant option for a Microsoft-focused service. Verify the active assessment before investing time because credential catalogs change. Microsoft credential

For an AWS or Google Cloud route, start with identity, deployment, data services, and the platform's AI documentation. Choose a current credential only after examining the requirements of your target roles or partner program. Do not collect unrelated badges while postponing a portfolio.

A practical self assessment

Score each skill area from zero to three: zero means unfamiliar, one means tutorial experience, two means independent implementation, and three means you can operate and debug it. Record a link to evidence for each score.

Before selling a pilot, aim for at least level two in the areas the scope depends on. Treat missing authorization or evaluation skills as blocking gaps even if your overall average looks good. Use the weakest essential area to choose your next learning task.

Back to overview ↑
CHAPTER 02

Platforms and opportunities

Choose your stack and find your market

There are three different choices: the platform you implement, the channel through which you find work, and the type of organization that buys your work. Choose them together. A familiar platform with reachable buyers is a better starting point than a technically attractive stack with no route to customers.

Platforms you can build on

The fit recommendations below are practical judgments. They are not claims about market share or guaranteed demand. Confirm edition, connector behavior, identity integration, commercial terms, and deployment region for each client.

Platform route Best initial fit Service you could offer What to validate first
Microsoft Copilot Studio with Teams and SharePoint Companies already managing knowledge in Microsoft 365 Department assistant, source cleanup, identity configuration, evaluation, adoption Tenant access, licensing, supported channel, permissions, source limits
Atlassian Rovo Teams using Confluence and Jira Knowledge readiness, search evaluation, tailored workflows, adoption Existing Rovo capabilities, connected sources, permissions, edition
Google Cloud Gemini Enterprise Organizations considering Google's enterprise AI environment Data connection, identity setup, workflow evaluation, custom integration Exact product edition, connector access rules, IAM and source authorization
Amazon Bedrock Knowledge Bases AWS-based teams building an application Custom retrieval application, ingestion, evaluation, operations End-user authorization design, storage, region, model access, cost
Glean ecosystem Organizations adopting enterprise search and AI Implementation, integration, agent work, managed services Procurement, customer platform access, partner requirements
Custom application Buyers with a demonstrated gap in native products Bespoke workflow, specialized retrieval, custom user experience Maintenance budget, security ownership, integration complexity

Microsoft documents user-permission-aware SharePoint grounding in Copilot Studio, subject to its authentication configuration and integration limitations. That makes it worth evaluating for an existing Microsoft environment, but it does not remove the need for tenant-specific tests. SharePoint integration

Rovo Search retrieves across connected tools and Atlassian sources. Start by testing that existing capability before proposing a replacement. Rovo Search

Google documents separate IAM roles and access scopes for Gemini Enterprise resources. Treat cloud resource authorization and an employee's document permissions as separate design questions. Google access controls

Bedrock provides retrieval and retrieval-plus-generation APIs, including source citations in the combined response. This supplies infrastructure for an application; your implementation still needs an appropriate user access model. Bedrock retrieval

Glean explicitly lists implementation and managed services among partner activities. This creates a possible consulting route, subject to acceptance and access. Glean partners

How to choose your first platform

Score each realistic route from one to five on customer access, your current skills, available demo access, workflow fit, and delivery effort. Give customer access and workflow fit double weight. Reject any choice that cannot meet required permissions or operating constraints, regardless of its score.

A Microsoft route is a reasonable default if you can reach Microsoft 365 customers and their administrators. An Atlassian route is sensible if you know engineering or support teams already using Confluence. An AWS or custom route fits strong backend engineers with buyers who need application integration. Treat these as starting hypotheses to test in customer conversations.

Avoid learning all platforms simultaneously. Spend your first month on one route and maintain a simple comparison with alternatives. You should be able to explain when your chosen platform is the wrong fit.

Where to find freelance clients

Channel Best use Action this week Limitation
Existing professional network Fast access to trusted conversations Ask five contacts about recurring internal questions Small initial reach
Software agencies and IT service firms Subcontracting and delivery partnerships Contact five firms with a specific capability and demo Lower margin and less client ownership
Upwork Finding scoped implementation requests Search targeted terms and write selective proposals Competitive; scope and buyer quality vary
Malt Professional freelance discovery in supported markets Build a focused profile and verify onboarding eligibility Country and commercial terms vary
LinkedIn Finding buyers, employers, and partners Publish a technical demo and contact relevant people individually Generic mass outreach performs poorly as a relationship strategy
Vendor partner ecosystems Implementation and referral relationships Research firms already serving your chosen ecosystem Admission and leads are not guaranteed
Practitioner communities and local events Building credibility and learning buyer language Answer a real technical question or demonstrate a failure case Relationships take time

Upwork has a chatbot services category; use that as a discovery entry point, not evidence that a particular buyer has an active budget. Search terms include “internal knowledge assistant,” “RAG,” “Copilot Studio,” “SharePoint chatbot,” and “enterprise search.” Upwork services

Malt provides a freelancer marketplace and profile-based client discovery. Check the terms for your own market before assuming fee, onboarding, or payment conditions. Malt freelancers

Partner channels are often a second-stage route. For example, n8n's expert partner page currently describes an application process for established agencies and integrators and asks for existing customer experience. Start by delivering projects or collaborating with established partners rather than assuming immediate directory admission. n8n expert partners

For your first month, allocate roughly half your business-development time to warm contacts and agencies, a quarter to carefully selected marketplace opportunities, and a quarter to portfolio visibility and community participation. This is a suggested experiment, not a measured conversion formula.

Which clients to target

A useful initial customer has repeated questions, reasonably maintained source material, a clear owner, reachable users, and authority to fund a pilot. Headcount alone is a weak signal. A 40-person team with a painful workflow can be more suitable than a large company with fragmented ownership.

Customer group Initial workflow Likely champion Economic buyer Common obstacle
B2B software support Find approved answers and escalation procedures Support lead Head of support or operations Outdated or conflicting documentation
Internal IT Answer common setup and access-process questions Service desk manager IT director Identity and security approval
Professional services Find approved templates and internal procedures Operations manager COO or practice leader Client confidentiality boundaries
Engineering teams Find runbooks and system documentation Engineering manager VP engineering or platform leader Missing knowledge and rapid change
Sales enablement Find approved product and proposal information Enablement manager Sales operations leader Conflicting commercial claims

Use generic policy and process knowledge before introducing personal HR records, customer secrets, or high-consequence decision support. Scope should match your experience and the client's controls.

Look for observable triggers: growth in support volume, onboarding problems, a migration of documentation, a new knowledge-management owner, or a failed assistant trial. Treat each trigger as a reason to investigate, not proof that a company needs your service.

Where you can work as an employee

Target applied AI engineering teams, enterprise software companies, consultancies, systems integrators, internal IT teams, and platform providers. Search for AI Engineer, Applied AI Engineer, LLM Engineer, AI Solutions Engineer, AI Consultant, Search Engineer, and Forward Deployed Engineer. Responsibilities vary more than titles.

Use LinkedIn AI engineering searches for broad discovery and Wellfound for startup roles. Verify each opening on the employer's own site before applying. These are discovery channels, not a list of confirmed suitable vacancies.

For engineering roles, emphasize code quality, retrieval evaluation, deployment, and incidents you can explain. For solutions roles, emphasize discovery, demonstrations, integration decisions, and communication with customers. For consultancy roles, add scope control, documentation, and handover.

Check location, language, time-zone overlap, work authorization, and remote-work restrictions for each role. “Remote” does not necessarily mean available worldwide.

Consulting versus employment versus a product

Consulting is useful when you can sell and deliver a bounded outcome. Employment can be a better route if you need production experience, mentorship, or reliable income. An agency becomes viable when delivery is repeatable and you can maintain quality through others. A product becomes credible when several customers share the same workflow and will pay for a common solution.

Do not build a multi-tenant SaaS product merely because two demos look similar. Validate common requirements, support load, security obligations, and a repeatable customer acquisition channel first.

Back to overview ↑
CHAPTER 03

Winning clients

Positioning, proposals, and pricing

Persuade clients by reducing uncertainty: understand the workflow, show relevant evidence, bound the scope, and agree on how success will be measured. A buyer needs to believe the problem matters, you can deliver, and the expected improvement is worth the cost.

Position your offer around a buyer and a task

Use this structure: “I help [team] answer [repeated questions] using [approved sources] inside [existing tool], with source links and access controls.”

For example: “I help B2B support teams find approved troubleshooting procedures in their internal knowledge base, with citations and escalation when the answer is missing.” Only add numerical performance claims after measuring them.

Avoid describing yourself only as someone who builds chatbots. That description gives the buyer little basis to judge scope, reliability, or relevance. Name the work employees need to complete.

Qualify prospects before writing proposals

Score pain, source readiness, sponsor access, budget feasibility, and a credible decision timeline from zero to two. Use the score to prioritize conversations, not as a substitute for judgment. A high score does not override a missing right to use the data.

A promising prospect can identify repeated questions, provide sample sources, name the person accountable for the workflow, and explain how a purchase would be approved. Ask who owns identity, knowledge maintenance, and operations after launch.

Pause or offer an assessment when sources are missing, nobody owns the outcome, or the buyer expects a company-wide system before reviewing a small pilot. Decline commitments that require capabilities you cannot reliably provide.

Run a discovery conversation

Spend the first part understanding the current task. Ask a user to show how they answered a recent question, which systems they searched, how they knew the answer was current, and where they became stuck. Concrete examples are more useful than a general complaint that search is bad.

Then establish frequency, task duration, users affected, and the consequences of an incorrect answer. Ask which native search or AI features they have already tried. Finally, discuss data access, decision-makers, budget, and a realistic next step.

Send a short written recap: the problem, proposed scope, unresolved assumptions, and who will provide each dependency. The recap should be understandable to someone who did not attend the meeting.

Use a short demonstration to prove the difficult parts

A five-minute demo can show one normal question with citations, one ambiguous question, one missing answer, one restricted document test, and one updated source. Explain what the system did and what it still cannot do.

Use public or synthetic material until the client approves their own test dataset. If you show performance figures, identify the dataset, test conditions, and measurement period. Do not imply that a polished demonstration has already proven production reliability.

Offer three commercial stages

Stage Deliverables Decision at the end
Paid assessment Workflow map, source inventory, access model, baseline, platform comparison, pilot scope Proceed, repair knowledge first, use a native product, or stop
Bounded pilot One workflow, limited sources and users, evaluation, user feedback, operations draft Expand, revise, or stop against agreed criteria
Production and support Hardened integration, ownership, monitoring, training, maintenance terms Continue based on adoption, quality, and operating cost

An illustrative pilot might cover one department, one language, one channel, two source collections, and 15 test users. The client and engineer must replace these limits with an agreed scope. Exclude autonomous actions and broad data migration unless they are separately designed and priced.

Do not promise a delivery date before checking access, source quality, connector availability, and administrator support. Distinguish engineering effort from elapsed calendar time.

Estimate from effort and uncertainty

Use a transparent model: estimated delivery days × your sustainable day rate, plus a visible allowance for identified uncertainty and explicit third-party costs. Separate assessment, implementation, and recurring support.

Illustrative arithmetic, not market pricing: a 3-day assessment at EUR 600 per day is EUR 1,800. A pilot estimated at 12 days at EUR 650 per day is EUR 7,800. A 20% contingency adds EUR 1,560, giving EUR 9,360 for the scoped work before applicable taxes and separately agreed platform charges.

These numbers are examples for learning estimation. Your actual rate depends on geography, experience, demand, scope, liability, and delivery cost. Keep contingency treatment clear: it can be included in a fixed price or handled as a separately approved allowance, but should not be an unexplained extra charge.

For support, define included hours, monitoring responsibilities, response windows, exclusions, and overage rates. A monthly retainer should correspond to actual work and availability. Avoid unlimited support or 24/7 commitments without staffing to fulfill them.

Explain business value without inventing savings

Use a client-validated baseline and separate saved capacity from realized cash savings. A useful model is:

Monthly capacity value = eligible users × adoption × relevant tasks per month × minutes saved per successful task ÷ 60 × loaded hourly cost × realization factor.

The realization factor represents how much saved time becomes useful capacity. Avoid double-counting adoption or success if task volume already measures actual successful usage.

Illustrative base case: 60 users × 0.60 adoption × 20 tasks × 4 minutes ÷ 60 × EUR 45 per hour × 0.50 realization = EUR 1,080 per month of capacity value. With EUR 700 in monthly operating and support costs, the net modeled benefit is EUR 380 per month. A EUR 9,360 pilot would take about 24.6 months to recover on that simplified basis. This may be too weak to justify the project.

An upside scenario using 0.80 adoption and 8 minutes saved, with the other inputs unchanged, produces EUR 2,880 of monthly capacity value and EUR 2,180 net after the same costs. Simple payback becomes about 4.3 months. A conservative case with 0.40 adoption and 2 minutes saved produces only EUR 360 of capacity value, below the assumed recurring cost.

These scenarios show why discovery and measurement matter. Do not sell the upside case as a forecast. Include assessment and rollout costs in a complete investment decision, and check whether growing use increases operating costs. Time savings do not automatically reduce payroll or create revenue.

Answer common buyer objections

Objection Credible response
We already have an AI assistant Let us test your existing tool against this workflow first; the gap may be configuration or knowledge quality
It will hallucinate We will measure unsupported answers, require evidence, and define when it must abstain or escalate
Our data is confidential We will document the data flow and test permissions, retention, and approved provider settings with your IT owner
We can build it internally An assessment or specialist integration may still help; compare internal capacity and ownership fairly
Your price is high Review the business case and scope; reduce scope if the expected benefit does not justify the cost
Guarantee perfect accuracy We can agree on measurable acceptance criteria and remediation; universal accuracy is not a credible promise
Send a proposal now First confirm the workflow, access, and acceptance criteria so the proposal has a dependable scope

What establishes trust

Show artifacts a buyer can inspect: a relevant demo, evaluation results, architecture, a data-flow explanation, a delivery plan, and a clear handover. Use actual customer references only with permission. If you are early in your career, say so and demonstrate the work you have completed.

A strong closing question is: “Would it be useful to validate this on an agreed set of questions and approved sources before deciding on a wider rollout?” The next step is a concrete evaluation, not an unsupported promise.

Keep a measurable sales process

Track prospects through researched, contacted, replied, discovery, qualified, proposal, won, and lost. Record next actions and reasons for loss. Count meaningful conversations and qualified opportunities, not just messages sent.

If responses are low, revisit targeting and relevance. If calls happen but proposals do not, improve discovery and qualification. If proposals fail, investigate trust, scope, timing, price, and the decision process. If pilots fail to expand, inspect value and adoption before spending more on acquisition.

Back to overview ↑
CHAPTER 04

Delivery and roadmap

Turn a pilot into a reliable service

A useful knowledge assistant needs a maintained knowledge base, a tested access model, measurable quality, and an owner after launch. Plan these at the start of the pilot rather than treating them as work to add after a successful demo.

Define a pilot before implementation

Write down the department, tasks, source collections, source owners, permitted user groups, delivery channel, supported language, and excluded use cases. Include a maximum agreed scope for documents or data volume where it affects effort.

Identify dependencies: tenant access, platform licenses, service accounts, sample questions, source permissions, and a client reviewer. Record an owner and target date for each. State that delays or changes in dependencies may affect the schedule.

Assign responsibility clearly. The business sponsor owns the outcome; knowledge owners approve source content; IT owns identity and infrastructure decisions; the engineer owns implementation and test evidence; pilot users provide workflow feedback. One person may fill multiple roles, but every responsibility needs a name.

Build an evaluation set that reflects real work

Begin with approximately 80 to 120 questions if the workflow supports that diversity. This is a planning suggestion, not a universal minimum. Include common questions, multi-source questions, ambiguous queries, missing answers, outdated or conflicting content, access restrictions, and malicious instructions embedded in documents.

Record the persona, expected source evidence, expected behavior, and whether the question is answerable. Keep development examples separate from a held-out acceptance set. Let subject-matter experts review the expected answers and adjudicate disagreements.

Evaluate retrieval separately from generation. Relevant evidence can be missing even when a plausible answer appears; good evidence can also be retrieved and then misrepresented. When using automated graders, calibrate them against human review and retain examples of disagreements.

Example acceptance criteria to negotiate

These are proposed starting thresholds for a low-consequence, bounded pilot. Change them to match the workflow and risk. Passing a small test set does not establish universal reliability.

Measure Definition Example pilot gate
Retrieval recall at k Share of answerable questions whose required evidence appears in top k authorized results At least 90% on the held-out set; define k
Answer correctness Share of answerable questions rated correct and sufficiently complete by reviewers At least 85%; report sample size and failures
Citation support Share of material factual claims supported by the cited passage At least 95% under human review
Missing-answer handling Share of unanswerable questions correctly refused or escalated At least 90%
Permission tests Forbidden content exposed through retrieval, output, titles, or caches Zero observed failures; any failure blocks release
Latency End-to-end time at agreed concurrency Example p95 below 8 seconds under the agreed load
Freshness Time from an approved source change to its availability Client-defined target, measured through a test update
Cost Model, retrieval, ingestion, and platform costs at expected usage Within the agreed monthly budget
Workflow improvement Time and success rate on comparable user tasks Agreed improvement with no unacceptable quality loss

Report counts alongside percentages. For example, “17 of 20 unanswerable questions handled correctly” reveals more than “85%.” Do not combine all metrics into one score that hides a permission failure.

Compare against the current workflow and, where feasible, the native product. Use comparable tasks and counterbalance task order so learning from the first attempt does not artificially favor the assistant. Record verification time and rework, not just answer generation time.

Release and handover

Before release, verify authentication, permission revocation, deleted documents, stale caches, document parsing failures, source conflicts, rate limits, timeouts, and budget controls. Test the deployed user experience, not only a developer preview.

Give the client an architecture and data-flow description, source inventory, evaluation results, deployment procedure, rollback instructions, known limitations, support contacts, and a knowledge maintenance schedule. Explain what changes require reevaluation: models, prompts, parsers, retrieval settings, connectors, or permissions.

During an incident involving possible data exposure, restrict the affected retrieval path, preserve appropriate diagnostic evidence, involve the designated client owner, and follow the client's incident process. Restore service only after the relevant checks pass. Avoid retaining sensitive prompt contents in general-purpose logs by default.

Operations after launch

Review unanswered questions and source gaps with knowledge owners. Monitor failed synchronization jobs, unauthorized-access events, latency, usage, and spend. Use sampled human review to detect quality drift. Maintain a regression set for previously fixed failures.

Track actual active usage and completed tasks. Low usage may signal poor workflow placement, missing trust, or a weak business case. New prompts alone will not fix missing source ownership.

The first 90 days

The plan assumes about 15 to 20 focused hours per week alongside other work. Adjust scope to your available time. It is an execution plan, not a promise of a sale within a fixed period.

Period Technical work Commercial work Exit evidence
Week 1 Assess skills and choose a platform Interview three users and identify one workflow A one-page scope and skill gap list
Week 2 Build ingestion and basic retrieval on synthetic data Research 20 plausible accounts or partner firms Working retrieval and prospect hypotheses
Week 3 Add citations, abstention, and evaluation Conduct three more discovery conversations Initial evaluation and revised positioning
Week 4 Add identity and negative permission tests Publish a short demo and focused profile Portfolio package with honest limitations
Weeks 5 and 6 Improve weak results and prepare deployment Pursue selected proposals and agency conversations Qualified opportunities or clear feedback
Weeks 7 and 8 Deliver a paid assessment if won; otherwise improve one validated gap Present bounded pilot proposals Client-approved scope or revised offer
Weeks 9 and 10 Run a pilot if approved Review usage and results with the sponsor Acceptance evidence and unresolved issues
Weeks 11 and 12 Harden and document successful work Discuss expansion, referral, or support Handover and an authorized case study if available
Days 85 to 90 Review reusable components and costs Choose the next niche, channel, or employment focus A decision based on evidence

A suggested weekly business-development cadence is five researched contacts, two tailored marketplace applications, one partner conversation, and one useful public contribution. Quality and relevance matter more than hitting these illustrative counts. These are activities to try, not conversion forecasts.

Decision points that prevent wasted work

After six to ten discovery conversations, revise the niche if nobody can describe a frequent, costly knowledge problem. If the problem is real but documentation is unusable, offer knowledge cleanup or an assessment before building an assistant.

If buyers like the demo but will not share approved sample data or name a sponsor, investigate whether the interest is practical or exploratory. If pilots show weak savings, stop or narrow the offer. A candid recommendation not to expand can preserve trust.

If you cannot independently implement required identity and deployment controls, pursue employment, subcontract under an experienced team, or reduce the scope. Do not let a sales deadline determine your technical readiness.

A weekly review template

Record what you learned from users, what failed in evaluation, which prospects moved forward, what you spent, and the next smallest experiment. Choose one technical improvement and one commercial improvement for the following week. Keep the record in this folder so progress is visible over time.

Back to overview ↑
CHAPTER 05

Client templates

Practical drafts to make your own

Replace all bracketed fields with accurate details. These drafts are prepared for you to adapt; no messages have been sent. Keep prototype results separate from client results, and describe experience only when you can substantiate it.

Profile headline and summary

Headline: AI Engineer for Internal Knowledge Assistants and [Platform] Integration

Summary: I help [type of team] find reliable answers in their approved internal knowledge. My work covers [capabilities you can demonstrate], source citations, access-control testing, and evaluation against real user questions. I start with a focused assessment and recommend a pilot only when the sources, workflow, and business case support it. Portfolio: [link to actual demo and evaluation].

If you have no production references, add: “My portfolio currently includes [accurately describe demonstration projects]. I am seeking a bounded pilot or a delivery partnership in [specialty].”

A first message to a potential client

Subject: Internal knowledge questions at [company]

Hi [name],

I noticed [specific, verified observation]. I am exploring how [team type] handles repeated questions about [workflow].

I build assistants that answer from approved internal sources, with citations and access controls. If finding the right information is slowing your team down, I would be interested in learning how you handle it today.

Would a short conversation next week be useful? I can share a relevant demonstration at [link].

[Your name]

A relevant follow up

Hi [name],

One practical question for this workflow is how staff know they have the current version of [procedure]. My demonstration includes [actual feature or test] because that issue affects trust in the answer.

If this is a current priority, I would be happy to compare it with your existing process. If it is not, no problem.

[Your name]

Use a small number of relevant follow-ups and respect a request not to contact the person again.

An agency partnership message

Hi [name],

Your work on [verified service or project] looks relevant to my focus on internal knowledge assistants. I can support [specific capability you can deliver], including [actual evidence].

I am interested in scoped subcontracting or a joint pilot where your team owns the client relationship and we agree on responsibilities before work begins.

Here is a short demo and evaluation: [links]. Would it be useful to discuss where this fits your current delivery needs?

[Your name]

A marketplace proposal

Your requirement to [specific task from the listing] suggests the first step is to validate [source quality, permissions, or integration dependency].

I would propose three milestones: confirm the workflow and test questions; implement a limited assistant with citations and appropriate authorization; evaluate it with your users and document the result.

Relevant evidence: [real project, clearly labeled prototype if applicable]. Before committing to an estimate, I would confirm [two or three critical unknowns]. The pilot can exclude [explicit scope boundary] to keep the work manageable.

Discovery notes

Client and date: [ ]

Workflow and users: [ ]

A recent real question and how it was answered: [ ]

Question frequency and current time per task: [ ]

Consequences of an incorrect answer: [ ]

Sources, owners, formats, and update frequency: [ ]

Existing search or assistant and its specific gap: [ ]

User roles, restricted content, and identity system: [ ]

Business sponsor, IT owner, and purchasing approver: [ ]

Budget feasibility and decision timeline: [ ]

Pilot success measures and baseline: [ ]

Next action, owner, and date: [ ]

A pilot proposal outline

Problem and intended outcome

[Team] currently uses [process] to answer [question type]. The observed baseline is [measurement, sample, and date]. The pilot will test whether [specific improvement] is achievable without unacceptable quality or access failures.

Scope

Included: [department], [sources and data limits], [user groups], [channel], [language], [question types], and [test period].

Excluded: [autonomous actions, additional sources, migration, unsupported formats, or other boundaries].

Deliverables

An agreed source inventory and access design; the configured assistant; an evaluation report; a user feedback session; an operations and handover guide; and a recommendation to expand, revise, or stop.

Dependencies and schedule

The client provides [access, licenses, reviewers, approved data] by [date]. Work is estimated at [days] after dependencies are available. Delays, new requirements, or unexpected source problems trigger a documented schedule and scope review.

Acceptance

Use an agreed held-out question set and named reviewers. Define correctness, citation support, missing-answer handling, permission tests, latency, freshness, cost, and user-task improvement. Any observed unauthorized disclosure blocks acceptance until resolved and retested. Record known limitations.

Commercial terms to agree

Assessment fee: [ ]. Pilot fee and pricing basis: [ ]. Third-party costs and responsible payer: [ ]. Milestone payment schedule: [ ]. Included revisions: [ ]. Change-request process: [ ]. Support period and hours: [ ]. Ownership of deliverables and pre-existing components: [ ]. Data handling and deletion responsibilities: [ ].

This outline is a commercial drafting aid, not a finalized legal agreement. Use the client's procurement and contracting process to settle binding terms.

Decision after the pilot

The sponsor reviews the evaluation, adoption, operating cost, and unresolved limitations. Expansion requires an explicit scope and ownership decision; it is not assumed from completion of the pilot.

A case study structure

Customer context: [Use a name only with permission.]

Problem and baseline: [Measured task, volume, time, and period.]

Constraints: [Sources, permissions, tools, budget, and delivery limits.]

Implementation: [What you actually delivered and why.]

Evaluation: [Dataset, sample sizes, baseline, reviewers, and test conditions.]

Outcome: [Measured result with denominators and period.]

Limitations: [Failures, excluded workflows, and confidence limits.]

Handover: [Who owns the knowledge and operation.]

For synthetic projects, put “Demonstration using synthetic data” at the top and report technical results without implying business savings.

Back to overview ↑
CHAPTER 06

Sources

Official references and research notes

Sources checked on 2 November 2026. Platform capabilities, partner requirements, and commercial terms can change. Follow the linked official documentation when scoping a real engagement.

Source Supports
Microsoft SharePoint knowledge integration SharePoint grounding, authentication behavior, permission handling, and integration limitations
Microsoft Copilot Studio Applied Skills A relevant credential and its assessed capabilities
AWS Bedrock retrieval Retrieval and generation API capabilities and citations
Google Gemini Enterprise access control Platform IAM roles and resource access scopes
Atlassian Rovo Search Search across connected and Atlassian sources
Glean partners Consulting, implementation, and managed services partner routes
n8n expert partners Application process and existing-experience expectations
Upwork chatbot services Marketplace category discovery; search results were accessible, while direct page retrieval was blocked
Malt freelancer information Freelancer marketplace and profile route; local terms must be checked separately
LinkedIn AI engineering jobs A job-search entry point, not a validated shortlist
Wellfound jobs Startup job discovery
OWASP GenAI risks Security risk categories for language-model applications

The niche recommendations, sales process, learning plan, pilot thresholds, pricing examples, and ROI scenarios are proposed working methods. They are not vendor promises, salary surveys, market benchmarks, or measured customer results. No named organization is represented as a qualified prospect or confirmed buyer.

Back to overview ↑