From fieldwork to lasting business capability.FORWARD-DEPLOYED ENGINEERING
FDE Academy
WEEK 05 / PHASE 2

Ontology and the advisory agent

Identity · Semantic layer · Retrieval · Advisory tools

Connect the business to the system4 lessons · 10–12 suggested hours including practiceOutcome: Design an explainable advisory agent connected to objects, metrics, retrieval and business tools.
FIELD JOURNAL / 02Business and agent modeling

See the structure, then implement and verify with the notes.

Business and agent modeling
This page retains the English overview and workshop. The expanded practitioner lecture notes are currently available in Chinese. Read the complete Chinese lecture →
AIelsen / FIELD BOARD · W05
05.1
Ontology: connect objects to business actions

Relationships and lifecycles across members, orders, stores, segments, campaigns and coupons. A teaching model, not a deployed system.

THIS WEEK IN THE FIELD

What situation are you walking into?

One customer has two IDs; one metric has three definitions; stores need context-specific answers. A larger model does not automatically repair the business coordinate system.

DELIVERABLE / Ontology and semantic config + tools + advisory MVP design and traces

01 / Entity resolution: examine false merges

Start with stable keys. Fuzzy matching produces candidates, not permission to merge people with similar names or shared phones. Separate auto-merge, review and keep-apart decisions with evidence and lineage. Compare false-merge and missed-match consequences.

Exercise: explain why a shared phone is insufficient; add family-sharing and recycled-number counterexamples.

02 / Ontology makes data actionable

Objects need stable identity, state and visibility. Links need timing and provenance. Actions need eligibility, limits, idempotency and audit. The ontology identifies what we discuss, metric contracts define calculations and action contracts define authority. Version them independently.

An operational diagram includes action preconditions and resulting state, not just object links.

03 / RAG and metrics answer different questions

Use controlled computation for structured metrics and retrieval for manuals and policies. Keep source documents, retrievable chunks, object links and validated Q&A separate. Preserve page, version, product and permission metadata. Cite evidence and abstain or clarify when no applicable source exists.

Compare the same fault code on two product models: filter scope before retrieval.

04 / MCP connects tools; it does not define the task

Define host, client and server responsibilities plus tool inputs, outputs, access and errors. A protocol does not grant authorization or business meaning. An advisory agent chooses queries or retrieval from the goal, incorporates results and may clarify before recommending. A fixed API chain is a workflow.

Extension: replace the kit’s deterministic planner with a real model and submit tool traces. Website labs do not call models.
WORKED EXAMPLE · SYNTHETIC

Put the method to work

For “which inactive members should we re-engage?”, clarify the inactivity window, query authorized valid orders, exclude opted-out members and retrieve applicable offer rules. Explain candidates, constraints and hypotheses. These inputs cannot establish that anyone will certainly repurchase.

Practice this week

  • Build identity mappings, a review queue and ontology v1.
  • Define two read-only tools and a versioned knowledge index.
  • Submit three task traces including clarification and insufficient evidence.

Acceptance checks

  • Fuzzy matches are not treated as identity facts.
  • Conclusions match evidence, permissions and metric versions.
  • Model judgment is distinct from deterministic calculation.
FIELD WORKSHOP / W05

120 minutes: separate tools, retrieval and model judgment

Use ontology.json, identity-candidates.csv and the synthetic manuals. Establish object and knowledge constraints before designing a model loop. The trace below is desired behavior, not evidence of an executed model.

  1. 0–30 min: label identity pairs as confirmed, review or separate. Describe false-merge harm and express metric scope through Member—Order—Store.

  2. 30–75 min: design E03 retrieval tests for AX10 and BX20. Clarify an unknown model, confirm firmware and filter before retrieving, and cite document ID, version and section.

  3. 75–120 min: connect a choose(context) model adapter in an authorized environment. Initially expose only read_metric. Submit normal, clarification and insufficient-evidence traces; the scripted planner is not a model benchmark.

Artifact excerpt · synthetic example

Target trace / not an executed model trace
User: What should I do about E03?
Agent: Which model and firmware version?
User: AX10, firmware 2.0.
Retrieval filter: model=AX10, firmware=2.0
Evidence: Manual AX10 / v2 / page 4
Answer: only supported steps, with version citation
Missing evidence: say unknown; do not borrow BX20 instructions

Instructor review

Score retrieval, citation support and omitted constraints separately. Do not collapse all failures into “hallucination.” A tool schema does not replace execution-side authorization.

An unseen field challenge ↗

If the model requests arbitrary SQL, redesign the capability as a bounded business query. Specify allowed parameters, server-enforced scope and rejection conditions.

Download offline practice kit ↓
AIelsen / FIELD BOARD · W05
05.2
An advisory agent task, end to end

The model clarifies and chooses tools. Deterministic tools provide evidence; the server enforces scope. No coupon issuance at this stage.

ONE-MINUTE CHECK

Does a working MCP connection authorize all customer data?

Local storage is not encrypted; do not store sensitive content on shared devices.

References and further reading

Palantir ↗ · Ontology overview查阅 / Accessed 2026-09-07 · PalantirModel Context Protocol ↗ · MCP architecture overview2026-07-28 · Model Context ProtocolModel Context Protocol ↗ · MCP security best practicesDraft · 查阅 / Accessed 2026-09-07 · Model Context ProtocolOpenAI ↗ · Function calling查阅 / Accessed 2026-09-07 · OpenAI

Read alongside the assignment and record design constraints and tests. Verify specifications against your deployment version.

Teaching board
Download SVG ↓

Search runs locally. Queries are not uploaded.