AgencyCore knowledge base

Build, evaluate, and operate AgencyCore agents.

Architecture references, workflow playbooks, and evaluation guides for the team. Press ⌘K to jump anywhere.

articles 97topics 8search ⌘K

Recently updated

4 articles

Browse by topic

Every article, grouped by domain and type.

Mission Control

6 articles

Roadmap

3 articles

Agents

13 articles

Company Sonar

People Sonar

Enrichment

General Search

Envoy

Agentic CRM

Concepts

Reference

Proprietary data

13 articles

Intelligence databases

Company Intelligence Database

Decided architecture for ENG-669, the cross-org company intelligence layer that acts as a read-through cache in front of enrichment providers, with public-facts-only privacy and provenance-tracked write-back.

People Intelligence Database

Decided architecture for the cross-org people intelligence layer - a read-through cache in front of headhunter research and Hunter email lookups, with LinkedIn-URL identity, append-only employment edges, per-tier freshness stamps on the flat profile, shared intel_sources provenance, unified intel_signals, and a GDPR erasure path.

Signals Intelligence Database

Decided v1 architecture for the unified signal store - one polymorphic append-only intel_signals table that holds both company and person signals, with a shared taxonomy, source-ranked provenance, an intel_signal_ingests log that records which pipeline found each signal, decay at read time, and a person-to-company rollup so a champion job change surfaces on the company feed.

Org Signal Feed

The per-org activation layer on top of the shared signals store. One immutable intel_signals row fans out to many orgs through scoring (signal-type weight times ICP fit times recency decay) and materializes as ranked, tiered rows in intel_org_signal_feed - the only org-scoped, RLS-per-org table of the signal stack, the door the launchpad, inbox and digest all read through. Signals enter by two ingest classes - a user's sonar pull (ungated) or an automated push (gated by threshold plus an optional competitor-ICP check) - logged in intel_signal_ingests, and each feed row records its origin.

CRM

Companies

Deep dive on crm_companies, the account record at the centre of the CRM — where it is served from, how a row is born and read, and its full schema, relationships and rules.

People

Deep dive on crm_people, the contact record of the CRM — where it is served from, how a row is born and read, and its full schema, relationships and rules.

Deals

Deep dive on the deal pipeline — crm_deals, crm_pipeline_stages and crm_pipeline_config. Where it is served from, the life of a deal, and its full schema, relationships and rules.

Activities

Deep dive on crm_activities, the interaction + task log of the CRM — where it is served from, how a row is born and read, and its full schema, relationships and rules.

Communications

Deep dive on crm_communications and crm_communication_events, the unified email/call/message log and its per-message engagement tracking — where it is served from, the outbound message lifecycle, and the full schema, relationships and rules.

Lists

Deep dive on crm_lists and crm_list_members, the static or dynamic member collections of the CRM — where they are served from, how a list and its members come to be and are read, and their schema, relationships and rules.

Signals

Deep dive on the signals tables - signals, company_signals and person_signals, the CRM's sales-intelligence layer. Where signals are served from, how one is born and attached, and the full schema, relationships and rules.

Saved filters

Deep dive on crm_saved_filters, the named reusable filter snapshots over the company, person and signal list views — where it is served from, how a saved view is born and applied, and its full schema, relationships and rules.

Engineering

42 articles

System design

Agentic platform

Platform contract

One platform behind chat, interactive channels, triggers, approvals and background runs, with one Agno runtime, one tool layer, one state layer, and three cross-cutting planes.

Surfaces

Every product surface and its API contract. Web chat goes through the gateway; every schema-native surface calls the domain API.

Channel gateway

The only layer that knows both an interactive channel and the platform. One message shape converges inbound, one intent shape diverges outbound, and no model call happens here.

Front door

The conversational control layer. It turns a request into one structured decision, then deterministic application code answers or hands work to RunManager.

Triggers

A Run with no person. Every producer emits one Event, matching is deterministic, and dispatch reuses RunManager, Policy and Inngest.

Agent access (CLI and MCP)

How an outside AI agent reaches AgencyCore. The ac CLI works today as a user seat. An MCP server is planned and not designed.

Agentic runtime

One Run contract, one Agno agent runtime, one deterministic workflow model, and the component boundaries that keep the framework replaceable.

Runtime definitions

Editable drafts, one published configuration per definition, template forks, deterministic validation, and the Run snapshot that keeps in flight work stable.

Runtime execution

The Run record, the Inngest step boundaries, agent segments, workflow nodes, approvals, cancellation, failure handling and live events.

Tools and integrations

A tool is the one way an agent reaches the world. AgencyCore owns the model facing contract, the invoke path, the credentials and the result boundary.

State and knowledge

What a run may know. One deterministic context builder over application state, knowledge and memory, one owner for every fact, and memory that is written through a tool.

Policy and governance

One deterministic plane answers may this happen, at three checkpoints, with one grant model, one approval model and one decision log.

Observability and operations

One run row, one span tree and one usage meter. Sentry reports system failure; AgencyCore spans explain what the agent did.

Idempotency

One durable PostgreSQL key service prevents duplicate effects and freezes mutable input before selected Run starts. A Run start is guarded by a unique index on the Run row.

Company, People and Signals contracts

The five Phase 7 product capabilities, their bounded inputs, stable references, permissions and results.

Capability design scenarios

Normal, failure and recovery cases for the Phase 7 capability contracts, with implementation owners.

Agentic products

Mission Control

Workflows

Guides

Reference

Product Design

3 articles

Symphony

11 articles

Agents

Timed jobs

Housekeeping

System design

Learnings

6 articles