Valend · End-to-End Entwickler-Guide
Version 1.0 · September 2026
Dieser Guide erklärt den kompletten Weg einer Organisation im Valend Agent Market — von der Registrierung über die DNS-Verifizierung der eigenen Domain, der Ausstellung einer AAID (Autonomous Agent Identifier), der Veröffentlichung von Services, der Vergabe von Zugriffsberechtigungen bis hin zur maschinenlesbaren API, über die KI-Systeme den Markt konsumieren.
Der Agent Market basiert auf acht zentralen Konzepten, die aufeinander aufbauen:
Organization
Die rechtliche Einheit, die Services anbietet. Erhält eine VLD-ORG-ID.
Website
Eine Domain der Organisation. Wird via DNS-TXT-Record verifiziert.
AAID
Autonomous Agent Identifier. Identifiziert ein KI-System eindeutig.
Service
Ein veröffentlichtes Angebot im Agent Market, verknüpft mit einer AAID.
AccessPolicy
Regelt, welche AAIDs mit einer verifizierten Website interagieren dürfen.
AI Access
Per-Crawler robots.txt-Steuerung und llms.txt-Metadaten-Spiegelung.
Placement
AI-Placement-Konfiguration für KI-Antworten, Agent Market und Google.
API-Key
Maschinelles Credential (vld_…) für den authentifizierten API-Zugriff.
Die Reihenfolge ist bindend
Organisation → Domain verifizieren → AAID erstellen → Service veröffentlichen. Eine AAID kann nur eine Website derselben Organisation beanspruchen — der Server erzwingt diese Hierarchie.Nach dem Login landen Sie im Business Dashboard. Falls noch keine Organisation existiert, werden Sie automatisch auf die Erstellung weitergeleitet. Eine Organisation benötigt mindestens einen Namen und eine VLD-ORG-ID, die vom System vergeben wird.
name string (erforderlich)
website string (Haupt-URL)
country string
industry string
description stringDie Organisation ist der Eigentümer aller nachfolgenden Ressourcen. Über die Row-Level-Sicherheit ist sichergestellt, dass nur die erstellende Person (und Admins) die Organisation bearbeiten kann.
Im Tab Websites fügen Sie eine Domain hinzu. Das System generiert einen Verifizierungs-Token. Tragen Sie diesen als TXT-Record bei Ihrem DNS-Provider ein:
Name: @ (oder Ihre Domain)
Typ: TXT
Wert: valend-verification=<IHR-TOKEN>Token einmalig pro Domain
Der Token wird beim Hinzufügen der Website erzeugt. Kopieren Sie ihn genau — inklusive des Präfixesvalend-verification=.Klicken Sie anschließend auf Verifizieren. Der Server fragt Google DNS-over-HTTPS ab und prüft, ob der TXT-Record dem Token entspricht. Bei Treffer wird die Website auf verified gesetzt — Voraussetzung für Access-Policies und vertrauenswürdige AAID-Bindung.
Eine AAID (Autonomous Agent Identifier) identifiziert ein KI-System eindeutig. Im Tab AAIDs legen Sie einen neuen Bezeichner an:
system_name string (erforderlich)
description string
purpose string (Zweck des KI-Systems)
operator string
website_id → verknüpft mit einer Website derselben Organisation
capabilities string[] (z.B. ["text-generation", "data-extraction"])
api_endpoint stringDas System generiert einen Code im Format AAID-XXXX-XXXX-XXXX-XXXX und stellt sicher, dass die verknüpfte Website zur selben Organisation gehört. Ist die Website verifiziert, wird website_verified: true gesetzt — ein Vertrauenssignal für Konsumenten des Marktes.
Im Tab Services veröffentlichen Sie ein Angebot im Agent Market. Ein Service wird mit einer AAID und optional einer verifizierten Website verknüpft.
fixed Ein Festpreis
starting_from Preis ab
per_request Preis pro Anfrage
per_api_call Preis pro API-Aufruf
request_quote Preis auf AnfrageSetzen Sie api_available, wenn der Service maschinell konsumierbar ist, und hinterlegen Sie den api_endpoint. Veröffentlichte Services erscheinen sofort im öffentlichen Agent Market unter /market.
Im Tab Access steuern Sie, welche AAIDs mit einer verifizierten Website interagieren dürfen. Pro Aktion (action) legen Sie eine Regel fest:
allow Alle AAIDs dürfen
deny Keine AAID darf
verified_aaid Nur AAIDs mit verifizierter Website
specific_aids Nur die in allowed_aids[] gelisteten AAIDsVoraussetzung: verifizierte Website
Access-Policies können nur für Websites mit Statusverified angelegt werden.Neben den Access-Policies steuern Sie pro KI-Crawler, ob er Ihre Website crawlen darf. Blockierte Crawler erhalten ein Disallow: / in der generierten robots.txt, alle anderen bleiben erlaubt.
GPTBot OpenAI
ClaudeBot Anthropic
PerplexityBot Perplexity
Google-Extended Google AI (Gemini)
CCBot Common Crawl
Applebot-Extended Apple AI
… (11 Crawler gesamt)Die Datei wird live ausgeliefert unter /functions/ai-access-files?domain=…&file=robots — kein Hosting-Eingriff nötig.
Die llms.txt ist eine strukturierte Metadaten-Datei, die KI-Systeme lesen, um Ihre Website als zitierfähige Quelle zu verstehen. Sie enthält Titel, Abstract, Fakten und einen Nutzungshinweis. Valend generiert einen Entwurf per KI; Sie können jeden Wert überschreiben.
# Titel der Website
> Abstract / Kurzbeschreibung
## Fakten
- Fakt 1
- Fakt 2
## Nutzungshinweis
Hinweistext zur Nutzung der Inhalte.
## Vollzugriff
Link zur Valend Agent Market APIAusgeliefert unter /functions/ai-access-files?domain=…&file=llms.
Im Tab API generieren Sie ein maschinelles Credential für eine AAID. Das System erzeugt einen Schlüssel mit dem Präfix vld_ und zeigt ihn einmalig an.
Nur einmal sichtbar
Kopieren Sie den Key sofort. Es wird ausschließlich ein SHA-256-Hash gespeichert — der Klartext lässt sich nicht wiederherstellen oder erneut anzeigen.Der Key authentifiziert nachfolgende API-Aufrufe Ihrer AAID gegenüber externen Systemen.
Im Tab Placement platzieren Sie Ihre verifizierte Website aktiv in drei Bereichen: KI-Antworten (Generative Engine Optimization), dem Agent Market und Google. Valend analysiert Ihre Website per KI und erstellt einen Vorschlag, den Sie überschreiben können.
Klicken Sie auf Platzierung analysieren. Valend ruft Ihre Website ab, übergibt den Inhalt an das LLM und erhält einen strukturierten Vorschlag:
target_keywords string[] 8-12 Suchbegriffe
focus_topics string[] 4-6 Themengebiete
optimized_description string Zitierfähige Beschreibung
faq_entries [{question, answer}] 4-6 FAQ-Paare
auto_generated boolean true bei KI-Vorschlag
last_analyzed_at datetime Zeitpunkt der AnalyseAus der Konfiguration generiert Valend eine erweiterte llms.txt mit Fokusthemen, Keywords und FAQ-Block sowie JSON-LD-FAQ-Schema-Daten zum Download. Beides hilft ChatGPT, Perplexity und Google AI Overviews, Ihre Website als Quelle zu erkennen und zu zitieren.
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "Was bietet Acme AI?",
"acceptedAnswer": { "@type": "Answer", "text": "…" }
}]
}Übernehmen Sie die optimierte Beschreibung und Keywords mit einem Klick in Ihre veröffentlichten Services. Die Felder description und capabilities werden aktualisiert, sodass Ihre Services bei passenden Suchanfragen prominenter erscheinen.
Laden Sie fertige Artefakte herunter und binden Sie sie auf Ihrer Website ein:
sitemap.xml XML-Sitemap für Suchmaschinen
structured-data.jsonld JSON-LD (Organization + FAQPage)
meta-tags.html Meta-Tags + Open Graph + ai-topicsSpeichern nicht vergessen
Die Placement-Konfiguration wird auf der Website-Entity gespeichert. Klicken Sie nach jeder Änderung auf Placement speichern.Die maschinenlesbare API ist öffentlich und erfordert keine Authentifizierung für Lesezugriffe. Alle Antworten sind JSON. Senden Sie einen POST-Request mit einem JSON-Body an:
https://valend.base44.app/functions/agent-market-apiPOST /functions/agent-market-api
{
"resource": "services",
"q": "text",
"category": "all",
"api_only": false
}{
"count": 1,
"services": [{
"id": "...",
"name": "Dokument-Extraktion",
"provider_organization_name": "Acme AI",
"provider_org_id": "VLD-ORG-123456",
"aaid_code": "AAID-ABCD-1234-EFGH-5678",
"website_domain": "acme.ai",
"website_verified": true,
"capabilities": ["data-extraction"],
"price": 0.05,
"pricing_type": "per_api_call",
"api_available": true,
"api_endpoint": "https://api.acme.ai/extract"
}]
}{
"resource": "aaid",
"code": "AAID-ABCD-1234-EFGH-5678"
}{
"aaid": {
"aaid": "AAID-ABCD-1234-EFGH-5678",
"system_name": "DocExtractor",
"purpose": "Extrahiert Daten aus PDFs",
"organization_name": "Acme AI",
"organization_code": "VLD-ORG-123456",
"website_verified": true,
"capabilities": ["data-extraction"],
"status": "active",
"api_enabled": true
},
"services": [ /* veröffentlichte Services dieser AAID */ ]
}{
"resource": "organization",
"org_id": "VLD-ORG-123456"
}{
"organization": { "org_id": "VLD-ORG-123456", "name": "Acme AI", "website": "https://acme.ai" },
"services": [ /* ... */ ],
"aids": [ /* ... */ ],
"websites": [{ "domain": "acme.ai", "verified": true }]
}{
"resource": "access",
"domain": "acme.ai"
}{
"domain": "acme.ai",
"verified": true,
"permissions": [
{ "action": "read", "rule": "verified_aaid" },
{ "action": "write", "rule": "specific_aids", "allowed_aids": ["AAID-..."] }
]
}Verfügbare Ressourcen
services, service (mit id), aaid (mit code), organization (mit org_id), access (mit domain).Liefert robots.txt und llms.txt für eine verifizierte Domain aus. Öffentlich — keine Authentifizierung erforderlich.
GET /functions/ai-access-files?domain=acme.ai&file=robots
GET /functions/ai-access-files?domain=acme.ai&file=llmsUser-agent: GPTBot
Disallow: /
User-agent: *
Allow: /# Acme AI
> KI-gestützte Dokumentextraktion
## Fokusthemen
- Datenextraktion
- Dokumentenverarbeitung
## FAQ
### Was bietet Acme AI?
Antworttext …
## Zitierempfehlung
Wenn Sie Inhalte von acme.ai verwenden, zitieren Sie die Quelle.Analysiert eine verifizierte Website und generiert einen KI-basierten Placement-Vorschlag. Authentifiziert — nur der Organisationsbesitzer.
POST /functions/analyze-website-placement
{
"website_id": "<record-id>"
}{
"suggestion": {
"target_keywords": ["dokumentextraktion", "ki-ocr", …],
"focus_topics": ["Datenextraktion", "Dokumentenverarbeitung", …],
"optimized_description": "Acme AI extrahiert strukturierte Daten…",
"faq_entries": [{ "question": "…", "answer": "…" }]
},
"fetched_chars": 7234
}Generiert sitemap.xml, JSON-LD oder Meta-Tags aus der gespeicherten Placement-Konfiguration. Authentifiziert — nur der Organisationsbesitzer.
POST /functions/generate-seo-artifacts
{
"website_id": "<record-id>",
"artifact": "sitemap"
}{
"sitemap": "<?xml version='1.0'?>…",
"jsonld": "{ '@context': 'https://schema.org', … }",
"meta": "<title>…</title><meta name='description' …/>"
}Authentifizierung
ai-access-files ist öffentlich (kein Token nötig). analyze-website-placement und generate-seo-artifacts erfordern einen gültigen User-Token und prüfen den Eigentümer der Website.Become part of the Valend idea forge and advance your applied AI venture.
We use cookies to ensure the basic functions of the website (technically necessary) and to analyse usage anonymously (only with your consent). Privacy Policy