CONTENTUM.COMUm especialista. Um plano. Um resultado.

Documentação · 11 / 12

Acesso para agentes

As funções públicas como ferramentas para agentes de IA. Sem chave de API.

Quatro formas de entrar

  • Servidor MCP em /mcp (Streamable HTTP)
  • Agente A2A em /a2a com um cartão de agente em /.well-known/agent-card.json
  • WebMCP na página /agents/ para agentes dentro do navegador
  • API JSON em /agents/api, descrita por /agents/openapi.json

O que os agentes podem fazer

Pesquisar projetos e concursos, ler áreas de serviço, países e cobertura de prestadores, consultar vulnerabilidades, ler guias, executar o CONTENTUM Check, testar o âmbito da NIS2, enviar um pedido em nome de uma empresa ou de um prestador e consultar o seu estado.

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

Limites e privacidade

As ferramentas de leitura estão abertas, com um limite por endereço. As ferramentas que enviam dados têm um limite mais apertado. Os agentes veem o que as páginas públicas mostram: sem nomes de empresas, e os prestadores apenas como números.

O mapa do domínio e o Deep Scan não estão abertos a agentes anónimos, porque exigem a autorização do proprietário.

Descrições legíveis por máquina

llms.txt e /agents/llms.txt descrevem o site e as ferramentas para modelos de linguagem. O ficheiro OpenAPI, o cartão de agente e o cartão do servidor MCP descrevem as interfaces. Esta documentação está disponível num ficheiro Markdown por língua em /docs/docs.md.

Casos de uso

Um agente encontra um prestador para o seu mandante

  1. Chame search_projects ou get_provider_coverage para ver o mercado.
  2. Chame submit_project_request com empresa, e-mail e descrição.
  3. Guarde o número do pedido.
  4. Chame get_request_status mais tarde e reporte o resultado.

Um agente responde a uma pergunta de segurança

  1. Chame get_vulnerability para a CVE em causa.
  2. Chame list_guides e get_guide para o contexto.
  3. Chame run_domain_check para um domínio que o mandante esteja autorizado a verificar.
  4. Dê a resposta com as ligações dos resultados.

Histórias de utilizador

  • Como agente de IA, quero enviar um pedido sem formulário nem captcha, para concluir a tarefa do meu mandante.
  • Como programador, quero um endpoint MCP sem registo, para ligar o meu assistente num minuto.
  • Como operador, quero que os agentes vejam apenas dados públicos, para que nenhum nome de empresa seja divulgado.

Atualizado: