Skip to main content
Your first loop does not require code or a shape. You will connect an agent, save a short source in the active project, and retrieve its exact wording.

​
Before you start

Connect the Runtime MCP as penumbra, then complete the browser sign-in and confirm that the server is connected.

​
Save and retrieve a source

1

Check the active project

Tell your agent:
Use Penumbra. Tell me which project is active and what is already in it. Do not make any changes.
Confirm that the project is where you want the source to live.
2

Save the source

Give the agent a small piece of useful material:
Save this as a source titled “Procurement note”: Enterprise buyers stall on procurement, not price. Tell me when it is ready and give me its source id. Do not extract it yet.
3

Read it back

Ask:
Read the Procurement note and quote what it says about enterprise buyers.
The answer should contain the wording you saved, not a newly generated summary.
You have completed the basic Runtime loop: orient, add evidence, and retrieve it again.

​
If it did not work

  • Wrong project: ask the agent to show the available projects and switch before saving again.
  • Source is still processing: the agent should poll the receipt returned by penumbra_add_source rather than submit the source again.
  • You received a summary instead of a quote: ask the agent to use verbatim source retrieval.

​
Add structured knowledge next

Sources preserve evidence. Shapes define the structured knowledge your agents can extract or capture from that evidence.

​
Where to go next

Extract a source

Turn saved evidence into structured knowledge through a shape.

Capture knowledge

Stage something you already know and validate it before submission.

Create a shape

Describe the concepts and relationships that matter in your domain.