ComposioHQ/Attio-Automation

Attio-Automatisierung

Verwalten Sie Ihren Attio CRM-Arbeitsbereich – Fuzzy-Suche über Personen und Unternehmen, führen Sie komplexe gefilterte Abfragen durch, durchsuchen Sie Notizen, entdecken Sie Objektschemas und listen Sie Datensätze auf – alles über natürliche Sprachbefehle.

Toolkit-Dokumentation: composio.dev/toolkits/attio

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Client-Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Attio-Konto, wenn Sie dazu aufgefordert werden (OAuth-Authentifizierung).
3. Beginnen Sie, natürliche Sprachbefehle zur Verwaltung Ihrer CRM-Daten zu geben.

---

Kern-Workflows

1. Fuzzy-Suche über Datensätze

Suche nach Personen, Unternehmen, Deals oder anderen Objekten nach Name, Domain, E-Mail, Telefon oder Social Handle.

Tool: ATTIO_SEARCH_RECORDS

Beispiel-Prompt:

„Suche in Attio nach jemandem namens Alan Mathis"

Wichtige Parameter (alle erforderlich):

• query – Suchstring (maximal 256 Zeichen). Ein leerer String gibt Standardergebnisse zurück.
• objects – Array von Objekt-Slugs, in denen gesucht werden soll (z. B. ["people"], ["people", "companies"], ["deals"])
• request_as – Kontext: verwenden Sie {"type": "workspace"} für eine vollständige Workspace-Suche oder geben Sie ein Workspace-Mitglied an

---

2. Erweiterte gefilterte Abfragen

Fragen Sie Datensätze mit serverseitiger Filterung, Sortierung und komplexen Bedingungen ab – deutlich leistungsfähiger als die Fuzzy-Suche.

Tool: ATTIO_QUERY_RECORDS

Beispiel-Prompt:

„Finde alle Unternehmen in Attio, die nach Januar 2025 erstellt wurden, sortiert nach Namen"

Wichtige Parameter:

