PloidDocs
APIAgent

Agent overview

Use Ploid as a model-led research agent with explicit sources, memory, and spend ceilings.

The Ploid Agent accepts a goal in plain language and decides how to complete it within the boundaries you provide. It can search Ploid people data, research the public web, use approved connected apps, and synthesize the result.

Model-led routing

You describe the outcome, not a fixed internal search sequence. The agent can choose different tools based on the task, evidence already available, and remaining budget.

{
    "operation": "ask",
    "prompt": "Find ten stage-matched lookalikes for our strongest early-stage customer and cite the evidence for company stage and fit.",
    "sources": ["people", "public_web"],
    "max_acu": 1.6,
    "max_output_tokens": 12000,
    "memory": "none",
    "response_format": "standard"
}

Boundaries you control

FieldPurposeDefault
sourcesAllowed source familiesAll three source families
max_acuAccount admission/billing limit0.8
max_output_tokensEchoed compatibility metadata8000
memoryLong-term memory policynone
response_formatStandard JSON envelope or Markdownstandard
output_schemaOptional validated result contractOmitted

max_output_tokens cannot exceed max_acu × 10,000, but it is not forwarded to Eve or enforced as a provider output ceiling. max_acu accepts 0.2 through 6.4 in 0.1 increments and acts as an admission/billing limit, not a provider-compute cap.

Sources

  • people — Ploid people search, identity, and enrichment capabilities.
  • public_web — public company sites, news, filings, and other web evidence.
  • connected_apps — user-authorized applications available to the agent.

Omit a source from the list to prevent the agent from using that source family for the turn.

Conversational by default

The normal Agent response is intentionally flexible: data.output contains the synthesis and data.artifacts contains typed tool results. This lets intelligent callers continue reasoning over the answer.

When code needs a fixed contract, opt into structured outputs for that turn only.

On this page