Tool Call
- CURIE:
gmeow:ToolCall - IRI: https://blackcatinformatics.ca/gmeow/ToolCall
- Category: class
- Defined by:
gmeow:slices/agentic - Box roles: TBox role (What is this?)
One invocation of a tool by an agent: the tool agent (gmeow:usedTool), the requesting model invocation when known (gmeow:calledByInvocation), and the verbatim arguments/result payloads. The agent's actions join the same provenance graph as its claims — an entity the call produced links back via gmeow:wasGeneratedBy (no forward output property, Principle 5), so 'which tool, called by which invocation, with what arguments?' is answerable after the fact. The ModelInvocation idiom one level down.
Structure
Subclass of: gmeow:Activity
Practical Pattern
Use gmeow:ToolCall as a specialized kind of gmeow:Activity. Add statement metadata or a standpoint when the assertion needs provenance, confidence, or vantage.
Example Snippets
These snippets are generated from canonical slice examples and trimmed to the Turtle blocks where this term appears.
Agent Trajectory
- Source:
slices/extensions/agentic/examples/agent-trajectory.ttl - Examples catalog: open in catalog#example-slices-extensions-agentic-examples-agent-trajectory
@prefix gmeow: <https://blackcatinformatics.ca/gmeow/> .
@prefix ex: <https://blackcatinformatics.ca/gmeow/examples/> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
ex:call-7-1 a gmeow:ToolCall ;
rdfs:label "turn 7, call 1: search"@en ;
gmeow:calledByInvocation ex:invocation-7 ;
gmeow:usedTool ex:webSearch ;
gmeow:toolArguments "{\"query\": \"GTS deterministic encoding spec\"}" ;
# Large result: the digest IS the value (gmeow:contentDigest convention).
gmeow:toolResult "blake3:9f64a747e1b97f131fabb6b447296c9b6f0201e79fb3c5356e6c77e89b6a806a" ;
gmeow:atTime "2026-06-12T17:03:11Z"^^xsd:dateTime ;
gmeow:eventTemporalFrame gmeow:temporalFrameUTCGregorian .
ex:call-7-2 a gmeow:ToolCall ;
rdfs:label "turn 7, call 2: store a memory note"@en ;
gmeow:calledByInvocation ex:invocation-7 ;
gmeow:usedTool ex:storeClaim ;
gmeow:toolArguments "{\"text\": \"the GTS spec mandates RFC 8949 deterministic encoding\"}" ;
gmeow:toolResult "{\"ok\": true}" ;
gmeow:atTime "2026-06-12T17:03:14Z"^^xsd:dateTime ;
gmeow:eventTemporalFrame gmeow:temporalFrameUTCGregorian .
Common Companion Terms
External Equivalences
Equivalent or closely aligned targets: schema, wd
Linkages
Generated from the canonical mapping DSL. SSSOM files are the generated public interchange form for term equivalences.
Term Equivalences
| Source | Kind | Profile | Predicate/Relation | Target | Evidence |
|---|---|---|---|---|---|
gmeow:ToolCall |
equivalence | - |
skos:relatedMatch | schema:Action | gmeow-agentic.sssom.tsv; gmeow:eqAg002; confidence 0.6 |
gmeow:ToolCall |
equivalence | - |
skos:relatedMatch | wd:Q62270 | gmeow-agentic.sssom.tsv; gmeow:eqAg001; confidence 0.5 |
Usage Advice
Examples
- An assistant's MCP store_claim call: the
ToolCallrecords the tool agent, the verbatim JSON arguments, and the stored claim's id as the result payload; the claim itself links back withgmeow:wasGeneratedBy.