os:Find

Classification: actions:Query

Subject: Class (optional)

Payload: os:FindPayload

Result: Resource

Handler: genai:AgenticHandler

Locates resources in the graph that match the given class and criteria.

Use os:Find when:

• You need to find specific resources by class (e.g., "find all Project instances")
• You have natural language prompt to filter by (e.g., "active projects with high priority")
• You want an intelligent search that discovers and tries relevant query actions

os:Find is an iterative agentic search that:

1. Takes a target class as SUBJECT (rdfs:Class) and natural language prompt in payload
2. Discovers query actions whose resultScheme matches the target class
3. Iteratively tries promising queries until matching resources are found
4. Returns matching resources in a named graph

# Find all active users (target class is subject, prompt in payload)
    CONSTRUCT { ?user iam:username ?username }
    WHERE {
        ?user os:Find (iam:User [genai:prompt "find the user that last modified the ticket with id 123"]) .
        ?user iam:username ?username .
    }