CONTENTUM.COMUn spécialiste. Un plan. Un résultat.

Documentation · 11 / 12

Accès pour les agents

Les fonctions publiques sous forme d’outils pour les agents IA. Sans clé d’API.

Quatre voies d’accès

  • Serveur MCP à l’adresse /mcp (Streamable HTTP)
  • Agent A2A à l’adresse /a2a avec une carte d’agent à /.well-known/agent-card.json
  • WebMCP sur la page /agents/ pour les agents dans le navigateur
  • API JSON sous /agents/api, décrite par /agents/openapi.json

Ce que les agents peuvent faire

Rechercher des projets et des appels d’offres, lire les domaines de services, les pays et la couverture par les prestataires, consulter des vulnérabilités, lire des guides, lancer le CONTENTUM Check, tester le périmètre NIS2, envoyer une demande pour une entreprise ou un prestataire et en demander le statut.

OutilCe qu’il faitType
search_projectsOpen cybersecurity and IT infrastructure projects and public tenders by service, country and words.lecture
get_projectOne project or tender by id (CT-0001): services, country, signal, regulations, technologies, deadline.lecture
list_servicesThe 12 service areas with their open project counts.lecture
get_serviceOne service area: description, typical tasks, demand signal, open projects, provider count.lecture
list_countriesCountries with counts of company projects, tenders and listed providers.lecture
get_countryOne country: open projects by service, tenders, providers by service, latest projects.lecture
get_provider_coverageHow many listed providers offer a service in a country (counts only).lecture
get_market_statsTotals: open projects, tenders, countries, demand per service and regulation, data date.lecture
search_vulnerabilitiesCVE records by vendor or year, or the actively exploited ones (CISA KEV).lecture
get_vulnerabilityOne CVE: description, CVSS, weaknesses, references and whether it is actively exploited.lecture
list_guidesBuyer guides (NIS2, penetration testing, ISO 27001, OWASP …) in a given language.lecture
get_guideFull text of one guide with sections, questions and sources.lecture
run_domain_checkPassive security check of a domain: TLS, security headers, SPF, DMARC, security.txt. Returns score and report link.envoie des données
check_nis2_scopeWhether an organisation is probably covered by NIS2, from sector and size.lecture
get_platform_infoWhat CONTENTUM does, what a request needs, contacts, languages and the agent endpoints.lecture
submit_project_requestA company describes the work it needs. Returns a request id; the team replies by e-mail.envoie des données
register_provider_interestA service provider asks to be listed or registers interest in a project. Returns an id.envoie des données
get_request_statusStatus of a request (id + e-mail).lecture

Limites et confidentialité

Les outils de lecture sont ouverts, avec une limite par adresse. Les outils qui envoient des données ont une limite plus stricte. Les agents voient ce que montrent les pages publiques : pas de noms d’entreprises, et les prestataires uniquement sous forme de nombres.

La carte du domaine et le Deep Scan ne sont pas ouverts aux agents anonymes, car ils exigent l’autorisation du propriétaire.

Descriptions lisibles par machine

llms.txt et /agents/llms.txt décrivent le site et les outils pour les modèles de langage. Le fichier OpenAPI, la carte d’agent et la carte du serveur MCP décrivent les interfaces. Cette documentation est disponible sous la forme d’un fichier Markdown par langue à l’adresse /docs/docs.md.

Cas d’usage

Un agent trouve un prestataire pour son mandant

  1. Appelez search_projects ou get_provider_coverage pour voir le marché.
  2. Appelez submit_project_request avec l’entreprise, l’e-mail et la description.
  3. Conservez le numéro de la demande.
  4. Appelez get_request_status plus tard et rendez compte.

Un agent répond à une question de sécurité

  1. Appelez get_vulnerability pour la CVE concernée.
  2. Appelez list_guides et get_guide pour le contexte.
  3. Appelez run_domain_check pour un domaine que le mandant est autorisé à contrôler.
  4. Donnez la réponse avec les liens issus des résultats.

User stories

  • En tant qu’agent IA, je veux envoyer une demande sans formulaire ni captcha, afin de terminer la tâche pour mon mandant.
  • En tant que développeur, je veux un point d’accès MCP sans inscription, afin de connecter mon assistant en une minute.
  • En tant qu’exploitant, je veux que les agents ne voient que des données publiques, afin qu’aucun nom d’entreprise ne fuite.

Mis à jour: