Ga naar inhoud

Voor applicaties

Mensen lezen Depositori in de browser. Software leest dezelfde definities op twee manieren. Beide staan op de pagina Organisatie.

Voor Claude, ChatGPT of een andere AI-agent die je zelf gebruikt.

  1. Open Organisatie en zoek Een AI-agent koppelen.
  2. Kopieer het adres en voeg het in je agent toe als connector. De stappen voor Claude, ChatGPT en Claude Code staan onder het adres.
  3. De agent vraagt je één keer om je bij Depositori aan te melden. Daarna werkt hij in je organisatie als jou, met jouw rol.
Een AI-agent koppelen: het adres dat je de agent geeftEen AI-agent koppelen: het adres dat je de agent geeft

Niets te plakken behalve het adres, en geen sleutel om veilig te bewaren. Je ziet en ontkoppelt je agents onder je naam linksonder, Gekoppelde apps.

Alles wat jij in de app kunt, kan je agent ook, als tool, en niets meer. Hij krijgt de tools van jouw rol: de agent van een lezer leest, stelt vragen en stelt wijzigingen van KPI’s voor; die van een bijdrager bewerkt ook de begrippenlijst, notities en beschrijvingen; die van een eigenaar beheert ook verbindingen, imports en mensen; die van een beheerder beheert ook de werkruimte. Je rol wordt bij elke aanroep opnieuw gecontroleerd in de organisatie die de aanroep noemt. Een tool die je rol niet heeft, staat niet in de lijst, en wordt geweigerd voordat hij draait als de agent hem toch aanroept.

  • Als jou. Een agent die zo gekoppeld is, handelt in jouw naam. Wat hij wijzigt staat op jouw naam, bijvoorbeeld in de geschiedenis van een KPI of een open punt. Een voorstel voor een KPI, een goedkeuring en elke wijziging van een open punt doet altijd een persoon, dus alleen een agent die als jou is aangemeld kan ze doen, geen API-sleutel.
  • Hij vraagt het eerst. Wat niet ongedaan kan worden, zoals een import of verbinding verwijderen, iemand verwijderen of een API-sleutel intrekken, vraagt een uitdrukkelijke bevestiging in de tool. Een goede agent vraagt het jou voordat hij bevestigt.
  • Live cijfers. De rekentools (query_kpi, query_metrics, list_values, run_dax) zijn er alleen als een Beheerder query’s voor de organisatie heeft toegestaan (Query’s via de API toestaan onder Organisatie bewerken). run_dax voert een eigen DAX-query van de agent uit op een model, dus het kan detailrijen teruggeven, niet alleen totalen: hooguit 200, zonder persoonlijke en afgeschermde kolommen en met gemaskeerde e-mailadressen. Daarom is het alleen voor een aangemelde persoon, nooit voor een API-sleutel.

Een paar dingen doet een agent nooit. Daarvoor geeft de agent je een link naar het juiste formulier in de app, om zelf te openen:

  • Geheimen: een API-sleutel maken (het token), een databaselogin toevoegen, de AI-sleutel instellen, en een bedrijfsaanmelding toevoegen of wijzigen (het client secret). Een wachtwoord, sleutel of client secret gaat nooit door de context van een AI.
  • Aanmeldingen: een Microsoft-account of een ander bronaccount koppelen, wat in je browser gebeurt.
  • Uploads: bestanden zoals een Power BI-sjabloon.
  • Bevestigen dat een tool van een andere toolserver alleen leest (Leest alleen): een agent staat niet in voor de tools die hij daarna zelf mag aanroepen.
  • Goedgekeurde audiences: waarheen de tokens van de app-accounts van een organisatie mogen, de keuze van een Beheerder.
  • De chat met Taki: de agent is zelf de AI, en krijgt de tools van Taki om te lezen en te rekenen.

Elke rol heeft de tools van de rollen erboven in de lijst, en meer. Alleen een persoon betekent dat een API-sleutel de tool nooit krijgt. Kies een rol om de tools te zien. De beschrijvingen zijn die van de tools zelf, in het Engels.

Lezer (59 tools)
ToolDoet (Engels)Soort
approve_kpi_suggestionApprove a suggestion on a KPI you ownoverschrijft of verwijdert, alleen een persoon
call_toolRun a read-only tool of a connected MCP serverleest, bereikt een ander systeem
compare_modelA model's original source, its Ossie document and its translation to target side by side, per dataset, field, relationship and metricleest
confirm_open_pointConfirm that the source now matches the approved definition, after the model was read again: the point closesoverschrijft of verwijdert, alleen een persoon
decline_open_pointClose an open point as won't do, with the reasonoverschrijft of verwijdert, alleen een persoon
describe_metricA metric of a modelleest
describe_tableA table of a modelleest
draft_open_point_queryHave the organisation's AI draft the proposed query of an open point (replacing the one there), marked as an AI draft that a person checksoverschrijft of verwijdert, bereikt een ander systeem, alleen een persoon
findFind KPIs, metrics and tables by the organisation's own words, best first, each with why it matched (its name, a synonym, a concept, its definition)leest
fork_kpi_suggestionMake a suggestion on a KPI you own a new KPI of its own, named namevoegt toe, alleen een persoon
get_analyst_statusWhether Taki, the organisation's AI analyst, can answer and, for what is missing, who may fix itleest
get_conceptA business conceptleest
get_connection_metadataA warehouse connection's latest metadata snapshot (a summary, or with full every definition) and its historyleest
get_jobOne of your jobsleest
get_kpiA KPI in fullleest
get_kpi_governanceA KPI's owners (by display name), its open suggestions to change the definition with who approved and who is still to, the history of suggestions and decisions, and what uses it (models, Power BI reports, dbt models, agents)leest
get_modelA model as the site shows itleest
get_model_documentA model as a documentleest
get_model_versionsThe model's versions per object of its Ossie documentleest
get_ontologyThe ontology as its stored YAML text (null when there is none yet), with its version and last changeleest
get_open_pointOne open point in full: the approved definition, the metric's query when raised and as last read, the proposed query, what uses the KPI, and the historyleest
get_organisationAn organisationleest
get_profileWhat KPIs inheritleest
get_sessionThe account you read the organisation's sources with, or nullleest
get_setupWhere the organisation stands, step by step, and the next stepleest
get_structureThe parts of the organisation KPIs are grouped byleest
list_accountsThe accounts you see in the organisation (your own and its app accounts)leest
list_conceptsEvery business conceptleest
list_connection_toolsAn MCP connection's tools as last read, each with whether it may be called, and whether you are signed in to it (search_tools and call_tool use them)leest
list_credentialsThe stored logins of the organisation you may seeleest
list_importsThe organisation's imported models (each with its id, source and state) and your reads that are runningleest
list_jobsYour recent jobs in the organisation (imports, reads), newest firstleest
list_kpisEvery KPIleest
list_modelsThe organisation's semantic modelsleest
list_ontology_templatesThe sector templates an ontology can start fromleest
list_open_pointsOpen points for engineers: changes to a model's metric that an approved KPI definition asks for (or that someone raised by hand), on models you may seeleest
list_organisationsThe organisations you have a role in, each with your role and whether it allows queriesleest
list_questionsThe organisation's open questions about its definitions (a KPI's unit, a metric's meaning), for contributors to answerleest
list_reportsWhat the reports built on an import's model use, as last readleest
list_source_kindsThe kinds of source a model can be imported from (Power BI, dbt, a database, ...)leest
list_sourcesThe data sources the organisation's models read, each with the connection it matches, and the connections to suggestleest
list_systemsThe business systems the data comes from (a till, an ordering platform), with the tables from eachleest
list_translate_targetsThe platforms a model can be translated to with Ossie's converters (translate_model, compare_model)leest
list_valuesThe exact values of a column (Table[Column]) to filter query_kpi on, optionally only those containing a textleest, waar query's zijn toegestaan
list_waiting_suggestionsThe open suggestions on KPIs you own that wait for your approvalleest
mark_open_point_doneSay the change is made in the source; the point then waits for the model's next read and a confirmationvoegt toe, alleen een persoon
metric_sqlOne SQL statement that computes a metric on the warehouse in a filter contextleest
query_kpiCompute a KPI the way the organisation defines itleest, waar query's zijn toegestaan
query_metricsCompute metrics of a model by name (describe_table and find name them), for what query_kpi can't expressleest, waar query's zijn toegestaan
raise_questionAsk the organisation a question about one of its definitions, for a contributor to answervoegt toe
refresh_kpi_suggestionBring a stale suggestion (the KPI's approved text changed since it was made) up to dateoverschrijft of verwijdert, alleen een persoon
reject_kpi_suggestionReject a suggestion on a KPI you own, with the reasonoverschrijft of verwijdert, alleen een persoon
run_daxRun a DAX query (EVALUATE ...) on a modelleest, waar query's zijn toegestaan, alleen een persoon
search_toolsFind tools of the organisation's connected MCP servers (Jira, a database, its own tools) that can answer a question, by what they doleest, bereikt een ander systeem
set_open_point_proposalWrite or replace the proposed query of an open point (empty removes it); nothing is written to the sourceoverschrijft of verwijdert, alleen een persoon
starter_questionsWhat to ask about a model firstleest
suggest_kpi_changeSuggest a change to a KPI's definition and/or calculation note, with the reasonvoegt toe, alleen een persoon
translate_modelTranslate a model to another platform (list_translate_targets) with Ossie's convertersleest
withdraw_kpi_suggestionWithdraw a suggestion you made while it is openoverschrijft of verwijdert, alleen een persoon
Bijdrager (21 tools)
ToolDoet (Engels)Soort
add_discovered_kpisMake these KPIs found across the models (their keys, from list_discovery) draft KPIs, linked in every model, with a question on which definition leads where they differvoegt toe
add_kpi_candidatesMake these KPI candidates (their ids, from list_kpi_candidates) draft KPIs, linked to their measures, with a question where a candidate has severalvoegt toe
answer_questionAnswer one of the organisation's questions (list_questions)overschrijft of verwijdert
apply_ontology_templateMerge a sector template (list_ontology_templates) into the ontologyvoegt toe
check_metricCheck a metric's SQL translation on the warehouse against Power BI, as a grand total or by group_by [table, column]voegt toe
dismiss_kpi_candidatesLeave these KPI candidates out for goodoverschrijft of verwijdert, vraagt bevestiging
dismiss_questionTake a question off the list unansweredoverschrijft of verwijdert
draft_descriptionsHave Claude draft descriptions and synonyms of an import's tables and metrics from their names, columns and expressions (with the organisation's AI on)overschrijft of verwijdert, bereikt een ander systeem
draft_metricHave Claude draft a SQL translation of a DAX measure the translation rules can't translate (with the organisation's AI on)voegt toe, bereikt een ander systeem
edit_ontology_itemAdd (item, no id), change (id and itemoverschrijft of verwijdert, vraagt bevestiging
explain_discovered_kpiWhat the definitions of one KPI found across the models count differently, in plain words, by Claude (with the organisation's AI on), from the definitions onlyleest, bereikt een ander systeem
list_discoveryThe organisation's KPIs found across all its models, each with the models it is in, and where their definitions differleest
list_kpi_candidatesAn import's KPI candidates, best firstleest
propose_linkPropose that a model object is a KPI or is about a concept, as a draft for the organisation to review (never a reviewed link)voegt toe
raise_open_pointRaise an open point by hand for the engineer: on a KPI (a point per model that computes it) or on one metric, with a notevoegt toe, alleen een persoon
read_reportsRead again from Power BI what the reports built on a Power BI import's model use (list_reports gives the last read), as the organisation's account in usevoegt toe
reopen_questionPut an answered or dismissed question back on the listoverschrijft of verwijdert
replace_ontologyReplace the whole ontology with this YAML textoverschrijft of verwijdert, vraagt bevestiging
review_linkReview a link of a KPI or concept to a model objectoverschrijft of verwijdert, vraagt bevestiging
set_descriptionWrite, change or remove (empty or null) the description of a table, or of one of its columns, by handoverschrijft of verwijdert
set_import_noteSet one note on an import that its definition doesn't say, kept across re-importsoverschrijft of verwijdert
Eigenaar (47 tools)
ToolDoet (Engels)Soort
add_connectionAdd a connection of type (powerbi, azure_sql, dbt, mcp, ...) with its type's fieldsvoegt toe
app_linkThe link to the app's own form for what no tool does, for the person to openleest
assign_open_pointGive an open point to another engineer, by member keyoverschrijft of verwijdert, alleen een persoon
copy_importCopy an import under a new name, without reading its source againvoegt toe
delete_connectionDelete a connection (models read through it stay)overschrijft of verwijdert, vraagt bevestiging
delete_credentialRemove a stored login of yours and its secretoverschrijft of verwijdert, vraagt bevestiging
delete_importDelete an import of yours, its model and what is kept with itoverschrijft of verwijdert, vraagt bevestiging
discover_connectionWhat a login can see for a connection being filled in (its servers, databases, workspaces), to pick its fields fromleest, bereikt een ander systeem
get_ai_keyWhose AI key the organisation uses (its own, the workspace's, none)leest
get_import_progressHow the read of an import goesleest
get_powerbi_catalogEvery workspace a Power BI connection's account can see, with its models and what is imported alreadyleest
import_allImport these Power BI models ([{workspace_id, workspace, dataset_id, dataset_name}] from get_powerbi_catalog), a job each (list_jobs)voegt toe, bereikt een ander systeem
import_connectionRead a connection into a model named name (a database's tables, a Superset's datasets, a dbt project), only schemas if givenvoegt toe, bereikt een ander systeem
import_powerbi_modelRead a Power BI model (dataset_id and dataset_name, from list_connection_models or get_powerbi_catalog) through a connection, or a workspace_id and workspacevoegt toe, bereikt een ander systeem
invite_memberInvite someone by e-mail as contributor or reader (someone who signed in before gets the role at once), or take an invite back with role nulloverschrijft of verwijdert, vraagt bevestiging
link_sourceSay a model's source at this location ({server, database, ...} as list_sources shows it, or {database}) reads through this connection, so lineage follows itvoegt toe
list_approved_audiencesThe token audience and host pairs an admin approved for the organisation's app accountsleest
list_connection_datasetsThe datasets an Amazon QuickSight connection's login can see, with their folders and kindleest
list_connection_modelsThe semantic models in a Power BI connection's workspace, with what is imported alreadyleest
list_connection_schemasThe schemas of a database connection, with how many tables and views each holdsleest
list_membersThe organisation's members (user id, role, e-mail and name as the app shows them to an owner), its waiting invites and its API keys (never a token)leest
list_powerbi_reportsThe Power BI reports the account in use can see, with the models they are built onleest
list_powerbi_workspacesThe Power BI workspaces the account in use can seeleest
read_connection_metadataRead a warehouse connection's metadata again and rebuild the models' lineagevoegt toe
read_connection_toolsRead an MCP connection's tools again from its server (list_connection_tools gives the last read)voegt toe, bereikt een ander systeem
refresh_importRead an import again the way it was madeoverschrijft of verwijdert, bereikt een ander systeem
remove_accountRemove an account and its tokensoverschrijft of verwijdert, vraagt bevestiging
remove_ai_keyRemove the organisation's own AI keyoverschrijft of verwijdert, vraagt bevestiging
revoke_api_keyRevoke an API key (its id, list_members)overschrijft of verwijdert, vraagt bevestiging
set_connection_analystLet Taki run read-only SQL on this database connection (on), or notoverschrijft of verwijdert
set_connection_per_userWhether each person signs in to this MCP connection's server themselves (on) or it reads with one shared loginoverschrijft of verwijdert, vraagt bevestiging
set_connection_visibilityShare a connection of yours with the organisation (entity) or make it privateoverschrijft of verwijdert
set_import_scheduleRead an import again on a scheduleoverschrijft of verwijdert
set_import_visibilityShare an import of yours (its id, list_imports) with the organisation (entity) or make it privateoverschrijft of verwijdert
set_kpi_ownersAssign a KPI's owners, by the member keys get_kpi_governance lists under membersoverschrijft of verwijdert, alleen een persoon
set_memberGive a member (their user id, list_members) the role contributor or reader, or remove them with role nulloverschrijft of verwijdert, vraagt bevestiging
set_profileChange the organisation profile (locale, reporting_currency, vat, fiscal_year_start, week, time_zone, about, sites, groupings, steering)overschrijft of verwijdert, vraagt bevestiging
sign_out_accountSign an account out (list_accounts)overschrijft of verwijdert
sign_out_sessionSign out the account you read the organisation's sources withoverschrijft of verwijdert
test_connectionTest a connectionvoegt toe, bereikt een ander systeem
test_new_connectionTest a connection before adding it, with the same arguments as add_connectionleest, bereikt een ander systeem
unlink_sourceTake a link_source backoverschrijft of verwijdert
update_connectionChange a connection's name, fields and loginoverschrijft of verwijdert
update_credentialRename a stored login of yours (list_credentials) or change who may use itoverschrijft of verwijdert
update_organisationChange the organisation's name, its description (empty removes it), AI on or off (on needs an AI key) and, as an admin only, whether it allows queriesoverschrijft of verwijdert
use_accountRead the organisation's sources with this signed-in account (list_accounts) from now onoverschrijft of verwijdert
download_my_dataEverything this workspace stores about the person the agent acts for, and nothing about anyone else; never for an API key (parity.PERSON_ONLY)leest
Beheerder (11 tools)
ToolDoet (Engels)Soort
create_organisationAdd an organisationvoegt toe
delete_organisationDelete an organisation (its id, always given) and everything stored for itoverschrijft of verwijdert, vraagt bevestiging
get_workspace_ai_keyWhose AI key organisations without their own use (the workspace's, none)leest
list_monitorsThe monitors that read the workspace's status (docs/monitoring.md): name, host, who allowed it, last usedleest
list_sign_insThe workspace's own sign-ins (identity providers)leest
list_workspace_peopleEveryone in the workspace with their organisations and roles there, whether they are admin and why, and the waiting invitesleest
remove_sign_inRemove one of the workspace's sign-ins (its id, list_sign_ins)overschrijft of verwijdert, vraagt bevestiging
remove_workspace_ai_keyRemove the workspace's AI keyoverschrijft of verwijdert, vraagt bevestiging
revoke_monitorRevoke a monitor's token (its id, list_monitors)overschrijft of verwijdert, vraagt bevestiging
set_workspace_adminMake someone (their user id, list_workspace_people) admin of the workspace, or take it backoverschrijft of verwijdert, vraagt bevestiging
workspace_app_linkThe link to the app's Workspace settings for what no tool does, for the person to openleest

Een eigenaar kan een andere MCP-server als verbinding toevoegen (Verbinding toevoegen, MCP server), zoals Jira, Atlassian of Notion. Je agent bereikt de tools daarvan dan via het eigen adres van Depositori. Depositori leest de lijst met tools van de server; alleen de tools die een eigenaar als alleen-lezen bevestigt (Leest alleen) kunnen worden aangeroepen. Een tool die data verandert, wordt nooit uitgevoerd.

  • De Server URL is het adres van de server, zoals https://mcp.example.com/mcp. Op een gehoste Depositori moet dat een openbaar https://-adres zijn; een http://-adres, of een adres op een intern netwerk, wordt geweigerd.
  • De server leest met een API-token, een OAuth-aanmelding, of niets, wat hij nodig heeft.

Sommige toolservers lezen als elke persoon apart. Dan toont de pagina Organisatie iedereen, lezers ook, het deel Je accounts voor agent-tools. Kies Account koppelen naast een server om je eigen account te koppelen; de aanroepen van je agent naar die server gebruiken het dan, en je ziet alleen wat je eigen account mag zien. Opnieuw koppelen vernieuwt het.

Voor scripts, pijplijnen en applicaties die zonder een persoon draaien. Je hebt de rol Eigenaar nodig.

  1. Open Organisatie en zoek API-sleutels.
  2. Kies Sleutel maken, noem hem naar de applicatie die hem gaat gebruiken, en kies Maken.
  3. Kopieer de sleutel nu. Je ziet hem niet nog eens.
Een API-sleutel maken, genoemd naar de app die hem gebruiktEen API-sleutel maken, genoemd naar de app die hem gebruikt

Een sleutel leest één organisatie, als Lezer, en nooit meer: behalve lezen kan hij alleen een vraag over een definitie stellen, zoals een lezer dat kan. Hij krijgt nooit de tools die alleen een persoon heeft (de tabel hierboven): run_dax, een wijziging van een KPI voorstellen of erover beslissen, en werken aan een open punt. Wie een sleutel heeft is geen persoon met een naam, en die zijn daarvoor nodig. Intrekken stopt hem meteen.

Standaard leest een sleutel alleen definities. Wil je dat een applicatie KPI’s laat berekenen, dan zet een Beheerder Query’s via de API toestaan aan onder Organisatie bewerken.

Je ontwikkelaars vinden elke route van de API, met wat die vraagt en wat die antwoordt, op de pagina API-documentatie: /api/v1/docs op het adres van je Depositori, zoals https://depositori.example/api/v1/docs. API-sleutels op de pagina Organisatie linkt ernaar. De pagina is in het Engels.

De pagina met de API-documentatie: de routes van de Depositori-API, met Authorize rechts
  1. Open de pagina. Je hoeft je niet aan te melden: er staan geen gegevens van een organisatie op.
  2. Om een route te proberen kies je Authorize, plak je een API-sleutel (die begint met dpk_) en kies je nog eens Authorize. De pagina vergeet de sleutel als je hem sluit.
  3. Open een route, kies Try it out, vul in wat die vraagt (zoals het id van je organisatie) en kies Execute. Het antwoord staat eronder.

Zonder sleutel antwoordt een route als wie er in die browser bij Depositori is aangemeld, met diens rol. De pagina laadt niets van andere websites.

Dezelfde beschrijving, als bestand voor tools die OpenAPI lezen, staat op /api/v1/openapi.json.