Skip to content

Usage

Once the connector is installed, your assistant can call its tools as part of a normal conversation. You rarely call them by hand — you ask a question, and the assistant chooses the right tool. The examples below show what each tool is good for.

Worked examples

search — broad, relevance-ranked

"What does TCLP have on deforestation?"

search runs a free-text query across all content and returns the most relevant clauses, terms, and guides — but, as described in How search works, it surfaces the connections too. A search for deforestation, for instance, leads with the Deforestation and Land Use Change Clause and Questionnaire, alongside the practitioner guide Ensure Deforestation-Free Supply Chains and the glossary entry for Carbon Sequestration, which is in turn linked to related concepts such as carbon sinks, ecological restoration and offsetting. Reach for search when you have a topic but not a specific term.

entity_lookup — start from a named concept

"What clauses and terms mention scope 3 emissions?"

entity_lookup takes a named concept and returns the content that references it. Use it when you already know the concept you care about and want everything connected to it.

taxonomy_facets then taxonomy_content — browse by category

"Show me clauses for the real estate sector."

Browsing is a two-step move. First call taxonomy_facets to see the available categories and their value slugs (for example, the sector facet and its real-estate slug). Then call taxonomy_content with the slugs you want to list the matching content. Multiple facets combine with AND — for example, a given sector and practice area.

Mindful use

Search deliberately

Every tool call is computation, and computation has an environmental cost. That sits at odds with the reason this knowledge graph exists, so it is worth being deliberate:

  • Ask a specific question rather than firing off broad searches and refining by trial and error.
  • Choose the targeted tool. If you know the concept, entity_lookup beats a broad search; if you want a category, browse the taxonomy rather than searching repeatedly.
  • Avoid redundant calls. Reuse results you already have instead of re-running the same query.

Used well, the connector gives you more with less — which is the whole point.