Working with a pack from chat

Once your client is connected, you talk and the assistant picks the tool. This page covers what to say, what comes back, and what to do when the pack says no. Each section maps to the CLI verb of the same name in Ask, Teach, Task.

Name the pack

Every verb acts on one pack. In a new conversation the assistant calls list_packs and picks the one you mean. If you have several, name it:

Ask the growth-metrics pack how many swaps happened last week.

It stays on that pack until you name another.

Ask

Ask a question in plain language. You get one answer with the evidence it drew on. You never pick knowledge versus data and never write a query.

You: How many active wallets did we have last week?

Assistant: 4,812 active wallets in the week ending Sept 21, down 3% from the week before. Active means at least one swap in the trailing 30 days, per the pack’s definition. Sources: Wallet activity definitions, wallet_daily.

The assistant waits about a minute. A hard data question can take longer; the ask keeps running and the assistant follows it with action_get until it settles, relaying progress as it goes.

To see a source, ask for it. The assistant reads the cited document with read_document and can quote it or check a claim against it.

Answer a clarifying question

An ambiguous ask comes back waiting with a question from the pack:

Assistant: The pack needs one thing pinned down first. Do you mean wallets that traded, or wallets that signed in?

You: Traded.

Assistant: 4,812 wallets traded last week. …

Answer it and the assistant asks again with your answer folded in.

Declined vs. failed

A pack that can’t answer says so instead of guessing. Two outcomes look similar and mean different things:

Declined: the pack understood the question and can’t or won’t answer, with a reason. “Lacks a definition” means a knowledge gap. “No rows” or “couldn’t resolve” means a data gap. Rewording won’t fix either; pass the reason to whoever maintains the pack. Closing gaps covers what they do next.
Failed: something broke. Retry, and report it if it repeats.

Teach

Tell the pack a fact, decision, or definition the data can’t express, or hand it a file.

You: Teach the pack that “active wallet” means any address with a swap in the last 30 days.

Assistant: I’ll add: “An active wallet is any address with at least one swap in the trailing 30 days.” Teach that to growth-metrics?

You: Yes.

Assistant: Done and indexed. The pack uses that definition from the next ask on.

A teach finishes when the content is indexed. To undo one, say “forget that”: the document and everything learned from it are removed.

Task

Give the pack’s agents an objective in plain language: research a topic and file the findings, audit what the pack covers, model data an ask couldn’t resolve. It runs in the background.

You: Have the pack research the new grant program and add what it finds.

Assistant: Objective: “Research the new grant program, summarize eligibility and deadlines, and add the findings to the pack.” Go ahead?

You: Go.

Assistant: Started. Currently: searching the open web…

The assistant relays progress and reports the summary when it finishes: what it found and what it wrote into the pack. Say “cancel” to stop it; a task mid-step finishes that step first.

Schedule it

Give an ask or task a time and the pack runs it on its own:

Every Monday at 9, ask the pack which hypotheses moved last week.

Each fire is its own ask or task you can read back. List, pause, resume, trigger now, or delete schedules from chat. Cron schedules run in UTC and fire at most every 30 minutes. A scheduled task spends agent time on every fire. See Scheduling recurring work for the CLI side.

Not available from chat

Connecting a warehouse, declaring objectives, editing PACK.md, and publishing a pack are done in the CLI. If an ask keeps declining for “no modeled data,” that’s the message to pass to whoever set the pack up.

Was this page helpful?

Thanks for the feedback.