- name
- events
- description
- Event API helper for create/get/list/update operations against the AI Agents events API. Requires DATALAYER_API_KEY.
- license
- Proprietary. LICENSE.txt has complete terms
- version
- 1.0.0
- tags
- ["events","orchestration","scheduling"]
- author
- Datalayer
# Events Skill
## Required Environment Variables
- `DATALAYER_API_KEY` (required)
- `DATALAYER_AI_AGENTS_URL` (optional, default `https://prod1.datalayer.run`)
## Invocation Contract
- Call `run_skill_script` with:
- `skill_name`: `events`
- `script_name`: `event`
- This script uses subcommands, so put the subcommand in `args[0]`.
- Use `args` for required positional items (for example, `event_id`).
- Use `kwargs` for optional and named flags.
## Script API
### `script_name: event`
Subcommands and parameters:
1. `create`
- `args`: `["create"]`
- required `kwargs`: `agent_id`, `title`
- optional `kwargs`: `kind`, `status`, `payload`, `metadata`
- `payload` and `metadata` must be JSON object strings.
2. `get`
- `args`: `["get", "<event_id>"]`
- `kwargs`: none
3. `list`
- `args`: `["list"]`
- optional `kwargs`: `agent_id`, `kind`, `status`, `limit`, `offset`
4. `update`
- `args`: `["update", "<event_id>"]`
- optional `kwargs`: `title`, `kind`, `status`, `payload`, `metadata`
- `payload` and `metadata` must be JSON object strings.
## `run_skill_script` Examples
- Create:
```json
{
"skill_name": "events",
"script_name": "event",
"args": ["create"],
"kwargs": {
"agent_id": "data-acquisition",
"title": "New dataset",
"kind": "dataset_ingested",
"payload": "{\"dataset\":\"imerg\"}"
}
}
```
- Update:
```json
{
"skill_name": "events",
"script_name": "event",
"args": ["update", "evt_123"],
"kwargs": {
"status": "completed"
}
}
```
## Direct CLI Examples
```bash
python agent_skills/skills/events/scripts/event.py create --agent-id data-acquisition --title "New dataset" --kind dataset_ingested --payload '{"dataset":"imerg"}'
python agent_skills/skills/events/scripts/event.py get evt_123
python agent_skills/skills/events/scripts/event.py list --agent-id data-acquisition --status pending --limit 20
python agent_skills/skills/events/scripts/event.py update evt_123 --status completed
```
عرض على GitHub