• object (erforderlich) – Objekt-Slug oder UUID (z. B. „people", „companies", „deals")
• filter – Attio-Filterobjekt mit Operatoren wie $eq, $contains, $gte, $and, $or
• sorts – Array von Sortierspezifikationen mit direction („asc"/„desc") und attribute
• limit – Maximale Anzahl zurückzugebender Datensätze (bis zu 500)
• offset – Paginierungs-Offset

Filterbeispiele:

{"name": {"first_name": {"$contains": "John"}}}
{"email_addresses": {"$contains": "@example.com"}}
{"created_at": {"$gte": "2025-01-01T00:00:00.000Z"}}

---

3. Datensätze nach ID oder Attributen finden

Suchen Sie einen bestimmten Datensatz anhand seiner eindeutigen ID oder suchen Sie nach eindeutigen Attributwerten.

Tool: ATTIO_FIND_RECORD

Beispiel-Prompt:

„Finde das Attio-Unternehmen mit der Domain example.com"

Wichtige Parameter:

• object_id (erforderlich) – Objekttyp-Slug: „people", „companies", „deals", „users", „workspaces"
• record_id – Direkte Suche nach UUID (optional)
• attributes – Wörterbuch mit Attributfiltern (z. B. {"email_addresses": "[email protected]"})
• limit – Maximale Anzahl Datensätze (bis zu 1000)
• offset – Paginierungs-Offset

---

4. Notizen durchsuchen und filtern

Listen Sie Notizen im gesamten Workspace auf oder filtern Sie nach bestimmten übergeordneten Objekten und Datensätzen.

Tool: ATTIO_LIST_NOTES

Beispiel-Prompt:

„Zeige die letzten 10 Notizen zum Datensatz der Acme Corp in Attio"

Wichtige Parameter:

• parent_object – Objekt-Slug (z. B. „people", „companies", „deals") – erfordert parent_record_id
• parent_record_id – UUID des übergeordneten Datensatzes – erfordert parent_object
• limit – Maximale Anzahl zurückzugebender Notizen (1-50, Standard 10)
• offset – Anzahl der zu überspringenden Ergebnisse

---

5. Objektschemas und Attribute entdecken

Verstehen Sie die Struktur Ihres Workspace, indem Sie Objekte und deren Attributdefinitionen auflisten.

Tools: ATTIO_GET_OBJECT, ATTIO_LIST_ATTRIBUTES

Beispiel-Prompt:

„Welche Attribute hat das Objekt „companies" in Attio?"

Wichtige Parameter für Get Object:

• object_id – Objekt-Slug oder UUID

Wichtige Parameter für List Attributes:

• target – „objects" oder „lists"
• identifier – Objekt- oder Listen-ID/Slug

---

6. Alle Datensätze auflisten

Rufen Sie Datensätze eines bestimmten Objekttyps mit einfacher Paginierung ab, zurückgegeben in der Reihenfolge der Erstellung.

Tool: ATTIO_LIST_RECORDS

Beispiel-Prompt:

„Liste die ersten 100 Personendatensätze in Attio auf"

Wichtige Parameter:

• Objekttyp-Kennung
• Paginierungsparameter

---

Bekannte Fallstricke

• Das Zeitstempelformat ist kritisch: ALLE Zeitstempelvergleiche (created_at, updated_at, benutzerdefinierte Zeitstempel) MÜSSEN im ISO8601-String-Format erfolgen (z. B. 2025-01-01T00:00:00.000Z). Unix-Zeitstempel oder numerische Werte verursachen Fehler vom Typ „Invalid timestamp value".
• Namensattribute müssen verschachtelt sein: Das name-Attribut hat Untereigenschaften (first_name, last_name, full_name), die UNTER name verschachtelt werden MÜSSEN. Richtig: {"name": {"first_name": {"$contains": "John"}}}. Falsch: {"first_name": {...}} – dies schlägt fehl mit dem Fehler "unknown_filter_attribute_slug".
• E-Mail-Operatoren sind eingeschränkt: email_addresses unterstützt $eq, $contains, $starts_with, $ends_with, aber NICHT $not_empty.
• Datensatzreferenz-Attribute benötigen Pfadfilterung: Für Attribute, die auf andere Datensätze verweisen (z. B. „team", „company"), verwenden Sie eine pfadbasierte Filterung, nicht die verschachtelte Syntax. Beispiel: {"path": [["companies", "team"], ["people", "name"]], "constraints": {"first_name": {"$eq": "John"}}}.
• "lists" ist kein Objekttyp: Verwenden Sie „lists" nicht als object_id. Verwenden Sie listen-spezifische Aktionen für Listenoperationen.
• Suche ist letztlich konsistent: ATTIO_SEARCH_RECORDS gibt letztlich konsistente Ergebnisse zurück. Verwenden Sie für garantierte aktuelle Ergebnisse stattdessen ATTIO_QUERY_RECORDS.
• Attribut-Slugs variieren je nach Workspace: Systemattribute (z. B. „email_addresses", „name") sind konsistent, aber benutzerdefinierte Attribute variieren. Verwenden Sie ATTIO_LIST_ATTRIBUTES, um gültige Slugs für Ihren Workspace zu ermitteln.

---

Kurzreferenz

Aktion	Tool-Slug	Erforderliche Parameter
Fuzzy-Suche nach Datensätzen	ATTIO_SEARCH_RECORDS	query, objects, request_as
Abfrage mit Filtern	ATTIO_QUERY_RECORDS	object
Datensatz nach ID/Attributen finden	ATTIO_FIND_RECORD	object_id
Notizen auflisten	ATTIO_LIST_NOTES	Keine (optionale Filter)
Objektschema abrufen	ATTIO_GET_OBJECT	object_id
Attribute auflisten	ATTIO_LIST_ATTRIBUTES	target, identifier
Datensätze auflisten	ATTIO_LIST_RECORDS	Objekttyp

---

Bereitgestellt von Composio