Teach & ask

With a pack connected to data, teach it what that data can’t say (definitions, canonical names, business meaning), then start asking.

For the fastest path from zero to real answers instead of a step-by-step walkthrough, see the Quickstart guide.

1. Teach it a fact. teach takes exactly one of --text or --file, and returns a queued Action.

   edisyl teach "$PACK" --text "An active wallet is any address with a swap in the last 30 days."

2. Wait for it to be indexed. Ingestion is async (chunk → embed → index → organize): a teach is only “done” once its content is actually retrievable.

   edisyl action watch <action-id>

3. Ask your first question.

   edisyl ask "$PACK" "What counts as an active wallet?" --wait

   --wait blocks until the answer is ready and prints it with its evidence. The server’s own window is ~60s; past that the CLI keeps polling up to --timeout (default 5m), so a slow data question still returns an answer instead of just an Action id.

ask is the answer layer for everything from here on: one natural-language question → one synthesized, cited answer over the pack’s knowledge, connections, data sources, and any readable upstream packs. You never choose data-vs-knowledge, and you never write SQL.

edisyl ask "$PACK" "How many swaps in the last 7 days?" --wait

This is also how you test the workspace

Have whoever owns the pack author the questions they expect it to answer. Every question ask can’t answer is a gap: see Closing gaps for how to route it.

When you don’t want to wait

Take the Action id and follow it instead of blocking:

action_id=$(edisyl ask "$PACK" "<slow data question>" --id-only)
edisyl action watch "$action_id"    # narrates progress, then prints the answer
edisyl action get "$action_id"      # read the final answer again, any time

Undoing a teach

edisyl forget <pack> <content-record-id> removes one ingested document and every piece of knowledge placed from it (the true inverse of teach). The content record id comes from edisyl action trace <teach-action-id>.

You now have the whole loop: connect → teach → ask. Want to run through connecting, declaring objectives, and asking in one guided sitting next time? See the Quickstart.

Next: Closing gaps, covering what to do the moment ask comes back short.