AI Agents & Integrazioni

Questi file permettono ad agenti AI, LLM e strumenti per sviluppatori di consumare le API Contit in modo programmatico.

Specifica OpenAPI

La specifica completa delle API in formato machine-readable:

File	Formato	Caso d'uso
openapi.yaml	YAML	Importa in Postman, Insomnia, Swagger UI
openapi.json	JSON	Consumo programmatico, generatori di codice

LLMs.txt

File	Descrizione
llms.txt	Indice strutturato della documentazione per agenti AI (standard llmstxt.org)

Gli agenti AI possono leggere questo file per capire cosa offre l'API Contit e trovare la pagina di documentazione corretta.

Tool Schemas

Definizioni di tool pronte per l'uso con piattaforme AI:

File	Piattaforma	Caso d'uso
claude.json	Claude (Anthropic)	Usa gli endpoint Contit come tool di Claude
openai.json	OpenAI (GPT)	Usa gli endpoint Contit come function call di GPT

Esempio: Uso con Claude

import json
import anthropic

# Carica le definizioni dei tool Contit
with open("claude.json") as f:
    contit_tools = json.load(f)["tools"]

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    tools=contit_tools,
    messages=[{"role": "user", "content": "Cerca tutti gli articoli pubblicati"}]
)

Esempio: Uso con OpenAI

import json
import openai

with open("openai.json") as f:
    contit_tools = json.load(f)["tools"]

client = openai.OpenAI()
response = client.chat.completions.create(
    model="gpt-4o",
    tools=contit_tools,
    messages=[{"role": "user", "content": "Cerca tutti gli articoli pubblicati"}]
)