iaos-sdk (0.2.0)
Installation
pip install --index-url https://git.it.iaos.cc/api/packages/mapfarm/pypi/simple/ --extra-index-url https://pypi.org/simple iaos-sdkAbout this package
SDK Python des produits pour le noyau iaos — connecteurs, notifier, corpus, lecture, runs hébergés (ADR-078 §11 P2.16).
iaos-sdk — SDK Python des produits pour le noyau iaos
ADR-078 §11 P2.16 (« SDK publiés sur la forge ») : une source au lieu de copies vendorées produit par produit. Version 0.2.0 :
| Module | Ce qu'il fait | Remplace |
|---|---|---|
iaos_sdk.connecteurs |
appels de connecteurs par le noyau (POST /api/connectors/<nom>/call : DataForSEO, Keepa, Google Trends, Arctic Shift), run courant transmis, erreurs claires (NoyauConnecteurError) |
graphs/common/core/iaos_gateway.py de harvest et fdm (0.1.0) |
iaos_sdk.notifier |
courriel et Slack d'exploitation par la capacité « notifier » (POST /api/iaos/v1/notifier), une seule fois (cle_idempotence), categorie transactionnel / diffusion |
graphs/common/core/iaos_notifier.py de harvest et fdm (0.1.0) |
iaos_sdk.corpus |
socle documentaire : RAG (query, query_producer, query_scoped, budgets de grounding), ingestion (simple ou gouvernée), propositions DRAFT, génération gouvernée, vecteurs, lecture de documents (par réf, résolution stricte, contenu exact, historique) |
corpus_client.py de harvest et fdm (copies identiques) et de la factory (copie divergente) — 0.2.0 |
iaos_sdk.lecture |
lecture du noyau : runs, événements et flux SSE d'un run, coûts, missions, tenants, registres ; clé scopée par tenant ; lectures de MESURE strictes (LectureImpossibleError) |
iaos_read_client.py de la factory — 0.2.0 |
iaos_sdk.runs |
protocole des runs hébergés (ADR-075) : ouvrir, raconter un nœud, battre, clore, relire — sync et async, lève en cas d'échec | le fil HTTP de app/services/iaos_client.py (mapbox) et apps-api/iaos_client.py (iaos-apps) — 0.2.0 |
Restent hors du SDK, à dessein : src/agents/meta_corpus_client.py du cockpit (pas une copie :
lecteur strict à contrat — claims_blocked == 0, ACTIVE, provenance — propre au rapport
d'orchestration) ; la POLITIQUE des clients de runs (allowlist d'agents, entité imputée, clé LLM
du run, dégradation) qui reste au produit.
Points de variation du client corpus
Ce qui différait entre les copies est réglé par le produit, une fois, dans son module d'alias
(iaos_sdk.corpus.regler(...)) — jamais deviné par le SDK :
| Réglage | Défaut | harvest / fdm | factory |
|---|---|---|---|
sur_claims_bloques(node, n, motifs) |
aucun | node_events_client.post_claim_blocked |
— |
est_entite_plateforme(company_id) |
aucun → entité (repli sûr) | company_id in entities.ACCEPTED_ENTITIES |
— |
ingestion |
"enveloppe" (ingested/pending/error) |
"enveloppe" |
"socle" (réponse brute, skipped/refused/error + motif du corps) |
controle_ingestion(company_id, contenu) |
aucun | — | gate W14 corpus_tenancy.check_content_ownership |
provenance_inline |
False |
— | True ([source: titre · id: réf] en tête de morceau) |
entite_defaut |
hold |
— | ENTITE |
agent_onboarding |
harvest-onboarding |
— | — |
Installation — référence directe, jamais par nom
Le registre PyPI de la forge publie le paquet (.gitea/workflows/publish-iaos-sdk.yml,
déclenchement manuel). On l'installe par URL + empreinte, jamais par nom avec
--extra-index-url (dependency confusion : un tiers pourrait publier iaos-sdk sur
pypi.org) :
iaos-sdk @ https://git.it.iaos.cc/api/packages/mapfarm/pypi/files/iaos-sdk/0.2.0/iaos_sdk-0.2.0-py3-none-any.whl#sha256=<empreinte de la page simple/iaos-sdk/>
Monter de version = changer l'URL ET l'empreinte (outil : ~/.cache/iaos-outils/epingler_forge.py).
Adoption dans un produit sans toucher aux appelants
L'ancien module devient un ALIAS du module du SDK ; les imports existants et les
monkeypatch des tests visent le même objet module :
# graphs/common/core/iaos_gateway.py — désormais fourni par iaos-sdk
import sys
import iaos_sdk.connecteurs as _sdk
sys.modules[__name__] = _sdk
Un module à points de variation se règle AVANT l'alias :
# corpus_client.py — désormais fourni par iaos-sdk
import sys
import iaos_sdk.corpus as _sdk
def _claims_bloques(node, blocked, reasons):
from graphs.common.node_events_client import post_claim_blocked # lu à l'appel (tests)
post_claim_blocked(node, blocked, reasons)
_sdk.regler(sur_claims_bloques=_claims_bloques)
sys.modules[__name__] = _sdk
Configuration (environnement)
IAOS_API_URL (défaut http://iaos-api:8000), IAOS_PROJECT_KEY (clé projet, X-Iaos-Key),
IAOS_CONNECTOR_TENANT (défaut historique harvest), CONNECTEURS_VIA_NOYAU,
IAOS_NOTIFIER_COMPANY (défaut hold), MESSAGES_VIA_NOYAU ; corpus : CORPUS_API_URL,
CORPUS_DOC_API_URL, CORPUS_API_KEY, CORPUS_DRAFT_KEY, CORPUS_TENANT_ID,
CORPUS_HOLDING_COMPANY ; lecture : IAOS_READ_TIMEOUT, IAOS_TENANT_KEYS,
IAOS_TENANT_KEY_<TENANT>, IAOS_TENANT_KEY, IAOS_SERVICE_KEY — voir l'en-tête de chaque
module. iaos_sdk.runs ne lit pas l'environnement : base et clé sont passées par l'appelant.
Développement
pip install -e ".[test]" ruff
ruff check src tests && ruff format --check src tests && pytest -q