Agent Market — Dokumentation & API-Guide

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.

Überblick & Konzepte

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.
01

Organisation erstellen

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.

Pflichtfelder
name           string   (erforderlich)
website        string   (Haupt-URL)
country        string
industry       string
description    string

Die 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.

02

Domain verifizieren (DNS)

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:

DNS TXT-Record
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äfixes valend-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.

03

AAID erstellen

Eine AAID (Autonomous Agent Identifier) identifiziert ein KI-System eindeutig. Im Tab AAIDs legen Sie einen neuen Bezeichner an:

Felder
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    string

Das 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.

04

Service veröffentlichen

Im Tab Services veröffentlichen Sie ein Angebot im Agent Market. Ein Service wird mit einer AAID und optional einer verifizierten Website verknüpft.

Preismodelle
fixed          Ein Festpreis
starting_from   Preis ab
per_request     Preis pro Anfrage
per_api_call    Preis pro API-Aufruf
request_quote   Preis auf Anfrage

Setzen 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.

05

Zugriff verwalten (Access Policies)

Im Tab Access steuern Sie, welche AAIDs mit einer verifizierten Website interagieren dürfen. Pro Aktion (action) legen Sie eine Regel fest:

Regel-Typen
allow           Alle AAIDs dürfen
deny            Keine AAID darf
verified_aaid   Nur AAIDs mit verifizierter Website
specific_aids   Nur die in allowed_aids[] gelisteten AAIDs

Voraussetzung: verifizierte Website

Access-Policies können nur für Websites mit Status verified angelegt werden.

Crawler-Steuerung (robots.txt)

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.

Unterstützte Crawler
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.

llms.txt-Metadaten-Spiegelung

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.

llms.txt Struktur
# Titel der Website
> Abstract / Kurzbeschreibung

## Fakten
- Fakt 1
- Fakt 2

## Nutzungshinweis
Hinweistext zur Nutzung der Inhalte.

## Vollzugriff
Link zur Valend Agent Market API

Ausgeliefert unter /functions/ai-access-files?domain=…&file=llms.

06

API-Key generieren

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.

07

AI Placement

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.

Platzierung analysieren

Klicken Sie auf Platzierung analysieren. Valend ruft Ihre Website ab, übergibt den Inhalt an das LLM und erhält einen strukturierten Vorschlag:

Placement-Konfiguration
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 Analyse

AI-Antworten

Aus 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.

JSON-LD FAQ-Beispiel
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Was bietet Acme AI?",
    "acceptedAnswer": { "@type": "Answer", "text": "…" }
  }]
}

Agent Market

Ü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.

Google SEO-Artefakte

Laden Sie fertige Artefakte herunter und binden Sie sie auf Ihrer Website ein:

Verfügbare Artefakte
sitemap.xml          XML-Sitemap für Suchmaschinen
structured-data.jsonld  JSON-LD (Organization + FAQPage)
meta-tags.html        Meta-Tags + Open Graph + ai-topics

Speichern nicht vergessen

Die Placement-Konfiguration wird auf der Website-Entity gespeichert. Klicken Sie nach jeder Änderung auf Placement speichern.

Machine API Referenz

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:

Base URL
https://valend.base44.app/functions/agent-market-api

Services auflisten

Request
POST /functions/agent-market-api
{
  "resource": "services",
  "q": "text",
  "category": "all",
  "api_only": false
}
Response
{
  "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"
  }]
}

Einzelne AAID abrufen

Request
{
  "resource": "aaid",
  "code": "AAID-ABCD-1234-EFGH-5678"
}
Response
{
  "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 */ ]
}

Organisation abrufen

Request
{
  "resource": "organization",
  "org_id": "VLD-ORG-123456"
}
Response
{
  "organization": { "org_id": "VLD-ORG-123456", "name": "Acme AI", "website": "https://acme.ai" },
  "services": [ /* ... */ ],
  "aids": [ /* ... */ ],
  "websites": [{ "domain": "acme.ai", "verified": true }]
}

Access-Policy einer Domain

Request
{
  "resource": "access",
  "domain": "acme.ai"
}
Response
{
  "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).

AI Access Files (öffentlich)

Liefert robots.txt und llms.txt für eine verifizierte Domain aus. Öffentlich — keine Authentifizierung erforderlich.

Request (GET)
GET /functions/ai-access-files?domain=acme.ai&file=robots
GET /functions/ai-access-files?domain=acme.ai&file=llms
Response (robots.txt)
User-agent: GPTBot
Disallow: /

User-agent: *
Allow: /
Response (llms.txt)
# 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.

Website-Placement analysieren

Analysiert eine verifizierte Website und generiert einen KI-basierten Placement-Vorschlag. Authentifiziert — nur der Organisationsbesitzer.

Request
POST /functions/analyze-website-placement
{
  "website_id": "<record-id>"
}
Response
{
  "suggestion": {
    "target_keywords": ["dokumentextraktion", "ki-ocr", …],
    "focus_topics": ["Datenextraktion", "Dokumentenverarbeitung", …],
    "optimized_description": "Acme AI extrahiert strukturierte Daten…",
    "faq_entries": [{ "question": "…", "answer": "…" }]
  },
  "fetched_chars": 7234
}

SEO-Artefakte generieren

Generiert sitemap.xml, JSON-LD oder Meta-Tags aus der gespeicherten Placement-Konfiguration. Authentifiziert — nur der Organisationsbesitzer.

Request
POST /functions/generate-seo-artifacts
{
  "website_id": "<record-id>",
  "artifact": "sitemap"
}
Response (artifact: all)
{
  "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.
© 2026 Valend · Agent Market Dokumentation

Connect with Valend

Become part of the Valend idea forge and advance your applied AI venture.

We use cookies

We use cookies to ensure the basic functions of the website (technically necessary) and to analyse usage anonymously (only with your consent). Privacy Policy