get_object
Retrieve stored data from cloud storage using its object ID. Access previously saved information across sessions or workflows for continued processing.
Instructions
Retrieve data from cloud storage using its ID. Use this to read data that another agent (or yourself) saved previously.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_id | Yes | The object ID (8-character identifier from the URL) |
Implementation Reference
- index.js:252-273 (handler)Tool handler for 'get_object', which retrieves data via the 'getWorkspace' function.
if (name === 'get_object' || name === 'get_shared_workspace') { const { object_id, workspace_id } = args; const id = object_id || workspace_id; if (!id) { throw new Error('object_id is required'); } const data = await getWorkspace(id); return { content: [ { type: 'text', text: JSON.stringify({ success: true, data: data }, null, 2) } ] }; } - index.js:199-212 (schema)Schema definition for the 'get_object' tool in the ListTools response.
{ name: 'get_object', description: 'Retrieve data from cloud storage using its ID. Use this to read data that another agent (or yourself) saved previously.', inputSchema: { type: 'object', properties: { object_id: { type: 'string', description: 'The object ID (8-character identifier from the URL)' } }, required: ['object_id'] } } - index.js:116-145 (helper)The helper function 'getWorkspace' that performs the API call to retrieve the object data.
/** * Retrieve workspace data */ async function getWorkspace(workspace_id) { try { const response = await axios.get(`${API_BASE_URL}/w/${workspace_id}`, { timeout: 5000 }); // Log successful retrieval logEvent('workspace_retrieved', { tool_name: 'get_shared_workspace', workspace_id }); return response.data; } catch (error) { // Log error logEvent('workspace_retrieval_failed', { tool_name: 'get_shared_workspace', workspace_id, error: error.message }); if (error.response?.status === 404) { throw new Error('Workspace not found or expired'); } throw new Error(`Failed to retrieve workspace: ${error.message}`); } }