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.
| Ferramenta | O que faz | Tipo |
|---|---|---|
search_projects | Open cybersecurity and IT infrastructure projects and public tenders by service, country and words. | lê |
get_project | One project or tender by id (CT-0001): services, country, signal, regulations, technologies, deadline. | lê |
list_services | The 12 service areas with their open project counts. | lê |
get_service | One service area: description, typical tasks, demand signal, open projects, provider count. | lê |
list_countries | Countries with counts of company projects, tenders and listed providers. | lê |
get_country | One country: open projects by service, tenders, providers by service, latest projects. | lê |
get_provider_coverage | How many listed providers offer a service in a country (counts only). | lê |
get_market_stats | Totals: open projects, tenders, countries, demand per service and regulation, data date. | lê |
search_vulnerabilities | CVE records by vendor or year, or the actively exploited ones (CISA KEV). | lê |
get_vulnerability | One CVE: description, CVSS, weaknesses, references and whether it is actively exploited. | lê |
list_guides | Buyer guides (NIS2, penetration testing, ISO 27001, OWASP …) in a given language. | lê |
get_guide | Full text of one guide with sections, questions and sources. | lê |
run_domain_check | Passive security check of a domain: TLS, security headers, SPF, DMARC, security.txt. Returns score and report link. | envia dados |
check_nis2_scope | Whether an organisation is probably covered by NIS2, from sector and size. | lê |
get_platform_info | What CONTENTUM does, what a request needs, contacts, languages and the agent endpoints. | lê |
submit_project_request | A company describes the work it needs. Returns a request id; the team replies by e-mail. | envia dados |
register_provider_interest | A service provider asks to be listed or registers interest in a project. Returns an id. | envia dados |
get_request_status | Status 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
- Chame search_projects ou get_provider_coverage para ver o mercado.
- Chame submit_project_request com empresa, e-mail e descrição.
- Guarde o número do pedido.
- Chame get_request_status mais tarde e reporte o resultado.
Um agente responde a uma pergunta de segurança
- Chame get_vulnerability para a CVE em causa.
- Chame list_guides e get_guide para o contexto.
- Chame run_domain_check para um domínio que o mandante esteja autorizado a verificar.
- 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: